| 1 | = ossim-info = |
| 2 | |
| 3 | ossim-info is a command line application used display metadata for imagery, maps, terrain, and vector data. |
| 4 | |
| 5 | |
| 6 | == Options == |
| 7 | {{{ |
| 8 | --configuration Displays configuration info. |
| 9 | --datums Prints datum list. |
| 10 | --deg2rad Gives radians from degrees. |
| 11 | --disable-elev Will disable the elevation |
| 12 | --disable-notify Takes an argument. Arguments are ALL, WARN, NOTICE, |
| 13 | INFO, FATAL, DEBUG. If you want multiple disables |
| 14 | then just do multiple --disable-notify on the command |
| 15 | line. All argument are case insensitive. Default is |
| 16 | all are enabled. |
| 17 | --disable-plugin Will disable the plugin loader |
| 18 | --dno A generic dump if one is available. This option |
| 19 | ignores overviews. |
| 20 | --factories Prints factory list. |
| 21 | --factory-keyword-list Optional, will output the keyword list from a |
| 22 | saveState on each object |
| 23 | --factory-object object type to instantiate |
| 24 | --factory-type The base class you wish to query. No argument defaults |
| 25 | to all registered type |
| 26 | --ft2mtrs Gives meters from feet (0.3048 meters per foot). |
| 27 | --ft2mtrs-us-survey Gives meters from feet (0.3048006096 meters per foot). |
| 28 | --mtrs2ft Gives feet from meters (0.3048 meters per foot). |
| 29 | --mtrs2ft-us-survey Gives feet from meters (0.3048006096 meters per foot). |
| 30 | --mtrsPerDeg Gives meters per degree and meters per minute for a |
| 31 | given latitude. |
| 32 | --ogeom-format Formats the data to an ossim gemetry file, seperate |
| 33 | files for multi image file formats |
| 34 | --ossim-logfile takes a logfile as an argument. All output messages |
| 35 | are redirected to the specified log file. By default |
| 36 | there is no log file and all messages are enabled. |
| 37 | --palette Will print out the color palette if one exists. |
| 38 | --plugin-test Test plugin passed to option. |
| 39 | --plugins Prints plugin list. |
| 40 | --projections Prints projections. |
| 41 | --rad2deg Gives degrees from radians. |
| 42 | --resampler-filters Prints resampler filter list. |
| 43 | --version Display the version |
| 44 | --writer-props Prints writers and properties. |
| 45 | -K specify individual keywords to add to the preferences |
| 46 | keyword list: name=value |
| 47 | -P specify a preference file to load |
| 48 | -T specify the classes to trace, ex: |
| 49 | ossimInit|ossimImage.* |
| 50 | will trace ossimInit and all ossimImage classes |
| 51 | -V or --version Display version information. |
| 52 | -d A generic dump if one is available. |
| 53 | -f Will output the information specified format [KWL | |
| 54 | XML]. Default is KWL. |
| 55 | -h Display this information |
| 56 | -i Will print out the general image information. |
| 57 | -m Will print out meta data information. |
| 58 | -o Will output the information to the file specified. |
| 59 | Default is to standard out. |
| 60 | -p Will print out the image projection information. |
| 61 | -s Force the ground rect to be the specified datum |
| 62 | -v Overwrite existing geometry. |
| 63 | }}} |
| 64 | |
| 65 | |
| 66 | == Examples == |
| 67 | {{{ |
| 68 | ossim-info --version |
| 69 | ossim-info -i ./myfile.tif |
| 70 | prints out only general image information |
| 71 | |
| 72 | ossim-info -p ./myfile.tif |
| 73 | prints out only image projection information |
| 74 | |
| 75 | ossim-info -p -s wge ./myfile.tif |
| 76 | prints out only image projection information and shifts to wgs84 |
| 77 | |
| 78 | ossim-info -p -i ./myfile.tif |
| 79 | prints out both image and projection information |
| 80 | |
| 81 | ossim-info -p -i ./myfile.tif -o ./myfile.geom |
| 82 | writes geometry file with both image and projection information |
| 83 | |
| 84 | ossim-info -p -i ./myfile.tif -v -o ./myfile.geom |
| 85 | writes geometry file with both image and projection information |
| 86 | while overwriting existing .geom file. |
| 87 | |
| 88 | ossim-info -f XML ./myfile.tif |
| 89 | prints out image and projection information as an XML document |
| 90 | |
| 91 | ossim-info -d myfile.ntf |
| 92 | Dumps all data available, in this case, all nitf tags, from file. |
| 93 | |
| 94 | ossim-info -d a.toc |
| 95 | Dumps all data available, in this case, all nitf and rpf tags, from file. |
| 96 | |
| 97 | ossim-info --dno a.toc |
| 98 | "dno" for "dump no overviws" Dumps all data available, |
| 99 | in this case, all nitf and rpf tags, from file ignoring overviews. |
| 100 | |
| 101 | ossim-info -d -i -p myfile.ntf |
| 102 | Typical usage case, i.e. do a dump of tags and print out image and |
| 103 | projection information. |
| 104 | }}} |