DOCUMENTAÇÃO PARA DESENVOLVEDORES

Referência de API e Matemática

Especificações técnicas, fórmulas de sistemas de coordenadas e guias de integração programática.

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

Envie programaticamente uma imagem ou URL SVG para extrair vetores de dados calibrados.

Exemplo de Requisição (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"

Esquema JSON de Resposta

{
  "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
        }
      }
    ]
  }
}

Matemática de Mapeamento de Coordenadas

1. Transformação Cartesiana Linear

Para coordenadas de pixels calibradas (p_x, p_y) no quadro [x_0, y_0, x_1, y_1]:

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

2. Mapeamento de Eixos Logarítmicos

Para eixos em escala log10 abrangendo várias ordens de magnitude:

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

3. Coordenadas Baricêntricas Ternárias

Para sistemas de 3 componentes com vértices V_A, V_B, V_C onde A + B + C = 100%:

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

Abrir Studio Digitalizador Interativo