SAGA 9.3.3 | Tool Library Documentation

Export Image (bmp, jpg, pcx, png, tif)


Description

With this tool you can save a grid to an image file. Optionally, a shade grid can be overlayed using the specified transparency and brightness adjustment.


Parameters

 NameTypeIdentifierDescriptionConstraints
InputGridgrid, inputGRID--
Shadegrid, input, optionalSHADE--
OptionsGrid Systemgrid systemPARAMETERS_GRID_SYSTEM--
Image Filefile pathFILE--
Create World FilebooleanFILE_WORLDStore georeference along image to an additional file.Default: 1
Create KML FilebooleanFILE_KMLExpects that the input grid uses geographic coordinates.Default: 0
Set Transparency for No-DatabooleanNO_DATA-Default: 1
ColoringchoiceCOLOURING-Available Choices: [0] histogram stretch to standard deviation [1] histogram stretch to percentage range [2] histogram stretch to value range [3] lookup table [4] rgb coded values [5] same as in graphical user interface Default: 5
Colors PalettecolorsCOL_PALETTE--
Graduated ColorsbooleanGRADUATED-Default: 1
Standard Deviationfloating point numberSTDDEV-Minimum: 0.000000 Default: 2.000000
Percentage Rangevalue rangeLINEAR--
Value Rangevalue rangeSTRETCH--
ScalingchoiceSCALE_MODEScaling applied to coloring choices (i) grid's standard deviation, (ii) grid's value range, (iii) specified value rangeAvailable Choices: [0] linear intervals [1] increasing geometrical intervals [2] decreasing geometrical intervals Default: 0
Geometrical Interval Factorfloating point numberSCALE_LOG-Minimum: 0.001000 Default: 10.000000
Lookup Tablestatic tableLUT-5 Fields: - 1. [color] Color - 2. [string] Name - 3. [string] Description - 4. [8 byte floating point number] Minimum - 5. [8 byte floating point number] Maximum
Transparencyfloating point numberSHADE_TRANSThe transparency of the shade [%]Minimum: 0.000000 Maximum: 100.000000 Default: 75.000000
Histogram StretchchoiceSHADE_COLOURING-Available Choices: [0] Linear [1] Standard Deviation Default: 0
Linearvalue rangeSHADE_BRIGHTMinimum and maximum [%], the range for histogram stretch.-
Standard Deviationfloating point numberSHADE_STDDEV-Minimum: 0.000000 Default: 2.000000

Command Line


Usage: saga_cmd io_grid_image 0 [-GRID ] [-SHADE ] [-FILE ] [-FILE_WORLD ] [-FILE_KML ] [-NO_DATA ] [-COLOURING ] [-COL_PALETTE ] [-GRADUATED ] [-STDDEV ] [-LINEAR_MIN ] [-LINEAR_MAX ] [-STRETCH_MIN ] [-STRETCH_MAX ] [-SCALE_MODE ] [-SCALE_LOG ] [-LUT ] [-SHADE_TRANS ] [-SHADE_COLOURING ] [-SHADE_BRIGHT_MIN ] [-SHADE_BRIGHT_MAX ] [-SHADE_STDDEV ]
  -GRID:               	Grid
	grid, input
  -SHADE:              	Shade
	grid, input, optional
  -FILE:               	Image File
	file path
  -FILE_WORLD:         	Create World File
	boolean
	Default: 1
  -FILE_KML:           	Create KML File
	boolean
	Default: 0
  -NO_DATA:            	Set Transparency for No-Data
	boolean
	Default: 1
  -COLOURING:          	Coloring
	choice
	Available Choices:
	[0] histogram stretch to standard deviation
	[1] histogram stretch to percentage range
	[2] histogram stretch to value range
	[3] lookup table
	[4] rgb coded values
	[5] same as in graphical user interface
	Default: 5
  -COL_PALETTE:        	Colors Palette
	colors
  -GRADUATED:          	Graduated Colors
	boolean
	Default: 1
  -STDDEV:          	Standard Deviation
	floating point number
	Minimum: 0.000000
	Default: 2.000000
  -LINEAR_MIN:      	Percentage Range
	value range
  -LINEAR_MAX:      	Percentage Range
	value range
  -STRETCH_MIN:     	Value Range
	value range
  -STRETCH_MAX:     	Value Range
	value range
  -SCALE_MODE:         	Scaling
	choice
	Available Choices:
	[0] linear intervals
	[1] increasing geometrical intervals
	[2] decreasing geometrical intervals
	Default: 0
  -SCALE_LOG:       	Geometrical Interval Factor
	floating point number
	Minimum: 0.001000
	Default: 10.000000
  -LUT:                	Lookup Table
	static table
	5 Fields:
	- 1. [color] Color
	- 2. [string] Name
	- 3. [string] Description
	- 4. [8 byte floating point number] Minimum
	- 5. [8 byte floating point number] Maximum
	
  -SHADE_TRANS:     	Transparency
	floating point number
	Minimum: 0.000000
	Maximum: 100.000000
	Default: 75.000000
  -SHADE_COLOURING:    	Histogram Stretch
	choice
	Available Choices:
	[0] Linear
	[1] Standard Deviation
	Default: 0
  -SHADE_BRIGHT_MIN:	Linear
	value range
  -SHADE_BRIGHT_MAX:	Linear
	value range
  -SHADE_STDDEV:    	Standard Deviation
	floating point number
	Minimum: 0.000000
	Default: 2.000000