GISEYE Image Transformer

Application purpose
The application has the following advantages:
- Support of over 70 map projections
- Support of popular input data formats and output data storage formats
- A wide range of image transformation parameters
- Possibility to specify resolution or output raster size as well as data types
- Possibility to transform the specified image fragment
- Possibility to create image mosaics
- Image transformation control
- Batch image transformation
System requirements
-
Microsoft Windows 2000/XP/Vista or higher
- Intel Pentium-III processor or higher
- 128Mb of RAM
- Display mode 1024×768 TrueColor
GISEYE Image Transformer dialog (Fig. 1) includes elements to specify input files and their projections and groups of elements to specify image parameters.
Buttons, located below the control elements to specify output images parameters open dialogs, designed for specifying special parameters of image transformations and different additional options.
The dialog also contains a set of function buttons to start image transformation and to save the application activities log, as well as the window with the output data, where the information about the transformation process is displayed.
Control elements to specify input files and their projections
Input Files list is refilled with files that will be transformed during the program operation. To add a file into the list, press «Add» button and select the file form the folder of interest using standard file selection dialog.
To delete a raster file from the list, select the required file by clicking with the left mouse button and then pressing «Remove» button.
For successful transformation of images, represented in formats, not saving the data about the projection parameters or if the projection of the image of interest is specified incorrectly, the source projection parameters have to be specified manually. To do so, check Source Projection box thus making the projection setup field active, where PROJ4 projection should be entered. You may use “…” button, located to the right of the projection entry field, to set up projection parameters. This button opens projection definition dialog (Fig.2).

Fig. 2 Define Projection dialog to set up projection
Control elements to set up image transformation parameters.
Prior to setting up image transformation parameters, the user needs to select the transformation type with the help of radio-buttons:
To transform the image into the specified projection, activate File to File Reprojection radio-button.
To create mosaic from the selected images, activate Files to Mosaic Reprojection radio-button.
Output Folder check mark makes the folder setup field active, where output files will be saved. The path to the folder of interest can be specified manually or using «…» button, which opens the standard folder selection dialog.
The user may select the output image format in File Format drop down list box.
Additional parameters and options are available for a number of formats. Press « … » button, located to the right of the drop-down list, to get access to these options. Format Options dialog will open (Fig.3). Parameters, available for the selected format, are represented in table, where the parameter name and one of its values are indicated, which can be selected from the drop-down list or entered manually. The parameter of interest should be checked in the dialog and then the required parameter value should be selected from the drop-down list to the right of the checkbox. For parameters, not having a fixed value, a field will become active to specify a value manually after checking.

Fig. 3 Format Options dialog
In If Exists drop-down list the user needs to select one of the types of saving output file, if in the specified output folder the file with this name already exists. This drop-down list is available only for creation of mosaics from images.
If Overwrite value is selected, the output file will completely replace the file with the similar name.
If Append value is selected, the output image will be added to the existing file.
If images are transformed without creation of mosaics, the Overwrite value is defaulted.
Output Projection checkmark enables image output projection field. Press “…” button to specify projection parameters and set up the projection of interest in the appearing dialog. Press OK to confirm.
In Raster Parameters group of elements the user may specify different parameters of output image: image fragment borders, size and extension, type of image, pixel digital numbers for image regions, not containing any data.
Georeference Extents checkmark enables fields to specify borders of the fragment being cropped for output image. In X Min, X Max, Y Min, Y Max fields the user needs to set up map coordinates in meters of the image fragment of interest, transformed into the output projection.
Output Resolution checkmark enables the fields to set up output image resolution in X and Y axis in meters.
Output File Size checkmark enables the entry fields to specify width and height of the image in pixels, in which the user needs to set up Width and Height values.
Output File Size and Output Resolution options operate in switching mode, i.e. they cannot be enabled simultaneously.
Output Data Type checkmark enables the drop-down list, where the user can select the type of output data according to the previously selected image format.
Working Data Type checkmark enables the drop-down list, where the user can select the type of data that will be used during image transformation, according to the previously selected image format.
Resampling Method checkmark enables the drop-down list, where the user needs to select one of the image smoothing types during transformation.
Source Nodata checkmark enables the pixel digital number entry fields for input images channels, which during the image transformation will be regarded as the no-data one.
Output Nodata checkmark enables the pixel digital number entry fields for output images channels, which during the image transformation will be regarded as the no-data one.
Specific parameters of image transformation and additional options are combined into purpose groups. To preview and set up additional options, press on the corresponding button. After setting up the required parameters, press OK. To close the dialog without saving the changes press Cancel.
Geolocation Options button opens the dialog (Fig.4), where the user may set up parameters of geographical image transformation. To set up parameter of interest, check it first and specify the values manually or via the drop-down list, where required.

Fig.4 Geolocation Options dialog
Transformer Options button opens the dialog (Fig. 5), where the user can set up additional parameters of image transformation from one projection into another. To set up the parameter of interest, check the corresponding mark and specify the parameter value manually or via the drop-down list. Input and output projections setup elements are similar to those in main dialog window of GISEYE Image Transformer application.

Fig. 5 Transformer Options dialog
Warp Options button opens the dialog (Fig. 6), where the user may specify additional options of geometrical image transformation. To specify an option of interest, check the box and then set up the value of the selected option manually or via the drop-down list.

Fig. 6 Warp Options dialog
Cutline Options button opens dialog (Fig. 7), where the user may specify parameters of the image fragment that is setup as a vector file. To specify a parameter of interest, check the corresponding box and set up the parameter value manually.

Fig. 7 Cutline Options dialog
Performance Options button opens dialog (Fig. 8), where the user may specify the size of PC memory used thus controlling the image transformation rate. To set up a parameter of interest, check the respective box and then specify the parameter value manually.

Fig. 8 Performance Options dialog
Processing startup, control and termination
To startup the image transformation process, press « Start » button, located under Output field. All application fields will become disabled and a command prompt of gdalwarp.exe program, transformation process status and successful completion or error messages will be displayed in the output data window. “Stop” button is enabled while the program is running to allow the user to terminate the process.
Upon completion of the operation files with the names of input files are created in the output folder with suffix _OUT at the end and the index number of the image, corresponding to the number of the source raster in Input Files list.
To save the contents of the output data window, press «Save Output», located under Output field. A standard file save dialog will appear.
GISEYE Image Transformer can be closed using « Close » button or the standard window close button in upper right corner of the dialog. After closing the application, values of all parameters are saved to ini file, located in application installation folder.
Additional
Below is the list of formats, supported by GISEYE Image Transformer application
| Long Name | Abbreviation | |
| Virtual Raster | VRT | |
| GeoTIFF | GTiff | |
| National Imagery Transmission Format | NITF | |
| Erdas Imagine Images (.img) | HFA | |
| ELAS | ELAS | |
| MS Windows Device Independent Bitmap | BMP | |
| PCIDSK Database File | PCIDSK | |
| ILWIS Raster Map | ILWIS | |
| SGI Image File Format 1.0 | SGI | |
| Raster Matrix Format | RMF | |
| Idrisi Raster A.1 | RST | |
| Intergraph Raster | INGR | |
| ENVI .hdr Labelled | ENVI | |
| ESRI .hdr Labelled | ESRI | |
| PCI .aux Labelled | PAux | |
| Vexcel MFF2 (HKV) Raster | MFF2 | |
| VTP .bt (Binary Terrain) 1.3 Format | BT | |
| Image Data and Analysis | IDA |
GISEYE Image Transformer application is a graphical shell for gdalwarp.exe console program and parameters, represented in the dialog, correspond to gdalwarp.exe program parameters. However, it should be noted that transformation parameters may take on different values depending on the selected output data format, projection, etc.
Messages appearing in the output data field are good indicators of possible transformation parameters compatibility problems and of their values accuracy. More information about the parameters values is available at GDAL web-site:http://www.gdal.org/gdalwarp.html
Information about formats, supported by gdalwarp.exe program, as well as information about the values of additional formats parameters is available at GDAL web-site: http://www.gdal.org/formats_list.html


