Analiża l-Grafiċi mal-Vision API
F'din il-paġna
Aqra l-Grafiċi bħal Analista
Il-grafiċi—bi strixxi, linji, torti jew erja—huma kullimkien fir-rapporti tan-negozju, fid-dashboards u fil-pubblikazzjonijiet xjentifiċi. Dawn jippreżentaw problema speċifika: l-informazzjoni hija msakkra ġewwa stampa, spiss mingħajr id-data tas-sors mehmuża magħha. Rapport annwali f’PDF jista’ jkun fih tletin kurva, u ħadd m’għadu għandu l-fajl oriġinali ta’ Excel.
Il-Vision API ta’ Mistral tista’ taqra dawn il-grafiċi, tinterpreta x-xejriet u testratta data numerika. Din il-lezzjoni turi kif tikteb prompts li jipproduċu riżultati operazzjonali minflok kummenti vagi, u kif tistruttura l-output.
Prinċipji tal-Analiżi tal-Grafiċi
Jekk titħalla waħedha, il-mudell jipproduċi sentenza ġenerika bħal “dan il-grafiku juri l-evoluzzjoni tal-bejgħ”. Prompt effettiv jimponi proċess ordnat minflok: identifika t-tip ta’ grafiku (strixxi, linja, torta, scatter), aqra l-assi u l-leġendi bil-unitajiet u l-iskali tagħhom, estratta l-valuri billi tapprossima l-pożizzjoni viżiva, u mbagħad biss interpreta x-xejriet—tiela’, nieżla, staġjonalità, anomaliji. L-ordni hija importanti: interpretazzjoni ffurmata qabel ma taqra l-assi hija interpretazzjoni inventata.
Analiżi ta’ Grafiku bi Strixxi
Il-messaġġ tas-sistema huwa l-post naturali biex tikkodifika dan il-metodu darba għal dejjem, irrispettivament mill-immaġni li qed tiġi analizzata:
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)
Il-prompt tas-sistema jistruttura r-risposta tal-mudell f’passi loġiċi, u jtejjeb kemm il-preċiżjoni kif ukoll il-leġġibbiltà. Tikseb rapport konsistenti minn grafiku għall-ieħor, li huwa essenzjali jekk dawn ir-risposti jeħtieġu jiġu pproċessati awtomatikament aktar tard.
Estrazzjoni ta’ Data Numerika
Biex tikseb data użabbli minflok deskrizzjoni, l-istruzzjoni trid tkun espliċitament restrittiva. Il-mudell għandu tendenza naturali li jikkummenta; trid tipprojbixxieh:
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"}
]
}
]
)
Il-mudell se jirritorna xi ħaġa bħal:
| Month | Sales (k€) |
|----------|------------|
| January | 120 |
| February | 135 |
| March | 148 |
Dan il-format jipparża f’ftit linji ta’ kodiċi u jimporta direttament fi spreadsheet jew DataFrame.
Analiżi ta’ Grafiku b’Linja (Xejriet)
Il-grafiċi b’linja huma partikolarment adattati għall-analiżi tax-xejriet, u l-mistoqsija tista’ mbagħad issir kwestjonarju sħiħ ippreżentat fil-messaġġ tal-utent:
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"}
]
}
]
)
Il-ħames mistoqsija hija ta’ natura differenti mill-ewwel erbgħa: titlob estrapolazzjoni, mhux qari. Itratta t-tweġiba tagħha bħala ipoteżi li trid tiġi vvalidata, qatt mhux bħala fatt.
Analiżi ta’ Grafiku tat-Torta (Distribuzzjoni)
Għall-grafiċi tat-torta, il-mistoqsija tiffoka fuq il-proporzjonijiet u l-konċentrazzjoni aktar milli fuq l-evoluzzjoni:
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"}
]
}
]
)
Dejjem ivverifika li s-somma tal-perċentwali rritornati tkun qrib il-100: total ta’ 87% jindika qari mhux sħiħ, segment minsija, jew wieħed moħbi mil-leġenda.
Pipeline ta’ Analiżi tar-Rapporti
Dawn is-sejħiet iżolati jsiru utli fuq skala ta’ rapport sħiħ. L-iskript li ġej jiskannja folder ta’ grafiċi esportati, jitlob output JSON standardizzat kull darba, u jirreġistra kollox f’fajl wieħed:
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)
L-istruzzjoni “no markdown code blocks” tevita l-fastidju klassiku ta’ JSON imgeżwer f’triple backticks, li jkisser il-parsing.
Limiti tal-Analiżi tal-Grafiċi
Erba’ sitwazzjonijiet jisfidaw il-mudell, u trid tkun taf bihom qabel ma tibni proċess madwaru. L-ewwel, valuri preċiżi: dawn huma stmati mill-pożizzjoni viżiva tal-istrixxi jew tal-punti, b’marġni ta’ żball ta’ 5 sa 10%. It-tieni, grafiċi mimlija żżejjed, fejn serje multipli, leġendi u test żgħir iċajpru l-leġġibbiltà. It-tielet, riżoluzzjoni baxxa, li tagħmel it-tikketti mċajpra jew pixelati u mhux leġġibbli—ftakar fir-ridimensjonament intern deskritt fil-Lezzjoni 2. Fl-aħħar nett, grafiċi 3D, fejn il-prospettiva tiddistorsjoni mekkanikament il-qari tal-għoli.
Il-konklużjoni prattika hija ċara: għal estrazzjoni preċiża, ippreferi tesporta d-data tas-sors bħala CSV meta tkun disponibbli. Il-Vision API hija ideali għal analiżi u sinteżi mgħaġġla, mhux biex tissostitwixxi spreadsheet. Tispikka meta d-data tas-sors tkun intilfet; hija għażja ħażina meta d-data tkun fil-portata tiegħek.
Punti Ewlenin
- Uża Mistral Large 3 għall-analiżi tal-grafiċi—il-preċiżjoni hija kritika
- Istruttura l-prompt tiegħek f’passi: tip, assi, valuri, xejriet, konklużjoni
- Itlob espliċitament format ta’ output (tabella markdown, JSON) għal data użabbli
- Il-mudell jistma l-valuri b’marġni ta’ 5–10%—tużahx għal figuri eżatti
- Għaqqad il-Vision API ma’ esportazzjoni CSV għall-aħjar taż-żewġ dinjiet