Léim go dtí an príomhábhar
Gaeilge— Roghnaigh teanga
Roghchlár

Anailís a dhéanamh ar Chairteacha leis an Vision API

Ceacht 7 as 12 Nuashonraithe 2 Samhain 2026 Forbróir
Ar an leathanach seo
  1. Léigh Cairteacha Mar Anailísí
  2. Prionsabail Anailíse Cairte
  3. Anailís a dhéanamh ar Chairt Bharra
  4. Sonraí Uimhriúla a Eastóscadh
  5. Anailís a dhéanamh ar Chairt Líne (Treochtaí)
  6. Anailís a dhéanamh ar Chairt Phíosa (Dáileadh)
  7. Píblíne Anailíse Tuarascála
  8. Teorainneacha Anailíse Cairte
  9. Príomhphointí

Léigh Cairteacha Mar Anailísí

Tá cairteacha—barr, líne, píosa, limistéar—le fáil i ngach áit i dtuarascálacha gnó, deascanna rialaithe, agus foilseacháin eolaíochta. Cuireann siad fadhb shainiúil i láthair: tá an fhaisnéis faoi ghlas laistigh d’íomhá, go minic gan na bunshonraí ceangailte léi. D’fhéadfadh tuarascáil bhliantúil PDF tríocha cuar a bheith inti, agus ní bhfuil an comhad Excel bunaidh ag duine ar bith a thuilleadh.

Is féidir le Vision API Mistral na cairteacha seo a léamh, treochtaí a léirmhíniú, agus sonraí uimhriúla a eastóscadh. Taispeánann an ceacht seo conas leideanna a scríobh a tháirgeann torthaí inghníomhaithe seachas trácht doiléir, agus conas an t-aschur a struchtúrú.

Prionsabail Anailíse Cairte

Má fhágtar leis féin é, táirgeann an tsamhail abairt ghinearálta cosúil le “léiríonn an chairt seo éabhlóid na ndíolachán”. Cuirfidh leid éifeachtach próiseas ordaithe i bhfeidhm ina ionad sin: aithin cineál na cairte (barr, líne, píosa, scaipthe), léigh na haiseanna agus na finscéalta lena n-aonaid agus a scálaí, eastósca luachanna trí sheasamh amhairc a mheas, agus ansin amháin déan treochtaí a léirmhíniú—ardú, titim, séasúracht, ainrialtachtaí. Tá tábhacht leis an ord: is léirmhíniú cumtha é léirmhíniú a dhéantar sula léitear na haiseanna.

Anailís a dhéanamh ar Chairt Bharra

Is é an teachtaireacht chórais an t-áit nádúrtha chun an modh seo a chódú uair amháin agus go deo, beag beann ar an íomhá atá á hanailísiú:

from mistralai.client import Mistral
import os

client = Mistral(api_key=os.environ["MISTRAL_API_KEY"])

response = client.chat.complete(
    model="mistral-large-latest",
    messages=[
        {
            "role": "system",
            "content": """You are an expert data analyst. When analyzing a chart:
1. Identify the chart type and its title
2. Describe the axes (labels, units, scale)
3. List the main values you can read
4. Identify trends, highs/lows, and anomalies
5. Write a 2-3 sentence conclusion"""
        },
        {
            "role": "user",
            "content": [
                {"type": "text", "text": "Analyze this bar chart of quarterly revenue."},
                {"type": "image_url", "image_url": "https://exemple.com/ca-trimestriel.png"}
            ]
        }
    ]
)

print(response.choices[0].message.content)

Struchtúraíonn an leid córais freagra na samhla i gcéimeanna loighciúla, rud a fheabhsaíonn cruinneas agus inléiteacht araon. Faigheann tú tuarascáil chomhsheasmhach ó chairt go cairt, rud atá riachtanach má tá gá leis na freagraí seo a phróiseáil go huathoibríoch níos déanaí.

Sonraí Uimhriúla a Eastóscadh

Chun sonraí inúsáidte a fháil in ionad cur síos, caithfidh an treoir a bheith go sainráite sriantach. Tá claonadh nádúrtha ag an tsamhail chun trácht a dhéanamh; caithfidh tú cosc a chur air:

response = client.chat.complete(
    model="mistral-large-latest",
    messages=[
        {
            "role": "system",
            "content": "You are a data extractor. Analyze the chart and return the data as a markdown table. Do not comment, do not describe—only extract the data."
        },
        {
            "role": "user",
            "content": [
                {"type": "text", "text": "Extract the data from this bar chart into a table."},
                {"type": "image_url", "image_url": "https://exemple.com/ventes-mensuelles.png"}
            ]
        }
    ]
)

Seolfaidh an tsamhail rud éigin cosúil leis seo ar ais:

| Month    | Sales (k€) |
|----------|------------|
| January  | 120        |
| February | 135        |
| March    | 148        |

Déanann cúpla líne cód an formáid seo a pharsáil agus allmhairíonn sí go díreach i scaoilear nó i DataFrame.

Anailís a dhéanamh ar Chairt Líne (Treochtaí)

Tá cairteacha líne oiriúnach go háirithe d’anailís treochta, agus ansin is féidir leis an gceist a bheith ina ceistneoir iomlán a chuirtear sa teachtaireacht úsáideora:

prompt_tendance = """Analyze this line chart and answer:
1. What is the general trend (rising, falling, stable)?
2. Are there any inflection points? If so, on what dates?
3. Do you observe seasonality?
4. What is the approximate value at the start and end of the period?
5. What projection do you make for the next quarter?"""

response = client.chat.complete(
    model="mistral-large-latest",
    messages=[
        {
            "role": "user",
            "content": [
                {"type": "text", "text": prompt_tendance},
                {"type": "image_url", "image_url": "https://exemple.com/evolution-prix.png"}
            ]
        }
    ]
)

Tá an cúigiú ceist difriúil ó thaobh nádúir de ón gceathrar céadta: iarrann sí eachtarshuíomh, ní léamh. Déileáil lena freagra mar hipitéis le bailíochtú, ní mar fhíric riamh.

Anailís a dhéanamh ar Chairt Phíosa (Dáileadh)

I gcás cairteacha píosa, díreoidh an cheist ar chomhréireanna agus ar thiúchan seachas ar éabhlóid:

prompt_camembert = """Analyze this pie chart:
- List each segment with its approximate percentage
- Identify the dominant segment
- Indicate whether the distribution is concentrated or dispersed
Return the data in a markdown table."""

response = client.chat.complete(
    model="mistral-large-latest",
    messages=[
        {
            "role": "user",
            "content": [
                {"type": "text", "text": prompt_camembert},
                {"type": "image_url", "image_url": "https://exemple.com/repartition-marche.png"}
            ]
        }
    ]
)

Fíoraigh i gcónaí go bhfuil suim na gcéatadáin a thugtar ar ais gar do 100: léiríonn iomlán de 87% léamh neamhiomlán, mír dhearmadta, nó ceann atá i bhfolach ag an bhfinscéal.

Píblíne Anailíse Tuarascála

Éiríonn na glaonna aonair seo úsáideach ar scála tuarascála iomláine. Scanann an script seo a leanas fillteán de chairteacha onnmhairithe, iarrann sé aschur JSON caighdeánaithe gach uair, agus déanann sé logáil ar gach rud i gcomhad amháin:

import base64
from pathlib import Path
from mistralai.client import Mistral
import json

client = Mistral(api_key=os.environ["MISTRAL_API_KEY"])

def encoder_image(chemin):
    with open(chemin, "rb") as f:
        b64 = base64.standard_b64encode(f.read()).decode("utf-8")
    return f"data:image/png;base64,{b64}"

def analyser_graphique(chemin_image, question=None):
    """Analyze a chart and return structured data."""
    if question is None:
        question = "Analyze this chart. Return a JSON with: type (bar/line/pie/other), title, data (array of {label, value}), trend, and summary."

    response = client.chat.complete(
        model="mistral-large-latest",
        messages=[
            {
                "role": "system",
                "content": "Return only valid JSON, no markdown code blocks."
            },
            {
                "role": "user",
                "content": [
                    {"type": "text", "text": question},
                    {"type": "image_url", "image_url": encoder_image(chemin_image)}
                ]
            }
        ]
    )

    return response.choices[0].message.content

# Analyze all charts in a folder
dossier = Path("rapport/graphiques/")
resultats = {}

for fichier in sorted(dossier.glob("*.png")):
    print(f"Analyse de {fichier.name}...")
    resultats[fichier.name] = analyser_graphique(fichier)

# Save results
with open("rapport/analyse_graphiques.json", "w", encoding="utf-8") as f:
    json.dump(resultats, f, ensure_ascii=False, indent=2)

Seachnaíonn an treoir “no markdown code blocks” an fhadhb chlasaiceach a bhaineann le JSON atá fillte i dtrí chomhartha tic, rud a bhriseann parsáil.

Teorainneacha Anailíse Cairte

Tá ceithre chás a chuireann dúshlán roimh an tsamhail, agus caithfidh tú a bheith ar an eolas fúthu sula dtógfaidh tú próiseas timpeall air. Ar an gcéad dul síos, luachanna cruinne: déantar meastachán orthu ó sheasamh amhairc na mbarraí nó na bpointí, le corrlach earráide 5 go 10%. Ar an dara dul síos, cairteacha atá plódaithe, áit a ndéanann sraitheanna iolracha, finscéalta, agus téacs beag inléiteacht a doiléiriú. Ar an tríú dul síos, taifead íseal, rud a fhágann go mbíonn lipéid doiléir nó picteilínithe agus neamh-inléite—cuimhnigh ar an athmhéidú inmheánach a tuairiscíodh i gCeacht 2. Faoi dheireadh, cairteacha 3T, áit a ndéanann an peirspictíocht saobhadh meicniúil ar léamh airde.

Tá an conclúid phraiticiúil soiléir: le haghaidh eastóscadh cruinn, is fearr sonraí foinse a onnmhairiú mar CSV nuair atá siad ar fáil. Tá an Vision API idéalach le haghaidh anailíse agus sintéise tapa, ní chun scaoilear a athsholáthar. Bíonn sé ar a dhícheall nuair a bhíonn na bunshonraí imithe; is rogha lag é nuair atá na sonraí laistigh de do rochtain.

Príomhphointí

  • Úsáid Mistral Large 3 le haghaidh anailíse cairte—tá cruinneas ríthábhachtach
  • Struchtúraigh do leid i gcéimeanna: cineál, aiseanna, luachanna, treochtaí, conclúid
  • Iarr formáid aschuir go sainráite (tábla marcáilte, JSON) le haghaidh sonraí inúsáidte
  • Déanann an tsamhail meastachán ar luachanna le corrlach 5–10%—ná húsáid í le haghaidh figiúirí beachta
  • Comhcheangail an Vision API le honnmhairiú CSV chun an dá shaol is fearr a fháil