XD observation format

Common format for observation book. The first thee letters are country specific. It can be defined in control file.

Project information

1 Project name

PRO project

char project[50] project name (to end of line)

2 Job number

JOB job

char job[50] job number / information

3 User

USR user

char user[25] user (to end of line)

4 Date and time

DAT date time

char date[12] date format dd.mm.yy[19.01.1995]

char time[12] time format hh.mm.ss.dd[12:34:58.3,12:34]

5 Version number

VER version program

char version[] version number

char program[] program used to create the file

Instrument

10 Temperature and pressure

ATM temp pres

int temp temperature

int pres pressure

11 Units

UNI dist angle temp pres

enum dist distance unit[m, mm, ]

enum angle angle unit[gon, deg, ]

enum temp temperature unit[C, F, ]

enum pres pressure unit[mbar, kPa, ]

Default values m, gon, C, mbar.

12 Systems

SYS plane height

enum plane plane system

enum height height system

13 Instrument number and name

INS type name

int type instrument type

char name[12] instrument name (DRV-file name)

14 Instrument current settings

INC psm ppm temp pres

double psm prism constant

double ppm ppm-value

int temp temperature

int pres pressure

Station point

20 Station point start and end (orientation block)

ORI nr nro np nf

int nr start:station point reference number running between 1-1000

end:0 (zero)

char nro[8] station point number (code field 4)

int np number of reference points

int nf number of fixed points on first station point

21 Station point

STP code ih

char code[40] codes

double ih instrument height

22 Reference point coordinates

REP code x y z

char code[40] code fields

double x y z coordinates

23 Reference point

RED psm xyz shv is_hz

double psm prism constant

char xyz[4] coordinates used

char hsv[4] observations made(h=HA, v=VA, s=SD)

bool is_hz horizontal / slope(0=slope=default, 1=horizontal)

Prism constant can be different in all directions. XYZ and SHV define, which values will be used in calculation - values can me measured, but they are not used.

24 Reference point observation

REO code ha va sd th

char code[40] codes

double ha horizontal angle

double va vertical angle

double sd slope distance

double th target height

25 Reference point mean value (observations)

REM code ha va sd th n

[like 24]

int n number of half sweeps

Mean value is additional information and shall not be used, if original observations are given. By giving only mean values, these will be used.

26 Height difference

REZ code dz

double dz

Detailed survey

30 Fixed point

FIP code x y z

char code[40] codes

double x y z coordinates

31 Measured point

DEP code x y z

[like 30]

32 Detailed survey

DEO code ha va sd th

[like 24]

33 Eccentricity(given before observation)

DAB a b z

double a a-distance

double b b-distance

double z height difference

34 Eccentricity(given before observation)

DXY x y z

double x x-coordinate

double y y-coordinate

double z z-coordinate

35 Control point (one of the reference points)

CPO code ha va sd th

[like 32]

Azimuth observation

40 Azimuth observation

AZI codes1 dir mdir codes2

char codes1[40] station point codes

double dir direction

double mdir direction mean error

char codes2[40] reference point codes ("optional")

Two cases:

1. Aimed to target, no reference point. Thus codes2 is missing.

2. Aimed to reference point

41 Liitoshavainto atsimuuttipisteeseen

AZO dir

doubledirsuuntakulma

Kaksi tapausta:

1. Mitattu suuntamerkkiin. Käytetään AZO-riviä.

2. Mitattu liitospisteeseen. Käytetään REO-riviä normaalisti.

Vaaitus

45 Vaaituksen aloitus

LES codes type unit

char koodit[40] tunnukset

char type[5] vaaituksen tyyppi[TEET, TETE, TE, dHS]

double unit havaintoyksikkölattahavainto/unit = tulos metreinä

46 Vaaitushavainto

LEO t1 e1 e2 t2 s

double t1,e1,e2,t2 havainnot taakse / eteen

double s kuljettu matka

Formaatti vaaituksen tyypin mukaan

47 Vaaituksen lopetus

LEE codes

char codes[40] endpoint codes

GPS vektorihavainto

50 GPS-vektorin pisteet

GPP codes1 codes2 s

char codes1[40] "from"

char codes2[40] "to"

char* s "session"

51 GPS-vektori

GPO dx dy dz mx my mz c1 c2 c3

double dx dy dz vektorin komponentit

double mx my mz komponenttien keskivirheet

double c1 c2 c3 korrelaatiokertoimet (c1=xy c2=xz c3=yx, vrt. VLM)

52 GPS-vektorin attribuutit

GPA dr havstd ratio lt dt nfx nfl com

char duration mittauksen kesto (kellonaika, ks. PVM)

double havstd vektoritasoituksen keskivirhe

double ratio paras / toiseksi paras ratkaisu (ambiguity resolution)

char lt[6] vaihehavainnon tyyppi (L1,L2,LC,L1+L2,L1-L2)

char dt[7] havaintotekniikka (STATIC,PSEUDO,KINMET,PPDIFF)

int nfx fixed-ratkaisujen lukumäärä

int nfl float-ratkaisujen lkm

char* com kojeen nimi ja ohjelman versio

Kuvakoordinaattihavainto

55 Picture coordinate observation

PCO codes x y (like FIP)

56 Picture data

PID no

char* no picture number

Calculation settings

60 Mean errors

CSM mx my mz

double mx my mz mean errors

Calculation results

61 Orientation factors

EOP ppm

double ppms cale factor(only Helmert)

62 Station point mean error

ESM mt m

double mt error for one direction(2.9 s.14)

double m mean error(2.10 s.14)

63 Reference mean error

ERM code mx my mz c1 c2 c3 max

char code[40] code

double mx my mz mean error

double c1 correlation factor XY

double c2 correlation factor XZ

double c3 correlation factor YZ

double max maximum axis

64 Reference point residuals

ERR code mx my mz

char code[40] codes

double mx my mz mean errors

65 Reference point error (mt)

ERO code mt

char code[40] codes

double mt direction mean error

Others

70 Circle correction

CIC angle

double angle circle correction (added to every DEO)

71 Mean value start

SMS

72 Mean value result (=stops mean value measurement)

SMR code ha va sd th

[like 34]

73 Special function

SXX func n param

int func function number

int n line to be read (or XXX 9 stops)

char* param function dependent parameters

obs func1 skip next n lines

func9 previous XXX-functions stops

func 10-99functions reserved by 3D-system

1 = height measurement

2 = fasad measurement

func100-functions reserved for customers

90 Comment

COM com

charcom[50] free comment

Also agreed

All the lines start with (*), command length totally 5 characters.

Unknown value is replaced by (*), except in code fields.

Code field widths 8, 8, 8, 8, 6, 2.

5. field is quality in form nXYZ, where

int n quality class

char XYZ used coordinates

E.g. 3XYZ, 3X, 3, XYZ, Z, blank, ...

Output formats

observations%10.4lf

coordinates%12.3lf (tai %*.*lf)

integers%5d

real values%*.*lf

charadd +1 for terminating null, e.g. char[40] can have 40 characters

Comment lines and comments :

! comment line, if first in a line

// comment to the end of the line


Example

*ORI 1       1002      2
*ASP                             1002                                         1.510
*LIT 0.000 XYZ HVS
*LIH                        1     227          399.9996  101.3696    58.099   0.500
*LIT 0.000 XYZ HVS
*LIH                        1     227          399.9997  101.3694    58.104   0.500
*KEK 0.0000
*ORI 0
*KAH                1     883       1          399.2300  102.2920    28.010   2.000
*KAH                1     883       1          391.2710  101.2800    24.790   2.000
*KAH                1     883       1          372.2880  100.7315    19.220   2.000
*KAH                1     883       1          326.2685  100.2085    16.440   2.000
*KAH                1     883       1          281.6890   98.3700    24.360   2.000
*KAH                1     883       1          269.7635   97.8580    31.570   2.000
*KAH                2     811       1          268.9480   97.4625    31.180   2.000
*KAH                2     811       1          283.4495   98.2735    22.750   2.000
*KAH                2     811       1          322.0705   99.7125    15.720   2.000
*KAH                2     811       1          373.8135  100.1270    18.600   2.000
*KAH                2     811       1          393.7840  100.4730    24.860   2.000

Special settings

See also: Common special settings