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.
- 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.
- Add
scan_awith X Variable = x and Y Variable = y. Declarebordo_1as the feature,obs_aas the observation,punti_aas the point set,cal_aas the calibration andstrumento_1as the group. Repeat forscan_bwithobs_b,punti_bandcal_b, keeping the same feature and group. - 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.
- 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 forstage = 0for the 26 original rows andstage = 1for 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
| Symptom | What to do |
|---|---|
| Invalid analysis ID | Use a unique identifier with valid syntax and repeat Analyze. |
| Declare and verify a common physical coordinate frame and units explicitly | Fill frames and units, then check the real reference before check the box. |
| Incompatible coordinate frames or Incompatible unit conversion | Check 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 observations | Use the sensitivity design if observation and points are shared. For independent measures, check duplicates and identity. |
| Hierarchical components need independent sources and within-source repeats | Check that the repetitions exist within real groups and that there are at least two. |
| Distinct physical features must be analyzed in separate studies | Remove the source of the different feature and analyze it separately. |
| Job FAILED after initial validation | Open 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..1000 | The 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 stale | For the Digitizer source, explicitly reread the source, verify the identity and repeat Prepare and Accept. |
| Dataset ID already exists | Open the existing output or choose a new ID, reanalyze and publish a new set. |
| Workspace schema has no typed field | Publish the result if needed. Return to the scientific configuration prior to the adoption with Undo and save the recipe. |