Scientific Annotations, Notes and Viewer Preferences

Coordinates derived from a graph acquire scientific meaning only when they come with a reliable description of the source, the axes and the traces. In the GX-TXT Curve Digitalizer this information is handled in different places: scientific labels, configuration Notes, Dataset Notes and Viewer settings.

Their scope is not the same. Some preferences belong to the user or to the Session; other information belongs to the individual scientific document. The guide describes the actual controls, how to save changes and how to check that none of them accidentally alters the digitized points.

1. Telling the Source Apart from the Documentation

The example uses a synthetic image with a dark trace, a second pink stroke and a grid. It was imported as the original Image Dataset into the framework Session.

Synthetic graph with a dark trace, a pink stroke and a grid.
Figure 1. The teaching source is registered as a Session Image Dataset.

The image measures 1280 × 900 pixels. Its colors, marks and thickness are not automatically experimental measurements or uncertainty estimates.

2. Creating a Stable Numerical Reference

The figure was calibrated with four corners: X from 0 to 10 s and Y from −20 to 80 mV. In the Curves tab ten manual points were placed on the dark trace.

Ten manual points on the dark trace.
Figure 2. The initial digitization provides a numerical reference with preserved point identities.

In what follows, titles, legend and display settings will be changed. To check that these are only descriptive changes, we will keep the same point_id values, raster coordinates and scientific coordinates of the ten points.

3. Entering Scientific Notes

Open the Notes tab. The main control is a UTF-8 text editor, suitable for describing the source, the meaning of the colors, any scanning distortions or deliberately excluded traces.

Notes tab with scientific text about the source.
Figure 3. The notes document the interpretation and limits of the raster, without assigning new uncertainty.
Detail of the Notes editor content.
Figure 4. The Notes content is scientific text of the configuration, not a graphic overlay.

In our case we note that the dark trace is the object to be digitized, while the pink trace is a competing element. We also specify that the ink thickness does not represent a standard uncertainty.

4. Saving the Configuration Notes

When you leave the Notes field or switch to another tab, the Viewer can commit the changes through normal Workspace handling. For an explicit save choose Configuration → Save configuration.

Notes tab after saving the configuration.
Figure 5. The text was kept in the Session interactive document through the CORE Workspace.

After leaving the editor and reopening it, the original text is still available. The Notes field does not add points, does not change the calibration and does not directly change the source Dataset.

5. Opening Viewer Settings and Telling the Preferences Apart

Select Configuration → Viewer settings…. The window has six tabs: Display, Digitizing, Calibration, Axes & output, Dataset browser and Configurations.

The commands in the Display tab change what is shown, not the scientific content of the image.

Viewer settings Display tab.
Figure 6. The overlay options and the Canvas appearance are distinct from the scientific table.
Detail of the Display overlay checkboxes.
Figure 7. The controls let you show or hide elements without changing the original pixels.

The window also brings together some shared framework preferences and some local values of the active configuration. The distinction becomes clear after Apply.

6. Digitizing: Selection and Ordering

The Digitizing tab contains Snap to darkest pixel, its radius, the monotonicity preferences, the point order and the number of points for the next assisted acceptance.

Viewer settings Digitizing tab.
Figure 8. Point selection depends on explicit preferences; the default ones can be read.
Detail of the Snap to darkest pixel and radius fields.
Figure 9. The snap radius concerns source pixels, not points of the magnified Canvas.

A snap set now applies to future insertions or moves that use it. It does not retroactively reposition the ten points already acquired and does not change their UUIDs.

7. Calibration: New Default Values

The Calibration tab lets you choose the convention for scale bar ticks, the Y direction of the full-image calibration and the default values for new measurements.

Viewer settings Calibration tab.
Figure 10. The values set are preferences for later actions and do not recalibrate the graph.
Detail of the tick reference and Y direction defaults.
Figure 11. The choice of reading convention must stay distinct from the accepted calibration.

The verification marker fields are Size, Line width and Color. These are visual parameters for later verifications, not the metrological accuracy of the calibration. If the current scientific scale has already been accepted, these new defaults do not automatically transform it.

8. Axes & Output: Identity and Name of the Result

The Axes & output tab shows a summary of the current axes and lets you prepare the Output Dataset identity, the visible name and the naming template.

Viewer settings Axes and output tab.
Figure 12. Scientific references are managed in the Calibration editor; publishing is separate.
Detail of the Output Dataset identity fields.
Figure 13. Changing the proposed identifier does not immediately create a new canonical Dataset.

The base ID, the description and the Dataset naming template will be used in a future publication. Saving them is not the same as publishing a Dataset. Limits, units and scientific calibration are edited in the Calibration tab.

9. Dataset Browser: Catalog, Namespaces and Refresh

The Dataset browser tab handles the search for Image Datasets and the catalog refresh options.

Viewer settings Dataset browser tab.
Figure 14. Catalog filters do not move, delete or rename the Session Datasets.
Detail of the catalog refresh options.
Figure 15. The source already linked must stay unchanged while the catalog is managed.

Turning off the automatic check or refreshing the catalog manually does not move files and does not change the ID of the source already associated. The namespace selector filters what is shown.

10. Configurations: Several Documents in the Same Session

The Configurations tab lists the scientific documents saved in the Session.

Viewer settings Configurations tab listing the saved documents.
Figure 16. The active configuration has its own identity and can be selected from the Viewer.

To open, rename, duplicate or delete a configuration, use the selector and the Configuration menu in the main window. Each document has its own identity; two configurations can use the same image without necessarily sharing all the annotations.

11. Unapplied Changes: Cancel

Before saving, we temporarily change Show point numbers, Image opacity and Canvas background, then press Cancel.

Display tab with temporary unapplied changes.
Figure 17. The drafts stay in the window until Apply, OK or Cancel.

Reopening the window, the previous values still appear.

Reopened Display tab showing the previous values.
Figure 18. Cancel did not record the draft in the CORE and did not change the scientific document.

Cancel discards the unapplied changes: it does not partially save the preferences and does not alter the scientific document.

12. Validation: Snap Radius Out of Range

In the Digitizing tab we try to set Snap radius = 26.

Error message for Snap radius 26.
Figure 19. The allowed range is from zero to twenty-five original pixels.

The Viewer rejects the request because the allowed range is 0–25 pixels. The settings are not partially applied: correct the value and repeat Apply, without assuming that the other fields were saved.

13. Setting a Valid Radius

We set Snap radius = 4 and enable Snap to darkest pixel.

Digitizing tab with Snap radius 4 and snapping enabled.
Figure 20. The valid input is prepared without changing the ten points already saved.

The choice concerns the selection of future points, not the accuracy of the data already digitized. When there are several lines, an unchecked snap can latch onto the wrong trace: always check the new point on the raster.

14. Default Values for Future Calibrations

In the Calibration tab, as an example, we choose Outer edges of ticks, Downward (image pixels) for the next full-image calibration, a new scale reference of 25 mm and a verification marker with Size 16, Line width 3 and Color #2aa5d4.

Calibration tab with new default tick, direction, scale and marker values.
Figure 21. The values are preferences for future calibrations; the current scientific corners stay unchanged.

Choosing a new default does not mean that the current image contains a 25 mm scale bar. The four-point calibration already accepted still represents the limits from 0 to 10 s and from −20 to 80 mV.

15. Local Appearance of the Configuration

In Display we turn on the point numbers, temporarily hide the scale and corner overlays, and choose Image opacity = 72% and Canvas background = #20394a.

Display tab with opacity 72% and background #20394a.
Figure 22. The display is specific to the active scientific configuration.
Canvas with reduced opacity over a dark blue background.
Figure 23. The color choices do not change the canonical raster and do not create points.

These appearance values are stored in the current scientific configuration. The original raster is not recolored and the numerical data are not rewritten.

16. Preparing Name and ID Without Publishing

In Axes & output we set an example ID for the next publication and a description that identifies the synthetic curve.

Axes and output tab with an example Dataset ID and description.
Figure 24. The configured identity will be used at publication, which remains a further action.

The Dataset ID is not the name of the configuration: the latter holds the state of the work, while the published Dataset will be a standalone object. A new ID can be used to publish a later version of the notes, keeping the same numerical geometry.

17. Manual or Automatic Catalog Refresh

The Automatically check for Dataset changes control can be turned off temporarily while working.

Dataset browser tab with automatic checking turned off.
Figure 25. Turning off polling does not change the selected source Dataset.

A manual refresh with the Refresh Dataset catalog now button updates the selection options; it does not change the current image. Automatic mode was later re-enabled in the example Session.

18. Apply Saves and Leaves the Window Open

We press Apply with all values valid.

Viewer settings footer after Apply.
Figure 26. A second Apply is still possible in the same window with a new CORE baseline.
Detail of the Apply confirmation message.
Figure 27. Shared changes are recorded as Session overrides through the Configuration API.

The window stays open and shows the result of the save. A second Apply can save again using the updated CORE state. OK applies and closes; Cancel closes without applying any new changes left in the draft.

19. User Defaults, Session Overrides and Configuration

The same setting can come from several levels. The CONFIGURATION_API_v1 distinguishes:

ScopeOwnerExample
User defaultsPersonal default values of the moduleShow point numbers initially disabled
Session overridePreference shared within the open SessionShow point numbers on; Snap radius 4
Configuration documentScientific property of the specific documentNotes, curve name, opacity 72%, background #20394a

The User defaults values stay unchanged. The shared preferences updated with Apply are kept as Session overrides, while the Canvas appearance stays associated with the scientific configuration.

The framework uses the precedence order of the configuration levels; a Session override must not be confused with a global change for the user.

20. Numbers and Overlays: Representation Only

After applying, in the Curves tab we see the point numbers and the new Canvas rendering, while some calibration markers are hidden.

Curves tab with point numbers and the new Canvas appearance.
Figure 28. The display can change while keeping identical point UUIDs and coordinates.

These options change the visible symbols, not the order and coordinates of the numerical table. The distinction matters when taking screenshots for scientific documentation.

21. Changing the Name of a Curve

In the Curves tab, select the series and press Edit to open the native dialog.

Edit curve dialog for the series.
Figure 29. The curve name is a scientific label, distinct from the numerical data.

We enter a more descriptive name that clarifies the interpretation of the trace.

Edit curve dialog with the new descriptive name.
Figure 30. The name describes the synthetic origin and the interpretation of the legend.

After OK, the new name appears in the list.

Curves table showing the renamed series.
Figure 31. Changing the name does not alter the identity of the ten points already acquired.
Detail of the renamed curve in the table.
Figure 32. The scientific identity of the series stays tied to the same curve UUID.

The name is part of the scientific context, but it does not alter the ten point_id values or the saved coordinates.

22. Changing the Axis Labels

We switch to Calibration. Before the change, the axes are identified as Elapsed time and Detector response.

Calibration tab with the original axis labels.
Figure 33. The axis limits and units were defined during the accepted calibration.

We change only the names to Elapsed time since trigger and Synthetic detector signal, then press Apply axis settings.

Calibration tab with the new axis labels entered.
Figure 34. Only the labels are changed, leaving seconds, millivolts and limits unchanged.
Graph with the ten points after the axis rename.
Figure 35. The physical position of the ten points was identical after the descriptive change.
Detail of the axis settings with unchanged units and limits.
Figure 36. The labels must not be confused with a transformation of the measurements.

The units s and mV, the limits and the four corners stay identical. The comparison of the records confirms that the scientific coordinates and the identifiers of the ten points are also unchanged. Changing a label is not the same as changing a scale.

23. Checking That an Annotation Is Not a Transformation

The check can be summarized by distinguishing the fields that were changed from those that were kept.

ElementResult
Curve nameUpdated
Axis namesUpdated
X/Y units and limitsUnchanged
Four-corner calibrationUnchanged
Original rasterUnchanged
Ten UUIDs and scientific pointsUnchanged

If limits, units or transformation were changed instead, the new meaning of the data would have to be checked. This guide concerns only descriptive annotations.

24. Publishing a First Version with Notes

In the Publish tab we choose the accepted calibration and a new ID.

Publish tab with the accepted calibration and a new Dataset ID.
Figure 37. The numerical publication keeps ten coordinates and the scientific metadata of the source.

Publishing creates the numerical Dataset with the ten points and links the notes present in the configuration.

Published Dataset with its canonical table.
Figure 38. The Dataset has a numerical table separate from the configuration notes document.
Detail of the ten published rows.
Figure 39. The ten numerical records stay independent of the prose that accompanies them.

The notes are saved as a Dataset Notes Markdown document, not turned into new numerical columns. The descriptive name of the Dataset and the structured metadata keep a distinct role.

25. Revising the Legend in the Notes Tab

After checking the source, we edit the text in Notes to state that the pink trace does not belong to the selected curve.

Notes tab with the revised legend text.
Figure 40. The revision states that the pink trace does not belong to the selected family.

The revision is saved through FocusOut and Configuration → Save configuration. The text does not change the number or position of the points.

26. Publishing a Second Dataset with the Revised Notes

To keep the later documentation as well, we prepare another Dataset ID, keeping the same calibration.

Publish tab with a second Dataset ID.
Figure 41. The numerical Dataset is republished with the same points but a different context document.
Dataset browser listing both published Datasets.
Figure 42. The previous notes document stays associated with the first Dataset.

The result still contains ten points: the canonical table has the same numerical bytes and the same SHA-256 as the first publication, because the coordinates were not changed.

27. Numbers and Documentation Are Not the Same Thing

The two publications contain the same coordinate table but two different notes documents. The first keeps the initial context; the second contains the revision.

It is therefore possible to have the same numerical identity of the content, but different Dataset identities and documentary content. For this reason the author must keep the references to the source, the points and the version of the notes without confusing them.

28. Opening Dataset Notes from the CORE

From the GX-TXT menu we open the native Dataset notes… button and select the first Dataset.

Dataset notes dialog of the GX-TXT CORE.
Figure 43. The function is handled by the GX-TXT CORE and not by the internal Digitalizer editor.

The control is in the common GX-TXT environment. It is not a second scientific editor of Curve Digitalizer: it lets you read the Markdown document associated with the canonical Dataset.

29. Markdown Source and Formatted Preview

The CORE shows the notes editor in the Dataset tab, with GX-Markup / Markdown source and Rendered preview.

Dataset notes editor with the Markdown source.
Figure 44. The canonical notes are a readable document, distinct from the structured metadata.
Rendered preview of the Dataset notes.
Figure 45. The document keeps the reference to the legend and the declared limits.

The published text keeps the section titled with the Curve Digitalizer Notes. Its references to the image and the legend can be read without opening the original interactive document.

30. Keeping the Previous Version Too

We select the second Dataset Notes. The CORE shows the revision of the legend.

Dataset notes of the second Dataset with the revised legend.
Figure 46. The revision did not overwrite the notes associated with the first Dataset.

The two documents have different content and were verified as separate Markdown files. Viewing them and choosing Cancel, no rewrite takes place. The notes of the first publication stay available alongside the second.

31. Duplicating a Scientific Configuration

The Configuration → Duplicate configuration menu creates a copy with a new configuration identifier.

Duplicated configuration selected in the Viewer.
Figure 47. The copy uses a scientific and calibration identity distinct from the original.

In this example the copy keeps the source and the ten points, but receives a new identity for the calibration group and its realization. Duplication does not automatically publish a further numerical Dataset.

32. Independent Notes in the Copy

We open the Notes of the copy and enter an alternative explanation, referring to the same synthetic image.

Notes tab of the copy with an alternative explanation.
Figure 48. The copy can have its own notes without changing the original publication.

The text belongs to the new document. Going back to the original configuration, its prose is not replaced by that of the copy.

33. Independent Appearance for the Copy

In the copy we set Image opacity = 54% and Canvas background = #36556c.

Display tab of the copy with opacity 54% and background #36556c.
Figure 49. The display belongs to the active document and not to the global User preferences.
Canvas of the copy with reduced opacity and blue-gray background.
Figure 50. The copy uses fifty-four percent opacity and a blue-gray background.

After Apply, the copy document keeps its own appearance and its own notes.

Viewer settings after Apply in the copy.
Figure 51. The shared Session preferences and the local configuration notes have different owners.

The shared Session preferences, instead, keep applying to both documents; we did not change the User defaults.

34. Going Back to the Original Configuration

From the selector at the top we resume the original configuration.

Original configuration selected again with its own notes.
Figure 52. Switching between profiles does not automatically carry over the prose of the copy.

Its revised Notes, the opacity of 72% and the background #20394a are recovered. No change made to the copy propagated to the text or appearance of the original.

35. Save, Close and Reopen of the Notes

We save the configuration, close the Viewer normally and reopen it from the same Session.

Reopened Viewer with the Notes text and the ten points.
Figure 53. The CORE Workspace kept the second interpretation and the original points.

The text in Notes is still present. The original Dataset and the two published Markdown documents are persistent as well. The persistence of the interactive document is distinct from the persistence of the canonical tables already published.

36. Checking the Saved Display After Reopening

In the original configuration the Display tab still shows the selected appearance values.

Reopened Display tab with opacity 72% and background #20394a.
Figure 54. The per-document value survives reopening the Session.
Detail of the original configuration appearance after reopening.
Figure 55. The personal settings of the configuration were not moved to the copy.

The opacity of 72% and the color #20394a are per-configuration. Another configuration in the same Session can use different ones without changing the global defaults.

37. Checking the Shared Preferences

The Digitizing tab still shows snapping and its radius of four.

Reopened Digitizing tab with snapping and radius 4.
Figure 56. The User factory and User defaults values were not overwritten.
Detail of the Session override for the snap radius.
Figure 57. The Session override is visible even after closing and reopening the Viewer.

These shared settings come from the Session in the Configuration API. The same preferences are therefore available when switching to the copy; the notes and the Canvas color, instead, stay specific to the document.

38. Calibration and Dataset Browser After the Restart

In the Calibration tab the new defaults for later actions are available, without changing the original calibration.

Reopened Calibration tab with the saved defaults.
Figure 58. The new Y direction applies to future calibration actions; it does not alter the accepted corners.

In the Dataset browser a manual catalog refresh can be requested, keeping the associated source.

Dataset browser after a manual catalog refresh.
Figure 59. The manual refresh rebuilds the catalog without changing the SHA of the source.

A browser setting is not a change to the points or to the physical provenance of the raster.

39. Checking the Points Again

The Curves tab displays the ten acquired points with the new names of the series and of the axes.

Curves tab with the ten points and the new series and axis names.
Figure 60. The same series contains ten unchanged point_id values and coordinates.

Checking the Workspace after Save/Close/Reopen confirmed the original identities and coordinates. Labels and display were rebuilt from the document without altering the scientific records.

40. Checking the Duplicated Configuration After Reopening

Selecting the copy, its Notes and its independent appearance are found again.

Duplicated configuration reopened with its own notes and appearance.
Figure 61. The two configurations are persistent and keep notes and appearance separately.

The original and the copy can be used for alternative scientific revisions, but their identifiers must be kept distinct, and they must not be presented as two independent experimental measurements when they are simply two interpretations of the same image.

41. Recommended Procedure and Limits

  1. Load an identified source and check its calibration before adding annotations.
  2. Give axes and curves scientifically meaningful names, without confusing the name with units or transformations.
  3. Enter in Notes the meaning of the traces and the precautions concerning the source.
  4. Use Viewer settings knowing how to distinguish User defaults, Session overrides and configuration-specific parameters.
  5. Check the field limits; a failed validation is not the same as a partial save.
  6. Use Apply to save without closing, OK to apply and close and Cancel to discard unconfirmed changes.
  7. Publish numerical Datasets with distinct identifiers; check the Dataset Notes documents separately.
  8. If the scientific context changes, keep a revision of the notes without automatically overwriting earlier publications.
  9. Duplicate a configuration when independent interpretations are needed, always distinguishing the new document from a new independent measurement.
  10. Save, close and reopen, then check points, notes, overrides, source and the documents associated with the Datasets.

Curve Digitalizer keeps measurements, scientific annotations, Viewer preferences and documentation of published results separate. This separation makes the work easier to understand, check and reproduce, but it does not automatically give the digitized data accuracy or metrological uncertainty.