trunk/debian/nad2bin.1

'\" t
.TH NAD2BIN 1
.SH NAME 
nad2bin \- convert nad ASCII files into binary format usable by nad2nad
.SH DESCRIPTION

This command is undocumented upstream.  This very rough documentation was
quickly assembled by your friendly Debian maintainer (who doesn't use this
command, and so is not the best person to document it!).

The 
.B proj
package includes the 
.I nad2nad
binary, the North American Datum conversion filter used to convert data
between North America Datum 1927 (NAD27) and North American Datum 1983, and
.I cs2cs
a binary that performs transformation between the source and destination
cartographic coordinate system on a set of input points.  The coordinate
system transformation can include translation between projected and
geographic coordinates as well as the application of datum shifts.

See the
.I nad2nad(1)
and
.I cs2cs(1)
man pages for more information.  

.B nad2nad
and
.B cs2cs 
need arch-dependent conversion data files in a library directory, 
.I /usr/share/proj/
Those files are included in the proj Debian package since 4.6.1-5.
To produce/update them yourself, get the *.lla files from 

.B http://download.osgeo.org/proj/proj-datumgrid-1.4.zip

and then run 
.B nad2bin 
to produce the binary files used by 
.B nad2nad
and
.B cs2cs
like so:

.B # nad2bin < conus.lla /usr/share/proj/conus

Test nad2nad with the following example:

.B $ nad2nad -i 83 -o 27 -r conus << EOF

71d14'58.27"W   44d20'15.227"N

EOF

It should produce: 

71d15'W 44d20'15"N

.SH "SEE ALSO"
.B
nad2nad(1), cs2cs(1)

.SH AUTHOR
This manual page by Peter S Galbraith <psg@debian.org>.
1	frankie	666	'\" t
2			.TH NAD2BIN 1
3			.SH NAME
4			nad2bin \- convert nad ASCII files into binary format usable by nad2nad
5			.SH DESCRIPTION
6
7			This command is undocumented upstream. This very rough documentation was
8			quickly assembled by your friendly Debian maintainer (who doesn't use this
9			command, and so is not the best person to document it!).
10
11			The
12			.B proj
13			package includes the
14			.I nad2nad
15			binary, the North American Datum conversion filter used to convert data
16			between North America Datum 1927 (NAD27) and North American Datum 1983, and
17			.I cs2cs
18			a binary that performs transformation between the source and destination
19			cartographic coordinate system on a set of input points. The coordinate
20			system transformation can include translation between projected and
21			geographic coordinates as well as the application of datum shifts.
22
23			See the
24			.I nad2nad(1)
25			and
26			.I cs2cs(1)
27			man pages for more information.
28
29			.B nad2nad
30			and
31			.B cs2cs
32			need arch-dependent conversion data files in a library directory,
33			.I /usr/share/proj/
34	frankie	2260	Those files are included in the proj Debian package since 4.6.1-5.
35			To produce/update them yourself, get the *.lla files from
36	frankie	666
37	frankie	2260	.B http://download.osgeo.org/proj/proj-datumgrid-1.4.zip
38	frankie	666
39			and then run
40			.B nad2bin
41			to produce the binary files used by
42			.B nad2nad
43			and
44			.B cs2cs
45			like so:
46
47			.B # nad2bin < conus.lla /usr/share/proj/conus
48
49			Test nad2nad with the following example:
50
51			.B $ nad2nad -i 83 -o 27 -r conus << EOF
52
53			71d14'58.27"W 44d20'15.227"N
54
55			EOF
56
57			It should produce:
58
59			71d15'W 44d20'15"N
60
61			.SH "SEE ALSO"
62			.B
63			nad2nad(1), cs2cs(1)
64
65			.SH AUTHOR
66			This manual page by Peter S Galbraith <psg@debian.org>.