reorder coordinates and add links to vocabs (#253)

OceanGlidersCommunity · Jun 11, 2024 · 9977fb3 · 9977fb3
1 parent 3049f95
commit 9977fb3
Showing 1 changed file with 63 additions and 45 deletions.
diff --git a/OG_Format.adoc b/OG_Format.adoc
@@ -235,125 +235,143 @@ The mission identifier used by the institution principally responsible for origi
 = Location variables
 ////
 == Location variables
+
 ////
-** [[gps-variables]]
-== GPS variables
+* [[along-track-positioning-variables]]
+== Along track positioning variables
 ////
-=== GPS variables
-
-OG1.0 requirements cover the GPS variables delivered by the glider when at the sea surface, described in the table below.
+=== Coordinates
 
+OG1.0 requirements cover positioning variables and geolocation of any scientific measurements made by the glider during its mission, described in the table below.
 
 [cols="1a,2a,1",options="header",]
 |============================================================
 |*VARIABLE NAME* |*variable attributes* |*requirement status*
-|LATITUDE_GPS
+|TIME
 
 * data type: double
 * dimension: N_MEASUREMENTS |
 
-* long_name = “latitude of each GPS location”;
-* standard_name = “latitude”;
-* units = “degrees_north”;
-* _FillValue = -9999.9;
-* valid_min = -90.0;
-* valid_max = 90.0;
-* ancillary_variables = "LATITUDE_GPS_QC"
-
+* long_name = “Time elapsed since 1970-01-01T00:00:00Z”;
+* calendar = "gregorian" ;
+* units = “seconds since 1970-01-01T00:00:00Z”;
+* _FillValue = -1.0 ;
+* valid_min = 1e9 ;
+* valid_max = 4e9 ;
+* ancillary_variables = “TIME_QC”;
+* interpolation_methodology = “”;
+* time_vocabulary = “https://vocab.nerc.ac.uk/collection/OG1/current/TIME/”;
  |mandatory
-|LONGITUDE_GPS
+
+|LONGITUDE
 
 * data type: double
 * dimension: N_MEASUREMENTS |
 
-* long_name = “longitude of each GPS location”;
+* long_name = “longitude of each measurement and GPS location”;
 * standard_name = “longitude”;
 * units = “degrees_east”;
 * _FillValue = -9999.9;
 * valid_min = -180.0;
 * valid_max = 180.0;
-* ancillary_variables = "LONGITUDE_GPS_QC"
+* ancillary_variables = "LONGITUDE_QC";
+* interpolation_methodology = “”;
+* longitude_vocabulary = “https://vocab.nerc.ac.uk/collection/OG1/current/LON/”;
+ |mandatory
 
+|LATITUDE
+
+* data type: double
+* dimension: N_MEASUREMENTS |
+
+* long_name = “Latitude north (WGS84)”;
+* standard_name = “latitude”;
+* units = “degrees_north”;
+* _FillValue = -9999.9;
+* valid_min = -90.0;
+* valid_max = 90.0;
+* ancillary_variables = "LATITUDE_QC"
+* interpolation_methodology = “”;
+* latitude_vocabulary = “https://vocab.nerc.ac.uk/collection/OG1/current/LAT/”;
  |mandatory
-|TIME_GPS
+
+|DEPTH
 
 * data type: double
 * dimension: N_MEASUREMENTS |
 
-* long_name = “time of each GPS location”;
-* calendar = "gregorian" ;
-* units = “seconds since 1970-01-01T00:00:00Z”;
-* _FillValue = -1.0 ;
-* valid_min = 1e9 ;
-* valid_max = 4e9 ;
-* ancillary_variables = “TIME_GPS_QC”
+* long_name = “Depth below surface of the water body by unknown instrument and correction to zero at sea level using unspecified algorithm.”;
+* standard_name = “depth”;
+* units = “metres”;
+* _FillValue = -9999.9;
+* valid_min = 0.0;
+* valid_max = 10000.0;
+* ancillary_variables = "DEPTH_QC"
+* interpolation_methodology = “”;
+* depth_vocabulary = “https://vocab.nerc.ac.uk/collection/OG1/current/DEPTH/”;
+|mandatory
 
- |mandatory
 |============================================================
 
 
+See parameters section for guidance on attributes and conventions on _QC channels.
+
 ////
-* [[along-track-positioning-variables]]
-== Along track positioning variables
+** [[gps-variables]]
+== GPS variables
 ////
-== Along track positioning variables
+=== GPS variables
+
+OG1.0 requirements cover the GPS variables delivered by the glider when at the sea surface, described in the table below.
 
-OG1.0 requirements cover positioning variables and geolocation of any scientific measurements made by the glider during its mission, described in the table below.
 
 [cols="1a,2a,1",options="header",]
 |============================================================
 |*VARIABLE NAME* |*variable attributes* |*requirement status*
-|LATITUDE
+|LATITUDE_GPS
 
 * data type: double
 * dimension: N_MEASUREMENTS |
 
-* long_name = “latitude of each measurement and GPS location”;
+* long_name = “latitude of each GPS location”;
 * standard_name = “latitude”;
 * units = “degrees_north”;
 * _FillValue = -9999.9;
 * valid_min = -90.0;
 * valid_max = 90.0;
 * ancillary_variables = "LATITUDE_GPS_QC"
-* interpolation_methodology = “”;
-
 
  |mandatory
-|LONGITUDE
+|LONGITUDE_GPS
 
 * data type: double
 * dimension: N_MEASUREMENTS |
 
-* long_name = “longitude of each measurement and GPS location”;
+* long_name = “longitude of each GPS location”;
 * standard_name = “longitude”;
 * units = “degrees_east”;
 * _FillValue = -9999.9;
 * valid_min = -180.0;
 * valid_max = 180.0;
-* ancillary_variables = "LONGITUDE_GPS_QC";
-* interpolation_methodology = “”;
+* ancillary_variables = "LONGITUDE_GPS_QC"
 
  |mandatory
-|TIME
+|TIME_GPS
 
 * data type: double
 * dimension: N_MEASUREMENTS |
 
-* long_name = “time of measurement”;
+* long_name = “time of each GPS location”;
 * calendar = "gregorian" ;
 * units = “seconds since 1970-01-01T00:00:00Z”;
 * _FillValue = -1.0 ;
 * valid_min = 1e9 ;
 * valid_max = 4e9 ;
-* ancillary_variables = “TIME_GPS_QC”;
-* interpolation_methodology = “”;
+* ancillary_variables = “TIME_GPS_QC”
 
  |mandatory
 |============================================================
 
-
-See parameters section for guidance on attributes and conventions on _QC channels.
-
 ////
 * [[trajectory-name]]
 == Trajectory name