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