{% import "_nc_tables.html" as t -%} {% import "_nav.html" as navm -%} {% import "_masthead.html" as mh -%} {% macro snippet(id, title, text) -%}

{{ title }}

{%- endmacro -%} {{ masthead.title }} — {{ masthead.type }}
{{ mh.masthead(masthead, page_nav) }} {%- if draft %}

Draft: converted with no mission config, so platform, contributor and institution metadata are absent or UNK and this is not an OG1 file (amber: every draft page carries this line). It shows what the basestation files hold and what the conversion does to them; write the config with seagliderOG1 init --raw-dir …, then seagliderOG1 process.

{%- endif %} {%- set secs = number_sections([("summary", "Summary"), ("suggested", "Suggested mission.yaml lines") if draft_snippets else none, ("config-check", "mission.yaml against the data") if config_suggestions else none, ("losses", "Losses"), ("flight", "Flight model"), ("calibration", "Sensors and calibration"), ("traced", "One variable traced"), ("glossary", "Glossary", "reference"), ("globals", "Basestation global attributes" if draft else "Global attributes", "reference")]) %} {{ mh.jump_nav(secs) }}

{{ secs.mark["summary"] }} Summary

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.

{%- for t in tiles %}
{{ t.label }}
{{ t.value }}
{% endfor %}

Stages (each links to its first step on the Processing page; amber: a step of the stage is not recorded in the file):

{%- for s in stages %}{{ s.label }}{% if not loop.last %}›{% endif %}{% endfor %}

{% for c in verdict_clauses %}{{ c.text }}{% if not loop.last %} · {% endif %}{% endfor %}

{%- if draft_snippets %}

{{ secs.mark["suggested"] }} Suggested mission.yaml lines

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.

{%- for s in draft_snippets %} {{ snippet("snippet-" ~ loop.index, s.title, s.text) }} {%- endfor %}
{%- endif %} {%- if config_suggestions %}

{{ secs.mark["config-check"] }} mission.yaml against the data

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.

{%- for s in config_suggestions %} {%- set block = loop.index %}

{{ s.title }}

{{ s.note }}

{%- for b in s.boxes %} {{ snippet("config-" ~ block ~ "-" ~ loop.index, b.label, b.text) }} {%- endfor %}
{%- endfor %}
{%- endif %}

{{ secs.mark["losses"] }} Losses

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").

{%- for l in losses %} {{ l.loss }} {%- endfor %}
LossKindCountExamplesRecorded in the file
{{ 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

{{ secs.mark["flight"] }} Flight model

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).

{%- for f in flight %} {{ f.ready }} {%- endfor %}
RoleBasestation → OG1 fileUnitsFormgliderflightOG1 readsReady?
{{ 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 }}

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

{{ secs.mark["calibration"] }} Sensors and calibration comments

Sensors named by OG1 (not required)

{%- if og1_sensors %}

{{ 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.

{%- for r in og1_sensors %} {%- endfor %}
SensorTypeMakerModelSerialCalibrationUsed by
{{ r.name }}{{ r.type }}{{ r.maker }}{{ r.model }}{{ r.serial }}{% if r.shared %} (shared){% endif %}{{ r.calibration }}{{ r.n_used }}: {{ r.used_by }}
{%- else %}

Not applicable to this file: no SENSOR_* variables.

{% endif %}

Calibration comments: basestation → SENSOR_*

{%- if calibration_comments %}

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.

{% for c in calibration_columns %}{% endfor %}{% for c in calibration_columns %}{% endfor %} {%- for r in calibration_comments %} {% for c in calibration_columns %}{{ r[c.key] }}{% endfor %} {%- endfor %}
{{ c.header }}
{%- elif calibration_comments is none %}

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.

{% endif %}

{{ secs.mark["traced"] }} One variable traced

{%- if traced %} {%- set row, trace = traced %}

{{ row.basestation }} → {{ row.name }}, through every step that touched it; the numbers are the Processing page's steps.

{%- for t in trace %} {%- endfor %}
#StepBeforeAfter
{{ t.number }}{{ t.step }}{{ t.before }}{{ t.after }}
{%- else %}

Not applicable to this file: no renamed variable had its units converted.

{% endif %}

{{ secs.mark["glossary"] }} Glossary

{% include "_glossary.html" %}
{%- if draft %}

{{ secs.mark["globals"] }} Basestation global attributes

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.

{%- for r in basestation_rows %} {{ r.status }}{% if r.distinct %}
values{{ r.distinct|join(" · ") }}
{% endif %}
{%- endfor %}
AttributeValue (first file)In
{{ r.name }}{{ r.value }}
{%- else %}

Basestation global attributes: not in the conversion record ({{ record_name }}); convert again with this version to record them.

{%- endif %} {%- else %}

{{ secs.mark["globals"] }} Global attributes

{{ requirement_text }} The attributes, grouped with their OG1 tier and source, the Conventions check and the history are on the OG1 format page.

{%- endif %}
{{ js_sort_tables | safe }} {%- if draft_snippets or config_suggestions %} {%- endif %} {{ js_top_links | safe }}