{% import "_nc_tables.html" as t -%} {% import "_nav.html" as navm -%} {% import "_masthead.html" as mh -%} {% macro snippet(id, title, text) -%}
{{ title }}
How to read this report. The tiles say whether the conversion is complete. Losses lists what did not reach the OG1 file in the same form; empty means lossless. The Variables page finds any variable by its basestation or OG1 name; the Processing page lists every step in the order it ran{% if phase_href %}; the Phase page shows how PHASE was assigned{% endif %}. Terms are in the glossary.
Counts from the OG1 file and the conversion record beside it{% if not record_present %}, which was not found, so the basestation counts read "not recorded"{% endif %}. Highlight rule: a tile is marked when its count is short (inputs not all accounted for, a dive record missing) or when any loss applies.
Stages (each links to its first step on the Processing page; amber: a step of the stage is not recorded in the file):
{% for c in verdict_clauses %}{{ c.text }}{% if not loop.last %} · {% endif %}{% endfor %}
What this draft read from the basestation files, as lines to paste into a mission.yaml (start one with seagliderOG1 init, or use <id>_draft_mission.yaml written beside this page, which also has raw_dir). Only values the files carry are filled; null is yours to fill.
Lines for the mission.yaml this conversion was given, where it and the output disagree or fall short: the requested dives against the dives that reached the file; platform fields set in the config against the values the files carry (the config wins by design, e.g. a local nickname for PLATFORM_SERIAL_NUMBER, so a pair is a value to check, not an error); platform fields written as UNK or omitted; institution ids the registry resolved; and missing ACDD globals. Only checks that find something are shown.
{{ s.note }}
A loss is something in the basestation files that is not in the OG1 file in the same form: dropped structure, or a label not kept. Changed values that are recorded (unit factors, float32 storage, time shifts) and additions are steps, on the Processing page. Highlight rule: a loss that applies to this file, or one the conversion does not count ("not recorded").
| Loss | Kind | Count | Examples | Recorded in the file |
|---|---|---|---|---|
| {{ l.loss }} | {{ l.kind }} | {{ "not recorded" if l.count is none else l.count }} | {{ l.examples[:5] | join(", ") }}{% if l.examples | length > 5 %}, …{% endif %} | {{ l.recorded }} |
source: seagliderOG1/reports/processing.py:losses
The basestation variables a glider flight model reads or writes: where each went in the OG1 file, its units, and its form. gliderflightOG1 reads names the input that package expects. Highlight rule: an input gliderflightOG1 reads that is not usable here as a number (stored as per-dive JSON text, or not written).
| Role | Basestation → OG1 file | Units | Form | gliderflightOG1 reads | Ready? |
|---|---|---|---|---|---|
| {{ f.role }} | {{ f.basestation }}{% if f.row and f.row.name %} →{% endif %}{% if f.row and f.row.name %}{{ f.row.name }}{% endif %} |
{% if f.row %}{% if f.row.units_in and f.row.units_in != f.row.units_out %}{{ f.row.units_in }} → {% endif %}{{ f.row.units_out or "—" }}{% if f.row.factor not in (none, 1) %} (×{{ "%g" | format(f.row.factor) }}){% endif %}{% endif %} |
{{ f.form }} | {{ f.reads_as }} |
{{ f.ready }} |
gliderflightOG1 also reads DIVENUM and UPDN (here dive_number and PROFILE_DIRECTION), and its constants as global attributes (here one-value variables); it is to read the OG1 names.
source: seagliderOG1/reports/processing.py:flight_rows
{{ og1_sensors|length }} SENSOR_* variables, from the basestation calibration comments and config/OG1_sensor_attributes.yaml. Used by lists the variables whose sensor attribute names the sensor. Amber: the serial number or calibration date is UNK or empty (not read from the calibration comment; files from 0.2.0 and earlier wrote every digit zero instead); or two sensors share a serial number, which usually means a calibration comment was copied from another instrument. Both come from the basestation sg_calib_constants; check them against the calibration sheets.
| Sensor | Type | Maker | Model | Serial | Calibration | Used by |
|---|---|---|---|---|---|---|
| {{ r.name }} | {{ r.type }} | {{ r.maker }} | {{ r.model }} | {{ r.serial }}{% if r.shared %} (shared){% endif %} | {{ r.calibration }} | {{ r.n_used }}: {{ r.used_by }} |
Not applicable to this file: no SENSOR_* variables.
SENSOR_*How each sensor's serial number and calibration date were read. Basestation variable and Original are the source: the sg_cal_calibcomm* variable (from sg_calib_constants.m, typed by the operator) and its text, kept in the file as original_calibcomm. The remaining columns are the result: the OG1 SENSOR_* variable and its sensor_serial_number and sensor_calibration_date{% if calibration_columns|selectattr("key", "equalto", "channels")|list %}, per-channel dates (sensor_calibration_dates, RBR){% endif %}, with the serial / date rules that read them (named on the calibration comments docs page). Amber: the serial or date is UNK (not read), the serial is a lone token with no label (it may be a model number), the calibration date is after the mission's first sample or more than 30 years before it, the date has two readings and was chosen by convention (slashes month-first, dots and dashes day-first), or two sensors share a serial number. Correct any of these with sensors: in mission.yaml.
| {{ c.header }} | {% endfor %}
|---|
| {{ r[c.key] }} | {% endfor %}
Not available: this file was written before the conversion recorded how calibration comments were read (seagliderOG1 0.2.0 or earlier); reconvert to see it.
{%- else %}Not applicable to this file: no SENSOR_* variables.
{{ row.basestation }} → {{ row.name }}, through every step that touched it; the numbers are the Processing page's steps.
| # | Step | Before | After |
|---|---|---|---|
| {{ t.number }} | {{ t.step }} | {{ t.before }} | {{ t.after }} |
Not applicable to this file: no renamed variable had its units converted.
{% endif %}For an OG1 file, mission.yaml must supply what is missing here — {{ requirement_text }}
{%- if basestation_rows %}The input files' own global attributes, before any OG1 enrichment; the value is the first file's. Amber: the attribute differs between files or is missing from some.
| Attribute | Value (first file) | In |
|---|---|---|
{{ r.name }} | {{ r.value }} | {{ r.status }}{% if r.distinct %} values{{ r.distinct|join(" · ") }} |
Basestation global attributes: not in the conversion record ({{ record_name }}); convert again with this version to record them.
{%- endif %} {%- else %}{{ requirement_text }} The attributes, grouped with their OG1 tier and source, the Conventions check and the history are on the OG1 format page.
{%- endif %}