開発者向けドキュメント
API＆数学的リファレンス
技術仕様、座標系変換式、プログラム統合ガイド。
POST
https://api.aigraphreader.com/v1/digitize画像またはSVG URLをプログラム経由で送信し、校正済みデータベクトルを抽出。
リクエスト例 (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"レスポンス JSON スキーマ
{
"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
}
}
]
}
}座標マッピングの数学的理論
1. 線形デカルト変換
バウンディングボックス [x_0, y_0, x_1, y_1] 内の校正ピクセル座標 (p_x, p_y) に対して：
X = X_min + ((p_x - x_0) / (x_1 - x_0)) * (X_max - X_min)2. 対数軸マッピング
複数の桁にまたがる log10 スケール軸に対して：
Y = 10^( log10(Y_min) + ((p_y - y_0) / (y_1 - y_0)) * (log10(Y_max) - log10(Y_min)) )3. 三元重心座標系 (Ternary)
頂点 V_A, V_B, V_C (A + B + C = 100%) を持つ3成分系に対して：
(A, B, C) = solve_barycentric(p_x, p_y, V_A, V_B, V_C)