5.1. Teramon Tools

5.1.1. Overview

Teramon Tools is a read-only analytics viewer for teramon automated monitoring projects. It ingests the per-cycle output that a teramon station writes over the life of a monitoring campaign and surfaces the quality and health of that campaign: resection quality, which target points were not measured, instrument and environment telemetry, and cycle timing.

Its focus is QA and instrument health only. It answers questions such as “is the resection drifting?”, “which points are being missed and how often?”, “is the instrument warm / powered / level?” and “are cycles running on schedule?”. It does not compute or report the deformation (displacement) of the monitored target points — that analysis stays in teramon.

The tool is found under Analytics > Teramon Tools in the sidebar.

5.1.2. Loading a project

The top bar has a project-file selector, a Load button, a progress bar and an Export button.

  1. Pick the teramon .trm project file. Next to it the tool expects the two companion folders teramon writes:

    • <project>_data\ — one .xml per cycle (named by cycle number, e.g. 00000403.xml), the primary data source, and an optional matching .res resection-adjustment report next to each .xml.

    • <project>_log\ — an optional <cycle>.log per cycle carrying instrument power / voltage telemetry.

  2. Press Load. The cycles are read in cycle-number order (the progress bar tracks the sweep) and merged into one table per view. Loading is robust: a missing or malformed .xml, .res or .log never aborts the load — the affected fields are simply left blank for that cycle.

The .trm file supplies the project title and the scheduled cycle interval (derived from the timetable), which the Cycles & Timing view uses to flag missed cycles.

5.1.3. The views

The loaded project is presented as a set of tabs. Every grid is read-only; columns and rows can be resized by dragging their borders.

5.1.3.1. Overview

A key/value summary of the whole campaign:

  • Title and Instrument (model and, when present, serial number).

  • Cycle count and the date span (first to last cycle start).

  • Cycles with missing points, Resection out-of-limit and Cycles with errors — the three health counters.

  • Avg / Max duration (s) and Median interval (min) — cycle timing at a glance.

  • Temperature min / max (C) across the campaign.

5.1.3.2. Resection

One row per cycle with the resection result and its adjustment statistics, mirroring teramon’s .res report: ResX, ResY, ResZ, ResS, ResScaleFactor, ResDx/Dy/Dz, Iterations, the backsight point and its checks (DHz, DVz, DSD, DHD), and the a-posteriori statistics (aPosteriori, StdDev, degrees of freedom).

A cycle whose backsight slope-distance closure |DSD| > 0.02 or whose a-posteriori σ > 1.0 is flagged out-of-limit and its row is shaded light red, so a drifting or poorly-fitting setup stands out at a glance.

The chart plots the station’s movement relative to the first cycle — dX, dY, dZ in millimetres — together with ResS, so setup drift over the campaign is immediately visible.

5.1.3.3. Completeness

Two grids stacked together:

  • Per cycle — MissingCount and the comma-separated MissingNames of the target points that were expected but not measured that cycle. Rows with any miss are shaded light red.

  • Per point (availability) — for every expected target: Measured, Missing, Total and the availability percentage, so a chronically unreliable prism is easy to spot.

The bar chart shows the missing-measurement count per point.

5.1.3.4. Environment & Instrument

One row per cycle with the environmental readings (Temperature, Humidity, Pressure — averaged over that cycle’s measurements) and the instrument telemetry (InclinationT, InclinationL, PowerPct, InstrumentVoltage, BatteryPct, CoreTemp, PsuTemp, VInput).

The chart trends the average temperature and the two inclination components across the campaign.

5.1.3.5. Cycles & Timing

One row per cycle with its Start, End, DurationSecs, the gap from the previous cycle’s start (GapToPrevSecs), a Missed flag, and any Remarks / Errors. A cycle whose gap exceeds 1.5× the scheduled interval is flagged Missed and shaded light red — a gap in the monitoring record. The chart trends cycle duration over time.

5.1.4. Charts

Every chart is interactive:

  • Zoom by dragging a rectangle or with the mouse wheel; pan by dragging.

  • A legend identifies each series; a fixed 8-colour palette keeps the series distinguishable. Clicking a series in the legend hides it; clicking it again shows it back — its colour marker goes blank while hidden.

  • An axis-range strip above each chart lets you type explicit X / Y minimum and maximum values and Apply them, or return to Auto scaling — useful for focusing on a suspect stretch of cycles.

5.1.5. Excel export

Export writes the whole project to a single .xlsx workbook. The button is on the top bar and is repeated on the Completeness, Environment and Cycles views. The workbook has one sheet per view:

  • Overview — the key/value summary.

  • Resection — the full per-cycle resection table.

  • Completeness — the per-cycle missing table plus an Availability block below it.

  • Environment — the per-cycle environment and instrument telemetry.

  • Cycles — per-cycle start / end / duration, remarks and errors.

5.1.6. Notes

  • The viewer is entirely read-only; it never modifies the teramon project.

  • Angular values are shown in the units teramon records them (gon); the tool treats the numeric fields as opaque and applies no unit conversion.

  • The resection out-of-limit thresholds and the 1.5× missed-cycle factor are fixed defaults in this version.