nad2nad

NAD2NAD(1)							    NAD2NAD(1)



NAME
       nad2nad - North American Datum conversion filter

SYNOPSIS
       nad2nad [ -eEfihortwW [	args  ]	 ]  [  +args  ]
       file[s]

DESCRIPTION
       Program	nad2nad	 is  a	filter	to convert data
       between North America  Datum  1927  (NAD27)  and
       North  American Datum 1983.  nad2nad can option-
       ally process both State Plane Coordinate	 System
       (SPCS)  and  Universal Transverse Mercator (UTM)
       grid data as well as geographic	data  for  both
       input and output.  This can also be accomplished
       with the cs2cs program.

       The following control parameters can  appear  in
       any order:

       -[i|o] keyword[,keyword]
	      The -i and -o option expect keyword argu-
	      ments which define  various  characteris-
	      tics  and processing modes of the respec-
	      tive input data.	Usage  allows  multiple
	      arguments	 to be included with a - opera-
	      tor when separated by commas.  Datum con-
	      version  requires	 the data to be in geo-
	      graphic  coordinates,  but  nad2nad  will
	      allow conversion of data to and from SPCS
	      or UTM grid systems.  The	 following  are
	      keywords	and arguments reconized by both
	      the -i and -o that will apply to	respec-
	      tive  input and output conversion of user
	      data to internal geographic coordinates:

		 27|83	datum of data

		 utm=n	UTM coordinates in  meters  for
			zone n

		 spcs=n for  data  in SPCS coordinates,
			where n is state zone number.

		 feet	data units  are	 in  U.S.  Sur-
			veyor’s	 feet.	This is allowed
			only when the spcs option  been
			previously used.  Default coor-
			dinates are in meters.

		 bin	for data in binary form.

		 rev	data in	 lat-lon  order	 rather
			than default lon-lat order.

		 hp=ss	use  high  precision conversion
			zone ss.  Certain  States  have
			ancillary  correction tables to
			further refine the basic  conus
			table.	Ss key and States are:
		      FL Florida
		      MD Maryland
		      TN Tennessee
		      WI Wisconsin
		      WO  Washington, Oregon and north-
		      ern part of California.

       -ta    A specifies a character employed	as  the
	      first  character to denote a control line
	      to be passed through without  processing.
	      This  option  applicable	to  ascii input
	      only.  (# is the default value).

       -e string
	      String is an arbitrary string to be  out-
	      put  if  an error is detected during data
	      transformations.	The default  value  is:
	      *\t*.   Note that if the -o bin option is
	      employed, an error is output as  HUGE_VAL
	      for both values.

       -r region
	      specifies which regional conversion table
	      to employ which  are  identified	by  the
	      following:
	    conus - conterminous 48 States
	    alaska - State of Alaska
	    hawaii - State of Hawaii
	    prvi - Puerto Rico and Virgin Islands
	    stgeorge - St. George Is, Alaska
	    stpaul - St. Paul Is, Alaska
	    stlrnc - St. Lawrence Is, Alaska

	    -E	   Input coordinates are echoed to out-
		   put before ouput values.

       -f format
	      Format is a printf format string to  con-
	      trol  the form of the output values.  For
	      inverse projections, the output  will  be
	      in  degrees when this option is employed.
	      If a format is specified for inverse pro-
	      jection  the output data will be in deci-
	      mal degrees.  The default format is  %.2f
	      for   forward   projection  and  DMS  for
	      inverse.

       -[w|W]n
	      N is the number of significant fractional
	      digits to employ for seconds output (when
	      the  option  is  not  specified,	-w3  is
	      assumed).	 When -W is employed the fields
	      will be constant width and  with	leading
	      zeroes.

       One  or	more  files (processed in left to right
       order) specify the source of data to  be	 trans-
       formed.	 A  - will specify the location of pro-
       cessing standard input.	If no files are	 speci-
       fied,  the  input  is  assumed to be from stdin.
       For ASCII input data the two data values must be
       in  the	first  two white space separated fields
       and when both input and	output	are  ASCII  all
       trailing portions of the input line are appended
       to the output line.

       Input geographic data (longitude	 and  latitude)
       must  be in DMS format when neither utm nor spcs
       is specified, otherwise in meters or feet  (feet
       option  used).	Input data fields must be sepa-
       rated by white space and not have imbedded white
       space.

       Output  data  will be in tab separated fields of
       DMS or grid coordinates in meters or feet.

       Any data after the two input values  are	 echoed
       after the two output data values.

SEE ALSO
       cs2cs(1U), proj(1U),
       Cartographic  Projection Procedures for the UNIX
       Environment—A  User’s  Manual,  (Evenden,  1990,
       Open-file report 90-284).

HOME PAGE
       http://www.remotesensing.org/proj



			      2000/03/21 Rel. 4.4		    NAD2NAD(1)

Personal Tools