.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.46.4.
.TH OSSIM-INFO "1" "December 2015" "ossim-info 1.8.20" "User Commands"
.SH NAME
ossim-info \- ossim-info
.SH SYNOPSIS
.B ossim-info
[\fI\,options\/\fR] \fI\,<optional-image>\/\fR
.SH OPTIONS
.TP
\fB\-\-build\-date\fR
Build date of code.
.TP
\fB\-\-cg\fR
Will print out ground center.
.TP
\fB\-\-ci\fR
Will print out image center.
.TP
\fB\-\-config\fR
Displays configuration info.
.TP
\fB\-\-datums\fR
Prints datum list.
.TP
\fB\-\-deg2rad\fR
<degrees> Gives radians from degrees.
.TP
\fB\-\-disable\-elev\fR
Will disable the elevation
.TP
\fB\-\-disable\-notify\fR
Takes an argument. Arguments are ALL, WARN, NOTICE, INFO,
FATAL, DEBUG.  If you want multiple disables then just do
multiple \fB\-\-disable\-notify\fR on the command line.  All
argument are case insensitive.  Default is all are
enabled.
.TP
\fB\-\-disable\-plugin\fR
Will disable the plugin loader
.TP
\fB\-\-dno\fR
A generic dump if one is available.  This option ignores
overviews.
.TP
\fB\-\-factories\fR
<keyword_list_flag> Prints factory list.  If
keyword_list_flag is true, the result of a saveState will
be output for each object.
.TP
\fB\-\-ft2mtrs\fR
<feet> Gives meters from feet (0.3048 meters per foot).
.TP
\fB\-\-ft2mtrs\-us\-survey\fR
<feet> Gives meters from feet (0.3048006096 meters per
foot).
.TP
\fB\-\-height\fR
<latitude\-in\-degrees> <longitude\-in\-degrees> Returns the
MSL and ellipoid height given a latitude longitude
position.
.TP
\fB\-\-mtrs2ft\fR
<meters> Gives feet from meters (0.3048 meters per foot).
.TP
\fB\-\-mtrs2ft\-us\-survey\fR
<meters> Gives feet from meters (0.3048006096 meters per
foot).
.TP
\fB\-\-mtrsPerDeg\fR
<latitude> Gives meters per degree and meters per minute
for a given latitude.
.TP
\fB\-\-ossim\-logfile\fR
takes a logfile as an argument.  All output messages are
redirected to the specified log file.  By default there
is no log file and all messages are enabled.
.TP
\fB\-\-overview\-types\fR
Prints overview builder types.
.TP
\fB\-\-palette\fR
Will print out the color palette if one exists.
.TP
\fB\-\-plugin\-test\fR
Test plugin passed to option.
.TP
\fB\-\-plugins\fR
Prints plugin list.
.TP
\fB\-\-projections\fR
Prints projections.
.TP
\fB\-\-rad2deg\fR
<radians> Gives degrees from radians.
.TP
\fB\-\-reader\-props\fR
Prints readers and properties.
.TP
\fB\-\-resampler\-filters\fR
Prints resampler filter list.
.TP
\fB\-\-revision\-number\fR
Revision number of code.
.TP
\fB\-\-writer\-props\fR
Prints writers and properties.
.TP
\fB\-\-writers\fR
Prints list of available writers.
.TP
\fB\-\-zoom\-level\-gsds\fR
Prints zoom level gsds for projections EPSG:4326 and
EPSG:3857.
.TP
\fB\-K\fR
specify individual keywords to add to the preferences
keyword list: name=value
.TP
\fB\-P\fR
specify a preference file to load
.TP
\fB\-T\fR
specify the classes to trace, ex: ossimInit|ossimImage.*
will trace ossimInit and all ossimImage classes
.TP
\fB\-V\fR or \fB\-\-vesion\fR
Version of code, e.g. 1.8.20
.TP
\fB\-c\fR
Will print ground and image center.
.TP
\fB\-d\fR
A generic dump if one is available.
.TP
\fB\-f\fR
<format> Will output the information specified format
[KWL | XML].  Default is KWL.
.TP
\fB\-h\fR
Display this information
.TP
\fB\-i\fR
Will print out the general image information.
.TP
\fB\-m\fR
Will print out meta data image information.
.TP
\fB\-n\fR or \fB\-\-north\-up\fR
Rotation angle to North for an image.
.TP
\fB\-o\fR
<output\-file> Will output the information to the file
specified.  Default is to standard out.
.TP
\fB\-p\fR
Will print out the image projection information.
.TP
\fB\-r\fR
Will print image rectangle.
.TP
\fB\-s\fR
Force the ground rect to be the specified datum
.TP
\fB\-u\fR or \fB\-\-up\-is\-up\fR
Rotation angle to "up is up" for an image.
Will return 0 if image's projection is not affected by
elevation.
.TP
\fB\-v\fR
Overwrite existing geometry.
.IP
examples:
.IP
ossim\-info \fB\-\-version\fR
ossim\-info \fB\-i\fR ./myfile.tif
.IP
prints out only general image information
.IP
ossim\-info \fB\-p\fR ./myfile.tif
.IP
prints out only image projection information
.IP
ossim\-info \fB\-p\fR \fB\-s\fR wge ./myfile.tif
.IP
prints out only image projection information and shifts to wgs84
.IP
ossim\-info \fB\-p\fR \fB\-i\fR ./myfile.tif
.IP
prints out both image and projection information
.IP
ossim\-info \fB\-p\fR \fB\-i\fR ./myfile.tif \fB\-o\fR ./myfile.geom
.IP
writes geometry file with both image and projection information
.IP
ossim\-info \fB\-p\fR \fB\-i\fR ./myfile.tif \fB\-v\fR \fB\-o\fR ./myfile.geom
.IP
writes geometry file with both image and projection information
while overwriting existing .geom file.
.IP
ossim\-info \fB\-f\fR XML ./myfile.tif
.IP
prints out image and projection information as an XML document
.IP
ossim\-info \fB\-d\fR myfile.ntf
.IP
Dumps all data available, in this case, all nitf tags, from file.
.IP
ossim\-info \fB\-d\fR a.toc
.IP
Dumps all data available, in this case, all nitf and rpf tags, from file.
.IP
ossim\-info \fB\-\-dno\fR a.toc
.IP
"dno" for "dump no overviews" Dumps all data available,
.IP
in this case, all nitf and rpf tags, from file ignoring overviews.
.IP
ossim\-info \fB\-d\fR \fB\-i\fR \fB\-p\fR myfile.ntf
.IP
Typical usage case, i.e. do a dump of tags and print out image and
projection information.
.SH "SEE ALSO"
The full documentation for
.B ossim-info
is maintained as a Texinfo manual.  If the
.B info
and
.B ossim-info
programs are properly installed at your site, the command
.IP
.B info ossim-info
.PP
should give you access to the complete manual.