Correcting, Accepting and Resampling a Proposal

Assisted tracing is useful only if the operator can check the proposal, correct its unsatisfactory parts and decide which vertices to turn into scientific data. In the GX-TXT Curve Digitalizer these three phases are distinct: guides and cyan segments are provisional; accepted segments enter the numerical series; publishing a Dataset is a further, separate operation.

1. Purpose of the Procedure

The procedure describes Edit proposal, Add correction point, the Undo/Redo history, Accept segment, Accept, Output points (Accept), Resample accepted, Reject and Clear guides. The context menus of proposed points and of points already acquired are also compared.

The example uses a synthetic image with a blue curve and a competing pink trace, plus a target series containing one manual point to be kept.

Viewer with the synthetic graph, the calibration markers and one manual point on the blue curve.
Figure 1. The series is already calibrated and contains a single manual point; the later assisted acquisition must keep it.
Curves table with the target series selected and 1 point.
Figure 2. The scientific table distinguishes the selected series from the future provisional guides.

2. Source, Calibration and Scientific Ordering

The original image is 1280 × 900 pixels. A four-corner calibration is performed, with X from 0 to 10 s and Y from −20 to 80 mV. In Configuration → Viewer settings → Digitizing, the Monotonic in X policy automatically sets Sort by X: after insertions, corrections and acceptances, the points of the series are sorted by increasing scientific X.

Viewer settings Digitizing tab with Monotonic in X and Sort by X.
Figure 3. The X policy sorts the points by the calibrated scientific abscissa, not by the sequence of clicks.

Ordering does not move the points on the image; it only determines the sequence of the records in the curve.

3. Placing the References and Creating a Proposal

In the Curves tab, choose the target series, select Add guide and place five orange guides on the blue line.

Five orange guides along the blue curve.
Figure 4. The five guides define four search intervals without creating new scientific points.

Set Corridor (px) = 24, Step (px) = 8 and Smooth curve prior = Off; use the original raster and press Propose. The program generates 105 provisional points over four segments.

Cyan proposal with the summary reporting 105 points in 4 segments.
Figure 5. With Step eight and Corridor twenty-four, 105 points over four segments are proposed.
Assisted tracing panel with Output points (Accept) and Segment # fields.
Figure 6. The acceptance controls set the final density and the selected interval.

The cyan polyline represents the candidate to be evaluated, not a published numerical series. Generating the proposal does not cancel the manual point already in the series.

4. When to Use Edit Proposal

Under Point interaction, choose Edit proposal to work on a guide or on a generated vertex. The normal gesture is to press the left button near the point and drag it to the new position.

Point interaction with Edit proposal selected.
Figure 7. This mode is used to move a guide or correct a provisional vertex near the cursor.

The correction is local: there is no need to automatically recompute every interval if the operator changes only an intermediate guide.

5. The Selection Tolerance: Six Original Pixels

Selecting with Edit proposal requires pressing within 6 pixels of the original image of a guide or of a provisional vertex. A click far away produces no change.

Message suggesting Add correction point for a click too far from the proposal.
Figure 8. Edit proposal requires a point within six original pixels; for distant corrections there is Add correction point.
Proposal unchanged after a click far from any vertex.
Figure 9. A click far from the proposal changes neither the series nor the provisional vertices.

The message suggests using Add correction point when a distant point has to be indicated. The distance refers to source pixels, not to pixels magnified by the window.

6. Moving an Intermediate Guide

Press near G3 and drag it to a new position on the image. The Viewer recomputes the two intervals bordering G3, leaving the first and last segments unchanged.

Guide G3 dragged to a new position with the neighboring segments recomputed.
Figure 10. The Viewer recomputes only the two intervals adjacent to the guide, leaving the other segments unchanged.
Close-up of the recomputed path around the moved guide.
Figure 11. The new guide changes the path locally, without becoming an accepted numerical point.

The result must be checked against the original curve. Moving a guide is not the same as automatically accepting the recomputed points.

7. Undo and Redo of the Move

After a change, Edit → Undo returns the previous proposal. Edit → Redo restores the move. A further Undo goes back to the initial candidate.

Proposal restored to its initial geometry after Undo.
Figure 12. Undo recovers exactly the geometry before the guide was moved.

In this example the first and fourth segments stayed geometrically unchanged while the central guide was dragged; Undo recovered all the initial vertices exactly.

8. Add Correction Point: Correction Regardless of Distance

If the cyan proposal passes far from the true curve, choose Add correction point. The function lets you click directly on the correct position in the image, without having to start from an already generated vertex.

Point interaction with Add correction point selected.
Figure 13. This function lets the operator indicate a new position on the curve even far from the proposal.

With Monotonic in X, the Viewer uses the calibrated scientific abscissa of the click to identify the interval between the guides. The operator does not have to guess manually which portion to move.

9. A Real Correction Splits the Segment

A click on the blue stroke in the second interval inserted a new guide. The point was placed at about 6.75 source pixels from the nearest generated vertex, so beyond the tolerance used by Edit proposal.

Proposal with a correction guide splitting the second interval.
Figure 14. The second interval is split in two; the proposal goes from four to five segments.
Guide labels renumbered after the correction point was inserted.
Figure 15. The following references are renumbered, while the outer intervals stay unchanged.

The GUI reports the insertion in segment 2: the two portions around the new constraint are recomputed. The proposal goes from four to five segments; the first and the last two segments stay unchanged.

10. Undo and Redo of a Correction

The new guide can be recovered and removed through the Edit → Undo / Redo history, before acceptance.

Proposal after Undo and Redo of the correction point.
Figure 16. The Edit history keeps the geometry of the proposal, including the new guides introduced.

The operation is reversible: Undo returns the original polyline, while Redo recreates the split into five intervals with the same geometric coordinates. The existing scientific points are not modified.

11. Deleting a Correction Guide

With Delete under Point interaction, click the correction guide introduced earlier. The number of segments goes back to four.

Proposal back to four segments after deleting the correction guide.
Figure 17. Removing the correction guide recovers the previous four-segment tracing.

Restoring the original geometry was checked by comparing the same proposal vertices. The result stays provisional and does not change the accepted data.

12. Deleting a Generated Vertex

The Delete mode can also be used on an interior vertex of the candidate polyline, instead of on a guide. In this case only the chosen vertex is removed.

Proposal with one generated vertex removed.
Figure 18. A provisional vertex is deleted, without changing the manual scientific point.

Undo recovers it exactly. The distinction matters: deleting a generated vertex changes a proposal not yet accepted; deleting an acquired scientific point is a different operation.

13. The Step Check Before Accept

Before accepting a proposal, the Viewer checks that Step (px) is still the one used to generate it. If Step is changed from 8 to 10 and you try to accept without a new Propose, a refusal message appears.

Message asking to generate the proposal again because Step has changed.
Figure 19. The Viewer asks to generate the proposal again when the current Step does not match the one used.

This avoids attributing an earlier result to the new parameters. Correct Step or generate the proposal again, then review it before Accept.

14. Output Points (Accept): Number of Scientific Points

The Output points (Accept) field is not Step. It sets the number of new scientific points to be created in the acceptance operation in progress.

The value 0 keeps the native density of the proposal; a valid positive value ranges from 2 to 10000. Entering 1, the Viewer rejects the request.

Message rejecting Output points equal to 1.
Figure 20. Output points accepts zero for the native density or an integer from two to ten thousand.

Asking for more points does not mean recovering new experimental information: the Viewer resamples the candidate geometry already examined.

15. Accepting a Single Interval

Set Segment # = 2 and Output points = 20, then press Accept segment. Segment # is numbered starting from one; it selects one of the visible intervals of the proposal.

The Viewer presents an explicit confirmation.

Confirmation dialog for Accept segment.
Figure 21. The Viewer asks for explicit consent before turning provisional points into scientific ones.

In the first case the operator chooses No. No assisted point is added.

Curves table still showing 1 point after choosing No.
Figure 22. Declining the confirmation adds no assisted point to the series.

16. Confirming the Acceptance with Yes

Repeating Accept segment and choosing Yes, 20 scientific points with assisted origin are inserted, while the original manual point stays in the series.

Confirmation dialog for accepting segment 2 with 20 points.
Figure 23. The request specifies the segment and the number of new points, without deleting the manual ones.
Curves table with 21 points after accepting segment 2.
Figure 24. Acceptance turns the proposal vertices into scientific points only after confirmation.

The confirmation states the number of segments and points to be acquired. A request of N with Accept segment concerns the new points for that single interval, not a share of N divided among all the segments of the proposal.

17. Interpreting the Segment Colors

After the second interval has been accepted, the GUI shows one green segment and three cyan segments.

Proposal with one green accepted segment and three cyan segments.
Figure 25. The display distinguishes the acquired material from the parts still to be checked.
Close-up of the green accepted segment next to a cyan one.
Figure 26. The color difference signals the different scientific state of the segments.

Green identifies a part already turned into numerical points; cyan identifies the proposal still awaiting approval. This difference is one of scientific state, not an indicator of accuracy or uncertainty.

18. Protection of Intervals Already Accepted

In Edit proposal, a guide adjacent to an already accepted segment cannot be moved as if the points were still provisional.

Message refusing to move a guide adjacent to an accepted segment.
Figure 27. The provisional edit cannot accidentally overwrite points already acquired.

Add correction point also rejects a new constraint falling inside an already accepted interval.

Message refusing a correction point inside an accepted interval.
Figure 28. The Viewer rejects the correction and points to working on the segments still provisional.

To change acquired points you need to use the appropriate scientific tools, such as Move on the points of the series or Undo, without silently rewriting the portions already confirmed.

19. Changing Output Points During a Partial Acceptance

After the second segment has been accepted with 20 points, Output points is changed to 30 and an attempt is made to acquire another interval. The Viewer rejects the request: Resample accepted must be used first.

Message asking to use Resample accepted before changing Output points.
Figure 29. To change the density of a partially accepted proposal, Resample accepted must be used first.
Output points set to 30 with the refusal message.
Figure 30. The program avoids silently mixing incompatible densities in the same proposal.

This check prevents mixing incompatible densities in the same proposal without an explicit resampling operation.

20. Resample Accepted and the No Confirmation

Press Resample accepted with the new value N=30. The program asks for confirmation before replacing the assisted points of the already accepted part.

Confirmation dialog for Resample accepted.
Figure 31. The Viewer asks for confirmation because it replaces the assisted points of the already accepted part.

Choosing No, exactly the previous 20 assisted points and the manual point remain.

Curves table still showing 21 points after choosing No.
Figure 32. The number and identifiers of the twenty assisted points stay unchanged.

The command is not the same as creating or publishing a new Dataset: it changes the composition of the numerical records in the selected scientific document.

21. Resample Accepted with Yes

Repeat the command and choose Yes.

Confirmation dialog for resampling to 30 points.
Figure 33. The replacement concerns only the assisted points derived from the current proposal.
Detail of the Resample accepted confirmation message.
Figure 34. The window states that resampling must not overwrite the other points of the series.

The second segment is represented with 30 assisted points, plus the single manual point that was kept.

Curves table with 31 points after resampling.
Figure 35. The series contains thirty assisted points and the original manual point.

Resampling replaces the assisted records belonging to the current proposal. The other points of the series are not replaced. Undo restores the old 20 records and Redo recovers the same 30 records, with the correct identifiers.

22. An Accepted Segment Is Not Acquired Twice

If Segment # 2 is selected again and Accept segment is pressed, the Viewer reports that it has already been accepted.

Message stating that segment 2 has already been accepted.
Figure 36. An interval already acquired is not duplicated by using Accept segment a second time.

This is a safeguard against automatically duplicating points that belong to the same portion of the proposal.

23. Accepting a Second Segment

Select Segment # = 3, with Output points still set to 30, and press Accept segment. After confirmation, the series acquires another 30 assisted points.

Confirmation dialog for accepting segment 3 with 30 points.
Figure 37. The third interval adds another thirty assisted points through the native confirmation.
Proposal with segments 2 and 3 green and segments 1 and 4 cyan.
Figure 38. Incremental acceptance makes it possible to check regions of the curve separately.

Now segments 2 and 3 are green, while 1 and 4 stay cyan. The curve contains 60 assisted points plus the manual point in total, i.e. 61 records.

24. Accept Completes Only the Remaining Portions

Pressing Accept after two partial acceptances, the Viewer selects only the segments not yet accepted. In our example these are the first and the fourth.

Confirmation dialog for accepting the remaining segments.
Figure 39. Accept adds points only for the segments that had not yet been accepted.
Curves table with 91 points.
Figure 40. The series contains ninety assisted points, plus the pre-existing manual point.

After confirmation, all four segments turn green: another 30 assisted points were added, spread over the remaining parts. The series contains 90 assisted points and one manual point, i.e. 91 records.

Proposal with all four segments green.
Figure 41. Green identifies the accepted segments while the proposal is still available for resampling.

25. Exact Count and Shared Guides

Contiguous segments share guides. When adjacent portions are acquired, the Viewer must not automatically add two copies of the same junction point.

With the Sort by X policy, ordering is applied to the calibrated scientific coordinates. A shared guide remains a constraint of the geometry, while the numerical points are identified individually.

In the final result there are no consecutive duplicates of the assisted points at the junctions and the UUID identifiers are unique.

26. Resampling the Fully Accepted Part

After full acceptance, set Output points = 100 and choose Resample accepted. The confirmation window states that the assisted points belonging to the proposal will be replaced, without altering the other records.

Confirmation dialog for resampling the accepted proposal to 100 points.
Figure 42. The requested number concerns the assisted points of the current proposal, not the manual points already present.

After Yes, the curve count is 101: one hundred assisted points and the initial manual point.

Curves table with 101 points.
Figure 43. The series count is 101: one hundred assisted and one manual point.

The value 100 is the total of the assisted points of the resampled proposal, not the total of the records in the series.

27. Undo/Redo on the Resampled Scientific Points

Edit → Undo cancels the final resampling, recovering the previous 90 assisted points. Edit → Redo recreates the same 100 points of the confirmed version.

Curves table after Undo and Redo of the final resampling.
Figure 44. The history makes it possible to go from one hundred to ninety assisted points and then restore exactly the hundred.

The UUIDs and the coordinates of the manual point stay unchanged in both directions. The operation keeps the history of the accepted scientific points separate from the revisions of the provisional vertices.

28. Context Menu of a Scientific Point

A right-click near a numerical point already present opens the menu with Move scientific point and Delete scientific point.

Context menu of an accepted scientific point.
Figure 45. Right-click offers Move scientific point and Delete scientific point, distinct from the proposal commands.
Close-up of the scientific point context menu entries.
Figure 46. The menu actions refer to the real points of the series, not to the cyan vertices of the proposal.

The entries state that the selected object is an acquired scientific datum. It must not be confused with a cyan vertex that has not yet been accepted.

29. Reject After Acceptance

Reject discards any temporary proposal, but does not delete the scientific points already accepted. In the test the 101 records stay present.

Graph after Reject with the 101 accepted points still shown.
Figure 47. The Viewer keeps 101 scientific points even when the provisional lines disappear.

The action can be used to start again from a new candidate, without having to delete or rebuild the data already saved.

30. Clear Guides Does Not Delete the Scientific Points

Press Clear guides to delete the temporary orange guides. The series still consists of 100 assisted points and one manual point.

Graph after Clear guides with no guides and the accepted points intact.
Figure 48. The guides and the proposal are not an alternative archive of the accepted numerical data.

The command concerns the provisional geometry of the assistant, not the scientific numerical table.

31. Save, Close and Reopen the Configuration

Use Configuration → Save configuration, then close the Viewer normally and reopen it in the same Session.

Reopened Viewer with the series of 101 points.
Figure 49. The original Dataset, the calibration and the series with 101 points are recovered.

In the case shown, the original raster Dataset, the four-point calibration, the same numerical series and the 101 points with their identity and coordinates preserved remain. The guides and the proposal are not rebuilt automatically.

32. A New Proposal on an Already Populated Series

After reopening, new guides can be placed and Propose pressed on the same series that already contains data.

New cyan proposal on the already populated series.
Figure 50. Generating a new cyan line does not change the hundred assisted points and the manual point already saved.

The new cyan polyline is an additional proposal, not an automatic replacement of the previous hundred assisted points. The existing data stay unchanged until the operator performs explicit scientific actions.

33. Context Menu of a Point Still Proposed

A right-click near a cyan vertex opens a different menu, with Move point and Delete point.

Context menu of a proposed cyan vertex.
Figure 51. The menu of the proposed point offers Move point and Delete point, without referring to the scientific commands.
Close-up of the proposed point context menu.
Figure 52. Right-click distinguishes the test point from the points already acquired.

The menu distinguishes the objects of the proposal from the points already saved. The interface may also offer functions to restore the provisional revision, according to the existing history.

34. Deleting from the Menu and Recovering with Undo

Choosing Delete point from the context menu of a cyan vertex changes only the candidate segment.

Cyan proposal with one vertex removed through Delete point.
Figure 53. Delete point changes only the cyan polyline under review, leaving the scientific curve intact.

Edit → Undo returns the vertex and the previous proposed geometry.

Cyan proposal restored after Undo.
Figure 54. The Edit history returns the previous candidate path before any acceptance.

During this operation the series with 101 scientific points stayed identical, including coordinates and UUIDs. After Reject and Clear guides, only the acquired points remain.

Graph with the 101 accepted points and no provisional lines.
Figure 55. The scientific series keeps 101 points and the canonical image is not altered by the tests on the proposal.

35. Checking the Scientific Coordinates

The synthetic image contains a known function in original pixels:

y_px(x) = 440 + 58 sin(2π(x−200)/720) + 20 sin(2π(x−200)/305)

The final coordinates of the curve can be checked independently using the saved calibration. Of the 101 records, 100 have origin=assisted and one origin=manual; all have distinct UUIDs and the calibrated X coordinates are sorted in increasing order.

The independent numerical reconstruction of the X/Y values from the geometry of the four corners matched the saved scientific fields within rounding errors. Compared with the synthetic function, the final 100 assisted points show a mean vertical deviation of about 9.01 source pixels and an RMSE of 12.93 pixels. These values are geometric comparisons on a known image, not metrological uncertainties, nor 100 independent experimental observations.

36. Recommended Procedure and Limits

  1. Select an Image Dataset and an appropriate calibration, then choose the target series.
  2. Define the ordering policy and place enough guides in the ambiguous stretches.
  3. Generate Propose and check the whole polyline on the raster, not just the number of points.
  4. Use Edit proposal for changes near a vertex or Add correction point for distant corrections.
  5. Check the resulting geometry with Undo/Redo before acceptance.
  6. Choose Output points (Accept) and, if needed, Segment #; confirm explicitly with Accept segment or Accept.
  7. If a part has already been accepted and you want to change the density, use Resample accepted and check which points will be replaced.
  8. Do not change an accepted segment through the tools reserved for the proposal; use the scientific operations on points or the Undo/Redo history.
  9. Once the review is finished, always distinguish Reject and Clear guides from deleting numerical points.
  10. Save the configuration and check the data after reopening.

Digitizing produces numerical data in the Viewer configuration. Publishing a canonical Dataset in the framework is a later step, not performed automatically when Accept is pressed. The user must keep the reference to the source, the calibration and any limits of the method before using the points in quantitative analyses.