Subversion Repositories lagranto.um

.TH geo2rot
.SH NAME 
.B geo2rot - rotate from true to rotated longitude and latitude
.SH SYNOPSIS
.TP 9 
.B geo2rot
.I [ inpfile outfile ] [optional parameters] 
.TP 9
.B geo2rot
.I [ lon lat ] [optional parameters]
.TP 9
.B geo2rot 
.I [optional parameters]
.SH DESCRIPTION
Rotate the longitude and latitude coordinates from their true geographical values into their values in a rotated coordinate system. The rotation can be done either for a single <lon/lat> point or for a complete trajectory file <inpfile>. In the latter case, a new trajectory <outfile> file with rotated longitude and latitude is written.
.SH PARAMETERS
.TP 15
.I inpfile 
input trajectory file (with true lon/lat)
.TP 15
.I outfile
output trajectory file (with rotated lon/lat)
.TP 15
.I lon lat
true longitude and latitude
.SH OPTIONAL PARAMETERS
.TP 15
.I -lonlat pollon pollat
specify the coordinates (pollon, pollat) of the rotated north pole
.TP 15
.I -file filename
get the coordinates of the rotated north pole from the file <filename>. The file must be a netCDF file, either a constants or a P,S file.
.SH EXAMPLES
.TP 15
.B [1] geo2rot -lonlat -170 45
sets the rotated north pole to 170 W and 45 N. The new position is written to the file <geo2rot.pole>.
.TP 15
.B [2] geo2rot 45 50 
takes coordinate (lon/lat)=(45/50) and rotates it to the rotated coordainte system. The position of the rotated pole is read from the file <geo2rot.pole>.
.TP 15
.B [3] geo2rot 45 50 -file eraint_cst
rotates (lon/lat) = (45/50) to the new system - the new pole position is read from the file <eraint_cst>. 
.TP 15
.B [4] geo2rot trainp traout
read the trajectory file <trainp> and rotate all coordinates. The trajectory file with rotated coordinates is written to <traout>. 
.TP 15
.B [5] geo2rot
write the pole position to screen.
.SH AUTHOR
Written by Michael Sprenger and Heini Wernli (July 2011)