Définition de l’en-tête format des marées et des courants (TCF)
Le format des marées et des courants (TCF header) est un format interne utilisé dans l'application servant à mesurer les marées et les courants dans les régions. Cette application appelée Outils pour les marées, courants et niveaux d'eau (MCNE), est le logiciel de sondage qui permet de créer des prévisions de marées. Les régions, entre autres, utilisent le format de fichier TCF Header pour partager les composantes harmoniques et les prévisions des marées (les extrêmes et les 15 minutes).
Le Service hydrographique du Canada utilise également ce format lorsqu'il fait parvenir des observations mensuelles sur le niveau des eaux au Service des données sur le milieu marin de la région du Pacifique. Le nouveau système de niveau d’eau utilisera ce format, qui est aussi employé pour les données sur les composantes des niveaux d’eau.
L'en-tête peut comprendre des renseignements au sujet de l'élément de référence et de toutes modifications apportées aux données.
Série chronologique du niveau d’eau
La date et les heures doivent être :
- en ordre séquentiel
- séparées par un intervalle fixe, qui correspond à ce qui est enregistré dans l'en-tête
Les hauteurs fixes enregistrées doivent porter la valeur de 999.999.
Le format de description générique est le aaaa/mm/jj hh :mm xxx.xxx. Dans ce format :
- aaaa représente les 4 chiffres de l'année
- mm représente les 2 chiffres indiquant le mois (par exemple, le chiffre 1 représente le mois de janvier)
- jj représente les 2 chiffres du jour
- hh représente l'heure, selon une horloge de 24 heures
- mm représente les minutes
- xxx.xxx représente la hauteur en mètres
Exemple
Vous trouverez ci-dessous un exemple d'en-tête TCF.
TCF Header version 2
''''/''''1''''/''''2''''/''''3''''/''''4''''/''''5''''/''''6''''/''''7''''/''''
DataType....... Index GeographicalName.................... DpthIm YYYY/MM/DD||
SOb/Pr/Com DD MM.MMMMN DDD MM.MMMMW PstnkmA FixMethod..... +TZ.. hhmm:ss ||
NumbRec... ####days ###.#% T TimeComments........................ hhmm:ss Ch||
Scientist............. ProjectID............. CruiseID.. IDAcA WDAcA DpthWm||
FreeFieldForTemporaryStorage............................................. VCL||
hhmm:ss Cut.Offday Offs.ettdbp1 Fld Ebb HorDat VertlDatum Bm_Name... BmElevmm||
01 Parameter Descriptor Accry Qulty #A 07 Parameter Descriptor Accry Qulty #A||
02 .................... ..... ..... .. 08 .................... ..... ..... ..||
03 .................... ..... ..... .. 09 .................... ..... ..... ..||
04 .................... ..... ..... .. 10 .................... ..... ..... ..||
05 .................... ..... ..... .. 11 .................... ..... ..... ..||
06 .................... ..... ..... .. 12 .................... ..... ..... ..||
Agency................... Platform................. InstrumentType....Serial#||
FileName................. ProcessingFileName....... ParentFile...............||
Comments.....................................................................||
.............................................................................||
.............................................................................||
.............................................................................||
.............................................................................||
.............................................................................||
.............................................................................||
.............................................................................||
.............................................................................||
.............................................................................||
''''/''''1''''/''''2''''/''''3''''/''''4''''/''''5''''/''''6''''/''''7''''/''''
The following is full description of the format
by line number:
field position,field length : definition.
If field position is not defined it is to be left blank.
Line 1:
col 01-15 15 : Type of data [See standard list]
[File may contain other parameters]
17-21 5 : Station ID or Index number [no blanks]
23-58 36 : Geographical name [may include parenthetical remarks, ie (xxx)]
61-65 5 : Depth of instrument below chart datum [no blanks]
66-66 1 : Units of depth [m:metres, f:feet]
68-71 4 : Date (Year) of first data record
72-72 1 : '/'
73-74 2 : Date (Month) of first data record
75-75 1 : '/'
76-77 2 : Date (Day) of first data record
Line 2:
col 01-01 1 : Archive status !:CHS is primary archivist
&:CHS is secondary archivist,
primary archive elsewhere
?:Unknown
02-10 9 : 'Observed ', 'Predicted' or 'Computed '
14-15 2 : Latitude (Degrees)
17-23 7 : Latitude (Minutes up to 4 places of decimal)
24-24 1 : 'N' or 'S'
26-28 3 : Longitude (Degrees)
30-36 7 : Longitude (Minutes up to 4 places of decimal)
37-37 1 : 'W' or 'E'
39-42 4 : Position accuracy
43-44 2 : Position accuracy units (m, km, etc)
45-45 1 : Position quality flag
47-60 14 : Fix method,eg GPS, DGPS, Radar Range, etc
62-66 5 : Time Zone [# of hours to add to determine UTC]
[always include + or -]
[always left justify,
then there is space for Nfld time. ie +03.5]
68-69 2 : Time (Hour) of first data record
70-71 2 : Time (Minute) of first data record
72-72 1 : ':'
73-74 2 : Time (Second) of first data record
Line 3:
col 01-10 10 : Number of Records to follow header
12-15 4 : Elapsed time in days
16-19 4 : 'days'
21-25 5 : Percentage of primary data (DataType) not padded with nulls.
Any parameter can be padded to account for missing or poor data.
The padded value depends upon the file format, where
Null = 9999999999 for ASCII data
Null = 32767 for 16 bit binary [(2**15)-1]
Null = 2147483647 for 32 bit binary [(2**31)-1]
26-26 1 : '%'
28-28 1 : Time Flag [See standard list]
30-65 36 : Time Comments [See standard list for suggestions]
If time accuracy is needed then the time accuracy is written
at the end of the time comments. The time accuracy must be
preceded by a sign (- or +) to be recognized. The units of
time accuracy will be seconds/day with at least one decimal
place, ie +1.0 is 1 second/day.
68-69 2 : Sampling interval (Hours)
70-71 2 : Sampling interval (Minutes)
72:72 1 : ':'
73-74 2 : Sampling interval (Seconds)
76-77 2 : Number of Parameters in a record [up to 12]
Line 4:
01-22 22 : Name of scientist [See standard list]
24-45 22 : Project ID [See standard list]
47-56 10 : Cruise ID [See list of suggested entries]
59-62 4 : Instrument Depth accuracy number, real number with moving decimal
always in units of the depth
63-63 1 : Instrument Depth accuracy code
66-69 4 : Water Depth accuracy number, real number with moving decimal
always in units of the depth
70-70 1 : Water Depth accuracy code
72-76 5 : Depth of water below chart datum [no blanks]
77-77 1 : Units of depth [m:metres, f:feet]
Line 5:
01-73 70 : Free field for program scratch or temporary storage (see below
for information of use of scratch area by tide and current table
software)
75-77 3 : Number of variable comments lines added. Variable comments
lines are still 77 characters long with || at the end.
Maximum number of variable comment lines is 999.
Line 6:
Col 01-07 7 : Sampling interval of original measurements before subsampling/
interpolation.
09-15 7 : Cut-off for the filter, with decimals possible
16-18 3 : Units of the cut-off: yr, day, hr, min, sec
20-27 8 : Offset (this includes the usual pressure gauge
Removed Mean) - format is ddd.ddd.
28-29 2 : Offset units, usually db (dbars)
30-31 2 : Parameter offset is from.
33-35 3 : Flood direction(deg. T)
37-39 3 : Ebb direction(deg. T)
41-46 6 : Horizontal Datum, eg NAD-83
48-57 10 : Vertical Datum, eg GVSD91
59-68 10 : Bench Mark Name
70-75 6 : Bench Mark Elevation
76-77 2 : Units of BM Elevation [mm:millimetres,hf:ft*100]
Line 7 to Line 12:
01-02 2 : Parameter Number
40-41 2 : " "
04-23 20 : Parameter Descriptors [See standard list]
43-62 20 : " " " "
25-29 5 : Parameter Accuracy [uncertainty, using same number
64-68 5 : " " of decimal places as in c37 or c76]
31-35 5 : Flags to describe parameter quality, degree of editing,
and if applicable type of datum and filters applied.
70-74 5 : Same flags as c31-c35 [See standard list]
37-37 1 : Number of decimal places or 'T' if text
76-76 1 : " " " " " " " "
38-38 1 : Data Format where A = ASCII [10 bytes/parameter]
77-77 1 : " "
[The following are S = (16 bits Integer Binary)
for internal use, L = (32 bits Integer Binary)
that is, not for V = (16 bits VAX Int Binary)
interchange X = (32 bits VAX Int Binary)]
Line 13:
01-25 25 : Data set Agency [See standard list]
27-51 25 : Platform used for measurements [See standard list]
53-70 18 : Instrument Type [See standard list]
71-77 7 : Instrument Serial Number
Line 14:
01-25 25 : File Name [Name of present file with extension]
27-51 25 : Processing File Name [Log file,could be paper]
53-77 25 : Parent File Name [Source file name with extension]
Line 15 to Line 24:
01-77 77 : Comments
Line 25 to Line ???
01-77 77 : Variable length Comments - each line must be a full line
with a maximum of 999 lines.
Note: All header lines are terminated by '||' and an End-of-Line character(s).
This means each header line has a length of 79 characters plus EOL
character(s).
If data format is ASCII the record length will be 10 bytes * number of
parameters plus end of line.
If data format is binary the record length will be 2 or 4 bytes * number
of parameters and no end of line.
The scratch field is used in various programs. See later documentation
for specific format definitions.
The Tide and Current table software makes use of the free area (scratch field)
to hold specific information with a specific format. This definition is described
below.
''''/''''1''''/''''2''''/''''3''''/''''4''''/''''5''''/''''6''''/''''7''''/''''
DataType....... Index GeographicalName.................... DpthIm YYYY/MM/DD||
SOb/Pr/Com DD MM.MMMMN DDD MM.MMMMW PstnkmA FixMethod..... +TZ.. hhmm:ss ||
NumbRec... ####days ###.#% T TimeComments........................ hhmm:ss Ch||
Scientist............. ProjectID............. CruiseID.. IDAcA WDAcA DpthWm||
PrdctType vx.x pgn SpdT mi.n ma.x dh tmx VCL||
hhmm:ss Cut.Offday Offs.ettdbp1 Fld Ebb HorDat VertlDatum Bm_Name... BmElevmm||
Explanation:
vx.x - version number of the data. Where each x is a number.
SpFn - speed type of station (i.e. FAST or NORM ) or Foot note number (
i.e. FTN1 which is the foot note for Grondines)
pgn - page number of the first page this data will appear on in the tide
table
PrdctType - type of prediction - either Reference, Secondary, or Other
tmx - max time span of a series of 3 small changes in minutes
mi.n - minimum waterlevel value (in metres) for the calendar plots
ma.x - maximum waterlevel value (in metres) for the calendar plots
(max - min must be divisible with one decimal place by 5,
ie 6 - 0 works, 6 - 0.25 will not work).
dh -
Water levels xx amplitiude of a small change in cm (ie less than
99 cm) in automatic editing
Currents do not use central time in calculation in
automatic editing
Currents CT use central time calculation in automatic
editing and make it marked for attention
Currents CF use central time calculation in automatic
editing and make it active
Maximum and minimum waterlevel values
used in the Tide and Current Tables
Volume Minimim Maximum
2 0.0 2.0
5 0.0 4.0
6 0.0 6.0