NRCan’s BYN Format

BYN is a binary format for gridded data with regular spacing

Table 1: Header description (80 bytes)

# Description Type Byte Sum Comments/(Units)

1 South Boundary long int 4 4 (arcsec.)
2 North Boundary long int 4 8 (arcsec.)
3 West Boundary long int 4 12 (arcsec.)
4 East Boundary long int 4 16 (arcsec.)
5 NS Spacing long int 2 18 (arcsec.)
6 EW Spacing short int 2 20 (arcsec.)
7 Global short int 2 22 0: Local/Regional/National grid
1: Global grid
8 Type short int 2 24 0: Undefined
1: Ellipsoid-potential separation (m)
2: Deflection NS (arcsec.)
3: Deflection EW (arcsec.)
4: Gravity (mGal)
5: DEM (m)
6: SSH (m)
7: SST (m)
8: Ocean current velocity (m/s)
9: Others
9 Factor double 8 32 Transform data from integer to real
10 SizeOf( data ) short int 2 34 2: short integer
4: long integer
11 Spare 6 40 Always zero
12 Data description short int 2 42 0: Data (e.g., N)
1: Data error estimates (e.g., σN)
2: Data velocity (e.g., N-dot)
3: Velocity error estimates (e.g., σN-dot)
13 Sub-Type short int 2 44 See table 2 below
14 3-D Ref. Frame short int 2 46 0: ITRF / WGS84
1: NAD83(CSRS)
15 Ellipsoid short int 2 48 0: GRS80
1: WGS84
16 Byte Order short int 2 50 0: Big-endian (e.g., HP Unix)
1: Little-endian (e.g., PC, linux)
17 Scale short int 2 52 0: No scale applied to boundaries and
Boundaries spacing
1: Scale is applied (x1000)
18 Geopotential W double 8 60 m2 s-2 (e.g., W = 62636856.88)
19 GM double 8 68 m3 s-2 (e.g., GM = 3.986 x 1014)
20 Tidal System short 2 70 0: Tide free
1: Mean tide
2: Zero tide
21 Realization (3D) short int 2 72 Version number (e.g., 2005 for ITRF)
22 Epoch float 4 76 Decimal year (e.g., 2007.5)
23 Node short int 2 78 0: Point
1: Mean
24 Spares 2 80 Always zero

Items #18 to 22 must be defined if the grid is a geoid model.

Table 2: Sub-Type

# Type (item #8) # Sub-Type (item #13)

0 Undefined 0 NULL
1 Ellipsoid-Potential separation 0 Geoid Height
1 Height Anomaly
2 Deflections of the vertical NS 0 NULL
3 Deflections of the vertical EW 0 NULL
4 Gravity 0 Undefined
1 Absolute (m/s-2 instead of mGal)
2 Free-Air
3 Bouguer
4 Complete Bouguer
5 Helmert
6 Isostatic
5 DEM 0 MSL (General)
1 Orthometric
2 Normal
3 Dynamic
4 Ellipsoidal
6 Sea Surface Height (SSH) 0 NULL
7 Sea Surface Topography (SST) 0 NULL
8 Ocean current velocity 0 NULL
9 Others 0 NULL
Data (Row x Column x byte size)

The data are stored by rows starting from the north. Each row is stored from the west to
the east. The data are either short (2 bytes) or long (4 bytes) integer. The size of the
bytes is defined in the header (item #10).

The total size of the file is 80 bytes + (Row x Column x (2 or 4) bytes)

where

Row = (North – South)/NS spacing + 1 and

Column = (East – West)/EW spacing + 1

Undefined values

Long int (4-byte data): 9999.0*Factor

Short int (2 byte data): 32767
 Le format BYN de RNCan
BYN est un format binaire pour les données de quadrillage
avec espacement régulier

Table 1: Description de l’en-tête (80 octets)

# Description Type Octet Tot. Commentaires/(Unités)

1 Limite sud long 4 4 (sec. d’arc)
2 Limite nord long 4 8 (sec. d’arc)
3 Limite ouest long 4 12 (sec. d’arc)
4 Limite est long 4 16 (sec. d’arc)
5 Espacement NS long 2 18 (sec. d’arc)
6 Espacement EO court 2 20 (sec. d’arc)
7 Globe court 2 22 0: Quadrillage local/Régional/National
1: Quadrillage mondial
8 Type court 2 24 0: Non-défini
1: Séparation ellipsoïde-potentielle (m)
2: Déviation NS (sec. d’arc)
3: Déviation EO (sec. d’arc)
4: Gravité (mGal)
5: MNE (m)
6: ASO (m)
7: TSO (m)
8: Vélocité des courants marins (m/s)
9: Autres
9 Facteur double 8 32 Transformation d’integer à réel
10 Dimension court 2 34 2: Entier court (2 octets)
4: Entier long (4 octets)
11 Extra 6 40 Toujours zéro
12 Description court 2 42 0: Données (e.g., N)
1: Estimé d’erreur (e.g., σN)
2: Données de vélocité (e.g., N-dot)
3: Erreur de vélocité (e.g., σN-dot)
13 Sous-type court 2 44 Voir table 2 ici-bas
14 Cadre de réf. court 2 46 0: ITRF / WGS84
1: NAD83(CSRS)
15 Ellipsoïde court 2 48 0: GRS80
1: WGS84
16 Ordre des octets court 2 50 0: Big-endian (e.g., Unix)
1: Little-endian (e.g., PC, linux)
17 Échelle court 2 52 0: Pas de facteur échelle appliqué aux
limites et aux espacements
 1: Facteur échelle appliqué (x1000)
18 Géopotentiel W double 8 60 m2 s-2 (e.g., W = 62636856.88)
19 GM double 8 68 m3 s-2 (e.g., 3.986 x 1014)
20 Système de court 2 70 0: Marée libre
marée
1: Marée moyenne
2: Zéro de marée
21 Réalisation (3D) court 2 72 Numéro de la version (e.g., 2005 for
ITRF)
22 Époque float 4 76 Année décimale (e.g., 2007.5)
23 Quadrillage court 2 78 0: Point
1: Moyenne
24 Extra 2 80 Toujours zéro

Items #18 to 22 must be defined if the grid is a geoid model.

Table 2: Sub-Type

# Type (item #8) # Sous-type (item #13)

0 Non-défini 0 Nulle
1 Séparation ellipsoïde-potentielle 0 Ondulation du géoïde
1 Anomalie d’altitude
2 Déviation de la verticale NS 0 Nulle
3 Déviation de la verticale EO 0 Nulle
4 Gravité 0 Non-défini
1 Absolue (m/s/s au lieu de mGal)
2 Air-libre
3 Bouguer
4 Bouguer raffiné
5 Helmert
6 Isostatique
5 DEM 0 NMM (Général)
1 Orthométrique
2 Normale
3 Dynamique
4 Ellipsoïdale
6 Altitude de la surface de l’océan (ASO) 0 Nulle
7 Topographie de la surf. de l’océan 0 Nulle
(TSO)
8 Vélocité des courants marins 0 Nulle
9 Autres 0 Nulle
Données (Rangées x Colonnes x dimension des octets)

Les données sont emmagasinées en rangée à partir du nord. Chaque rangée est
emmagasinée de l’ouest à l’est. Les données sont soit des entiers courts (2 octets) ou des
entiers longs (4 octets). La dimension des octets est définie dans l’en-tête du fichier
binaire (item #10).

La dimension totale du fichier est de 80 octets + (Rangées x Colonnes x (2 ou 4) octets)

où

Rangées = (Nord – Sud)/Espacement NS + 1 et

Colonnes = (Est – Ouest)/Espacement EO + 1

Données non-définies

Entier long (4 octets): 9999.0*Facteur

Entier court (2 octets): 32767