Exercises and troubleshooting

Use the supplied CSV files to reproduce the exercises. Import them into the same Session with the first row as the header. Set x and y to mm and leave order dimensionless. Use the file name without its extension to identify the source in Source observations. Start each exercise from a new draft and choose an analysis ID that has not already been published.

Two independent scans of the same edge

Use scan_a.csv and scan_b.csv. They have 13 measurements each. The first ranges from 0 to 12 mm, the second from 2 to 14 mm.

  1. Set Method = yx, Study design = repeatability, Unique analysis ID = bordo_prova and Common physical frame ID = banco_a. Leave both units in mm and check I verified a common physical frame, which is valid because these synthetic data use the same reference frame.
  2. Add scan_a with X Variable = x and Y Variable = y. Declare bordo_1 as the feature, obs_a as the observation, punti_a as the point set, cal_a as the calibration and strumento_1 as the group. Repeat for scan_b with obs_b, punti_b and cal_b, keeping the same feature and group.
  3. Press Analyze. A 200-point consensus profile appears from 2 to 12 mm. The inspector shows two independent observations. Show the aligned traces and verify that the original traces extend beyond the common domain.
  4. Choose Publish results and open replicate.bordo_prova.profile. At the first coordinate the profile averages Y about 2.853 mm and SD Y about 0.0438 mm. The SD is the one between the two scans at the aligned point. In traces, look for stage = 0 for the 26 original rows and stage = 1 for the 400 derivative points.

Repeated measurements with two instruments

Add scan_c.csv and scan_d.csv to the two scans from the previous example. Choose hierarchical, set a new ID, and keep the same frame and feature. Give each trace a distinct observation and point set. Assign A/B to strumento_1 and C/D to strumento_2. Analyze and verify that the result reports four observations, two groups and two within-source degrees of freedom. After publication, find y_within, y_between and y_total in the profile. y_sem is unavailable for this design.

A closed contour with different phase and direction

Use loop_a.csv and loop_b.csv. Choose xy_path and repeatability, use the same frame in mm and the same Physical feature ID, and assign distinct observations and point sets. For both traces select x, y, order and Topology = closed, and use angolo_inferiore_sinistro as the shared starting landmark. For A, use forward with phase 0. For B, use reverse with phase 2. Run Analyze. The profile spans 0 to 1 on the normalized parameter. Show the aligned traces and verify that they start at the declared corner and follow the expected direction.

For an open path that goes back to X, you can try again with return_a.csv and return_b.csv, Topology = open, A forward and B reverse. The two corresponding ends are oriented in the same direction. In the XY profile, parts in which X decreases remain.

Two calibrations of the same observation

Two synthetic packages are available and were tested in a separate Session. Download the raster source and the calibrated curves. On the Dataset tab, open Dataset actions → Import Dataset ZIP…. In a new Session, import the digitizer_image raster first, then the digitizer_combined table. Use Open and Import Dataset, keeping the suggested IDs. For the second step, choose the Reference pair and then the Calibration B pair in Replicate Curves. Both belong to Profile of the same edge. Use yx, a verified frame and mm units. The Digitizer sources chapter explains how to select and prepare each pair. Set Study design = calibration_sensitivity, use the same Independent observation ID and Original point-set ID for both observations, and keep separate calibration IDs. The expected result reports one independent observation and displays two traces. Compare y_std and y_sem in the profile. The first column describes sensitivity and the second is missing.

Troubleshooting messages

SymptomWhat to do
Invalid analysis IDUse a unique identifier with valid syntax and repeat Analyze.
Declare and verify a common physical coordinate frame and units explicitlyFill frames and units, then check the real reference before check the box.
Incompatible coordinate frames or Incompatible unit conversionCheck source IDs and turn data into a compatible reference. Remove and add the sources to be replaced if needed.
Repeated calibrations of one point set are not independent observationsUse the sensitivity design if observation and points are shared. For independent measures, check duplicates and identity.
Hierarchical components need independent sources and within-source repeatsCheck that the repetitions exist within real groups and that there are at least two.
Distinct physical features must be analyzed in separate studiesRemove the source of the different feature and analyze it separately.
Job FAILED after initial validationOpen the Job log. Without common domain, correct inputs. With intersections, incorrect order or phase out of range, check which point is the beginning and if the tracks physically represent the expected path.
Curve Source page count must be 1..1000The log indicates the source read defect over 1,000 actual rows. Use a selection within the threshold only when it still represents the scientific problem.
Source page expectation is staleFor the Digitizer source, explicitly reread the source, verify the identity and repeat Prepare and Accept.
Dataset ID already existsOpen the existing output or choose a new ID, reanalyze and publish a new set.
Workspace schema has no typed fieldPublish the result if needed. Return to the scientific configuration prior to the adoption with Undo and save the recipe.