Quickstart: How GraphScreen Works

Master the core workflow in 3 minutes.

1. The Geometry of Extraction

Every chart is fundamentally a mapping of logical values (e.g., Weight in kg, Time in years) to a 2D pixel grid. To reverse this process, we must define the relationship between the screen pixels and the logical numbers. We do this through Calibration.

2. Step-by-Step Guide

Step A: Upload and Align

Load your image into the Digitizer. You will be prompted to pick 4 points:

• X1: A known point on the left side of the X-axis (e.g., 0)
• X2: A known point on the right side of the X-axis (e.g., 100)
• Y1: A known point on the bottom of the Y-axis (e.g., 0)
• Y2: A known point on the top of the Y-axis (e.g., 50)

Tip: Pick points as far apart as possible to minimize angular error.

Step B: Input Values

After clicking the physical locations, a modal will ask you for the logical values of those points. If X1 was the origin, you enter `0`. If X2 was the end of the chart marked `2024`, enter `2024`.

Step C: Click to Extract

With calibration set, every click on the image canvas now translates to real data. Click along the line or scatter plot points. The data will populate in the sidebar table.

Step D: Export

Click "Export CSV" to copy the data. You can paste this directly into Excel or a Python script.