AI Graph Reader
DOCUMENTAZIONE SVILUPPATORI

Riferimento API & Matematico

Specifiche tecniche, formule di conversione coordinate e guide per l'integrazione programmatica.

POSThttps://api.aigraphreader.com/v1/digitize

Invia in modo programmatico un'immagine o un URL SVG per estrarre vettori di dati calibrati.

Esempio di Richiesta (cURL)
curl -X POST https://api.aigraphreader.com/v1/digitize \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "file=@figure_1_experiment.png" \
  -F "graph_type=xy_cartesian" \
  -F "x_range=[0, 100]" \
  -F "y_range=[0, 500]" \
  -F "scale_x=linear" \
  -F "scale_y=log10"
Schema JSON della Risposta
{
  "status": "success",
  "data": {
    "series": [
      {
        "name": "Series 1",
        "points": [
          {"x": 10.2, "y": 142.5},
          {"x": 20.5, "y": 230.1},
          {"x": 30.1, "y": 385.0}
        ],
        "metrics": {
          "mean_x": 20.26,
          "max_y": 385.0,
          "confidence_score": 0.994
        }
      }
    ]
  }
}

Matematica delle Trasformazioni di Coordinate

1. Trasformazione Cartesiana Lineare

Per coordinate pixel calibrate (p_x, p_y) all'interno del rettangolo [x_0, y_0, x_1, y_1]:

X = X_min + ((p_x - x_0) / (x_1 - x_0)) * (X_max - X_min)

2. Mappatura Esecuzioni Logaritmiche

Per assi in scala log10 che coprono più ordini di grandezza:

Y = 10^( log10(Y_min) + ((p_y - y_0) / (y_1 - y_0)) * (log10(Y_max) - log10(Y_min)) )

3. Coordinate Baricentriche Ternarie

Per sistemi a 3 componenti con vertici V_A, V_B, V_C con A + B + C = 100%:

(A, B, C) = solve_barycentric(p_x, p_y, V_A, V_B, V_C)