Manual Digitizing: Adding, Selecting, Moving and Deleting Points

This guide shows how to turn clicks on the image into calibrated numerical points with Curve Digitalizer, select a curve, correct coordinates with Move and delete individual points with Delete. The example uses a Session with a synthetic graph and makes it possible to tell the image pixels apart from the stored scientific points.

1. Source Image and Scientific Data Are Two Different Objects

The example uses a synthetic 1280 × 900 pixel PNG with five colored traces. To illustrate the manual operations, only the blue line and the green line are digitized.

Synthetic graph with five colored traces and a legend, before any point is digitized.
Figure 1. The image Dataset already contains the original raster traces, but at the start it contains no digitized points.

The five lines and the legend belong to the raster pixels. At the start, none of them is a scientific Series object: to create the numerical curves you need to use the Curves tab. The source is registered as a canonical Image Dataset with the image.raster contract; it is not a laboratory experiment.

2. Axes and Calibration Are Needed Before Adding Points

The configuration uses Elapsed time on the X axis from 0 to 10 s and Detector response on the Y axis from −20 to 80 mV, both with a linear scale. The Set BL, Set BR, Set TL and Set TR buttons were used to acquire the four real corners of the graph.

Graph with four cyan calibration markers and Calibration ready.
Figure 2. The shared calibration turns pixel coordinates into the physical values of X in seconds and Y in millivolts.

Once complete, the calibration was classified accepted with the Accept control of Calibration measurements. The two curves to be digitized share the same perspective transformation; no separate axes or homographies were invented.

3. The Point interaction Group of the Curves Tab

In the Curves tab, below the list of series, there is Point interaction, which offers six modes: Add, Move, Delete, Add guide, Edit proposal and Add correction point.

Curves tab with the Point interaction group and its six modes.
Figure 3. The Point interaction section is available even when no numerical curves have been created yet.
Detail of the Point interaction modes Add, Move, Delete, Add guide, Edit proposal and Add correction point.
Figure 4. The point editing modes are distinct from the commands for guides and assisted tracing proposals.

Manual digitization uses Add, Move and Delete. Add guide, Edit proposal and Add correction point concern assisted tracing, described separately.

4. Creating Two Curves with New curve

From the Curves tab, the objects Blue manual curve and Green manual curve were created with New curve, leaving This configuration is a numerical curve family disabled.

New curve dialog creating Blue manual curve.
Figure 5. The Curve label, family parameter and unit fields are separate from the original raster image.

The table showed two rows with Points = 0, even though the two lines were already present in the PNG.

Curves table with Blue manual curve and Green manual curve, both with 0 points.
Figure 6. Creating the Series objects does not automatically sample any point of the graph.

Each curve has a stable identifier distinct from the displayed label. The two series were created separately and with zero numerical records, not as a parameterized family.

5. Add Without an Active Curve: Correct Refusal

The Add mode was selected and the image clicked before a curve was created or selected. The Viewer showed the message:

Create or select an active curve first.

Message asking to create or select an active curve first.
Figure 7. The Add mode does not insert points until an active scientific curve has been selected.

No point, new curve or Dataset was created. Add cannot guess which series a click should belong to.

6. Selecting the Blue Curve and Disabling Snap to dark

With Blue manual curve selected, the Add mode was set and Snap to dark kept disabled.

Curves table with Blue manual curve selected, Add mode on and Snap to dark off.
Figure 8. The selected curve determines which series the new points inserted on the image will be associated with.

With snapping off, Manual click and Stored pixel are identical to each other in the record for every insertion.

Active snapping and its options are covered in a later chapter.

7. First Point: Chosen Pixel and Calibrated Coordinates

The first click on the blue trace created a manual point with an overlay on the graph.

First manual point placed on the blue trace.
Figure 9. The first scientific point of the blue curve is inserted with a click on the canvas.

The frame below the interaction modes showed:

Point detail panel with manual click, stored pixel and calibrated X and Y values.
Figure 10. The interface distinguishes the source pixel coordinates from the corresponding calibrated physical values.
FieldInterface result
Manual click X/Y263.367 / 618.518 px
Stored pixel X/Y263.367 / 618.518 px
Scientific X1.000 s
Scientific Y1.630094 mV

The record also contains its own ID, the manual origin and the coordinates in pixels and scientific units. The physical value comes from the four calibrated corners, not directly from the color of the PNG.

8. Five Actual Points on the First Curve

Four more points were added along the blue trace, at increasing X. The table showed Blue manual curve — Points 5; the points are stored in the Workspace managed by the CORE, so they do not exist only in the interface.

Five manual points placed along the blue trace.
Figure 11. The blue raster line and the five recorded scientific points are different objects.
Curves table showing Blue manual curve with 5 points.
Figure 12. The five points of the blue curve keep distinct identifiers and calibrated coordinates within the same series.

The five points have distinct UUIDs, a stored source position and calibrated X/Y values. They are not automatic proposals and not rows of an already published Dataset.

9. Show point numbers Changes Only the Presentation

Enabling Show point numbers, the Viewer drew the labels 1–5 next to the points of the curve.

Blue curve points labeled 1 to 5 with Show point numbers enabled.
Figure 13. The visible numbering is a graphic element, distinct from the permanent UUID identifiers of the points.

Enabling it did not alter the five scientific records. The visual number must not be treated as a persistent ID: the displayed sequence can change with the ordering criterion and after points are removed or re-inserted.

10. Selecting the Green Curve Without Losing the Blue One

With a click on the Green manual curve row, the five blue points already acquired stayed in place.

Green manual curve selected with the five blue points still visible.
Figure 14. Changing the active curve does not move, delete or copy the points of the previously selected curve.

The active row identifies the series that will receive the next Add clicks and in which points will be looked for when selecting and editing. Changing the active series does not transfer points from one curve to another.

11. Adding Five Points to the Green Curve

Five real clicks created as many points on the green trace, for a total of ten points, five blue and five green.

Five blue points and five green points on their respective traces.
Figure 15. The two curves contain five blue points and five green points, each with an identifier and physical coordinates.

The IDs are all different and the framework keeps the manual coordinates, the stored pixels and the calibrated values.

12. Move Selects the Point in the Active Curve

After choosing Move, the third green point was clicked directly on the canvas. The selected marker appeared larger.

Third green point selected in Move mode, drawn with a larger marker.
Figure 16. A click on an existing point selects it without changing its stored coordinates.

The GUI showed its data in the detail section:

Point detail panel for the selected green point.
Figure 17. The selected point keeps a stable identifier and a physical position derived from the calibration.

Selection alone does not change the coordinates.

13. Real Dragging and X/Y Recalculation

The selected green point was dragged with real Tk press, motion and release events on the ImageCanvas.

Green point dragged away from its trace in Move mode.
Figure 18. Dragging moves a single green point; the other nine points stay unchanged.

The point frame reported the new coordinates:

Point detail panel with the updated pixel and physical coordinates after the drag.
Figure 19. When the source pixel changes, the Viewer recalculates the physical coordinates without assigning a new identifier.
PropertyBeforeAfter
Pixel X624.345640.921
Pixel Y465.655452.763
Scientific X5.000 s5.184 s
Scientific Y27.649 mV29.843 mV

Dragging modifies the point, it does not create a new one.

14. A Second Move to Correct the Position

With a second drag the same point was brought back close to the original green trace.

Green point moved back close to the original trace.
Figure 20. The same point keeps its ID even after a second position correction.

15. Clicking an Empty Area Clears the Selection

A click in an area of the raster with no points removes the highlight of the selected point in Move mode.

Graph in Move mode with no point selected.
Figure 21. A click in an empty area clears the selection without changing or deleting data.

16. Only Points of the Active Curve Can Be Selected

With the green curve still active, clicking the marker of a blue point did not select it. After selecting the blue curve in the table, the same point became selectable with Move.

Blue point selected in Move mode after activating the blue curve.
Figure 22. The search for the point to select concerns only the active curve, not the other series.

Point selection is limited to the active curve. Before moving or deleting a point close to several lines, check which Series is selected. The figure shows the selection available for a point of the active curve.

17. Delete as a Direct-Click Mode

The Delete mode of the Point interaction group works on scientific points, not on whole curves. A click in an empty area removed nothing.

Graph in Delete mode after a click on an empty area, with all points intact.
Figure 23. In Delete mode, a click in an empty area of the raster does not delete anything.

Clicking a point of the green curve instead, the count went from 5 to 4 and the corresponding UUID disappeared.

Curves table with the green curve down to 4 points.
Figure 24. The direct click with Delete reduces the green points from five to four, leaving the blue ones unchanged.

All five blue points stayed unchanged. The Delete button below the Curves table has a different meaning: it concerns the whole selected curve.

18. Deleting from the Keyboard with Delete

To show the second path, the Move mode was chosen, another green point was selected and then the Delete key was pressed.

The green count went from 4 to 3, without changing the blue curve.

Curves table with the green curve down to 3 points.
Figure 26. The number of green points drops to three without deleting the curve or the other points.

The selection was cleared after the deletion. Pressing the key did not delete the whole series.

19. Edit → Delete selected point in the Menu

A blue point was selected and the Edit → Delete selected point command of the native menu was used.

Edit menu with Delete selected point highlighted.
Figure 27. The Edit → Delete selected point command deletes only the selected blue point, not the whole curve.

The selected point was deleted and the blue count went temporarily from five to four. The three green points stayed identical. Do not confuse Delete selected point with Delete selected curve….

20. Re-inserting the Same Pixel Generates a New ID

The blue point just deleted was added again with Add, clicking the same position on the canvas.

Blue point re-added at the same position with Add.
Figure 28. The point re-inserted at the same position has the previous coordinates, but a new UUID.

The new record has the same coordinates as the previous one but a different UUID: the old, deleted identifier is not recycled. Editing with Move keeps the identity; deletion followed by insertion creates a new scientific object.

21. Numbering and Insertion Order

In the observed case, insertion order was in use. The point recreated near X=3 s became the fifth point of the curve, not the second.

Blue curve point numbers showing the re-inserted point as number 5.
Figure 29. With insertion order, the new point appears at the end of the curve sequence.

The displayed number follows the order of the points in the curve, but it is not an immutable key. Ordering modes, monotonicity constraints and Undo/Redo are covered in the dedicated section of the guide.

22. Hiding a Populated Curve Does Not Delete the Pixels

With five blue points still present, Show/Hide was used on the blue curve.

Graph with the blue curve markers hidden and the blue raster line still visible.
Figure 30. Show/Hide hides the curve markers, but does not delete the blue trace in the original image.

The blue numbered markers disappeared, but the blue line drawn in the PNG stayed visible. The CORE confirms that the same five blue points and three green points were still present: only the visibility field changed.

23. Restoring the Markers Without Regenerating the Points

With a second Show/Hide, the blue curve became visible again.

Graph with the blue curve markers visible again.
Figure 31. Making the curve visible again restores the markers without recreating or duplicating the records.

The number of points, the physical coordinates, the IDs and the SHA-256 of the source image stayed identical. No new acquisition and no copy of scientific data took place.

24. Hiding Only the Numbers

Turning off Show point numbers, only the numeric labels disappeared, not the markers.

Graph with point markers visible but no numeric labels.
Figure 32. Show point numbers controls only the numeric labels and changes neither the raster nor the points.

The numbering was then re-enabled and saved. Show/Hide changes the visibility of the curve; Show point numbers changes the presentation text associated with the points.

25. Scientific Points Cannot Be Added from the Calibration Tab

With Add active, the Calibration tab was selected and the image clicked.

Calibration tab active after a click on the image, with no new point added.
Figure 33. Inserting points with Add is limited to the Curves tab, avoiding accidental additions during calibration.

The Viewer added no points: the check on the scientific data still returned five blue points and three green points. The manual digitization modes belong exclusively to the Curves tab.

26. Saving, Closing and Reopening the Same Session

The configuration was saved with Configuration → Save configuration, closed normally and reopened with Viewers → Digitalizer in the same synthetic Session.

Reopened Viewer with five blue and three green manual points.
Figure 34. After saving and reopening, the Workspace keeps the five blue points and the three green points with their identifiers.

The Workspace kept all eight final UUIDs, the manual and scientific coordinates, the two curves, the accepted calibration and the SHA-256 identity of the source. The temporary point selection was not kept as scientific data. The Show point numbers presentation option stayed enabled.

27. Essential Operating Procedure

To repeat the operation: choose the source, set four valid corners, create and select a curve, click Add on the real points; use Move to select and drag, or Delete for a direct click. The Delete key and Edit → Delete selected point, instead, act on the previously selected point. Save and check that the configuration reopens correctly.