SAGA-GIS Tool Library Documentation (v9.1.2)

Tool Import Raster

The "GDAL Raster Import" tool imports grid data from various file formats using the "Geospatial Data Abstraction Library" (GDAL) by Frank Warmerdam.
GDAL Version:3.6.2

Following raster formats are currently supported:

IDNameExtension
ECWERDAS Compressed Wavelets (SDK 5.5)ecw
JP2ECWERDAS JPEG2000 (SDK 5.5)jp2
FITSFlexible Image Transport System
HDF4Hierarchical Data Format Release 4hdf
HDF4ImageHDF4 Dataset
HDF5Hierarchical Data Format Release 5
HDF5ImageHDF5 Dataset
BAGBathymetry Attributed Gridbag
KEAKEA Image Format (.kea)kea
netCDFNetwork Common Data Formatnc
PDFGeospatial PDFpdf
VRTVirtual Rastervrt
DERIVEDDerived datasets using VRT pixel functions
GTiffGeoTIFFtif
NITFNational Imagery Transmission Formatntf
RPFTOCRaster Product Format TOC formattoc
ECRGTOCECRG TOC formatxml
HFAErdas Imagine Images (.img)img
SAR_CEOSCEOS SAR Image
CEOSCEOS Image
JAXAPALSARJAXA PALSAR Product Reader (Level 1.1/1.5)
GFFGround-based SAR Applications Testbed File Format (.gff)gff
ELASELAS
ESRICEsri Compact Cache
AIGArc/Info Binary Grid
AAIGridArc/Info ASCII Gridasc
GRASSASCIIGridGRASS ASCII Grid
ISGInternational Service for the Geoidisg
SDTSSDTS Rasterddf
DTEDDTED Elevation Raster
PNGPortable Network Graphicspng
JPEGJPEG JFIFjpg
MEMIn Memory Raster
JDEMJapanese DEM (.mem)mem
GIFGraphics Interchange Format (.gif)gif
BIGGIFGraphics Interchange Format (.gif)gif
ESATEnvisat Image Formatn1
BSBMaptech BSB Nautical Chartskap
XPMX11 PixMap Formatxpm
BMPMS Windows Device Independent Bitmapbmp
DIMAPSPOT DIMAP
AirSARAirSAR Polarimetric Image
RS2RadarSat 2 XML Product
SAFESentinel-1 SAR SAFE Product
PCIDSKPCIDSK Database Filepix
PCRasterPCRaster Raster Filemap
ILWISILWIS Raster Map
SGISGI Image File Format 1.0rgb
SRTMHGTSRTMHGT File Formathgt
LevellerLeveller heightfieldter
TerragenTerragen heightfieldter
ISIS3USGS Astrogeology ISIS cube (Version 3)
ISIS2USGS Astrogeology ISIS cube (Version 2)
PDSNASA Planetary Data System
PDS4NASA Planetary Data System 4xml
VICARMIPL VICAR file
TILEarthWatch .TIL
ERSERMapper .ers Labelleders
JP2OpenJPEGJPEG-2000 driver based on OpenJPEG libraryjp2
L1BNOAA Polar Orbiter Level 1b Data Set
FITFIT Image
GRIBGRIdded Binary (.grb, .grb2)
RMFRaster Matrix Formatrsw
WCSOGC Web Coverage Service
WMSOGC Web Map Service
MSGNEUMETSAT Archive native (.nat)nat
RSTIdrisi Raster A.1rst
GSAGGolden Software ASCII Grid (.grd)grd
GSBGGolden Software Binary Grid (.grd)grd
GS7BGGolden Software 7 Binary Grid (.grd)grd
COSARCOSAR Annotated Binary Matrix (TerraSAR-X)
TSXTerraSAR-X Product
COASPDRDC COASP SAR Processor Rasterhdr
RR Object Data Storerda
MAPOziExplorer .MAP
KMLSUPEROVERLAYKml Super Overlay
WEBPWEBPwebp
RasterliteRasterlitesqlite
MBTilesMBTilesmbtiles
PLMOSAICPlanet Labs Mosaics API
CALSCALS (Type 1)
WMTSOGC Web Map Tile Service
SENTINEL2Sentinel 2
MRFMeta Raster Formatmrf
PNMPortable Pixmap Format (netpbm)
DOQ1USGS DOQ (Old Style)
DOQ2USGS DOQ (New Style)
PAuxPCI .aux Labelled
MFFVexcel MFF Rasterhdr
MFF2Vexcel MFF2 (HKV) Raster
GSCGSC Geogrid
FASTEOSAT FAST Format
BTVTP .bt (Binary Terrain) 1.3 Formatbt
LANErdas .LAN/.GIS
CPGConvair PolGASP
NDFNLAPS Data Format
EIRErdas Imagine Raw
DIPExDIPEx
LCPFARSITE v.4 Landscape File (.lcp)lcp
GTXNOAA Vertical Datum .GTXgtx
LOSLASNADCON .los/.las Datum Grid Shift
NTv2NTv2 Datum Grid Shift
CTable2CTable2 Datum Grid Shift
ACE2ACE2ACE2
SNODASSnow Data Assimilation Systemhdr
KROKOLOR Rawkro
ROI_PACROI_PAC raster
RRASTERR Rastergrd
BYNNatural Resources Canada's Geoid
ARGAzavea Raster Grid format
RIKSwedish Grid RIK (.rik)rik
USGSDEMUSGS Optional ASCII DEM (and CDED)dem
GXFGeoSoft Grid Exchange Formatgxf
NWT_GRDNorthwood Numeric Grid Format .grd/.tabgrd
NWT_GRCNorthwood Classified Grid Format .grc/.tabgrc
ADRGARC Digitized Raster Graphicsgen
SRPStandard Raster Product (ASRP/USRP)img
BLXMagellan topo (.blx)blx
PostGISRasterPostGIS Raster driver
SAGASAGA GIS Binary Grid (.sdat, .sg-grd-z)
XYZASCII Gridded XYZxyz
HF2HF2/HFZ heightfield rasterhf2
OZIOziExplorer Image File
CTGUSGS LULC Composite Theme Grid
ZMapZMap Plus Griddat
NGSGEOIDNOAA NGS Geoid Height Gridsbin
IRISIRIS data (.PPI, .CAPPi etc)ppi
PRFRacurs PHOTOMOD PRFprf
EEDAIEarth Engine Data API Image
DAASAirbus DS Intelligence Data As A Service driver
SIGDEMScaled Integer Gridded DEM .sigdemsigdem
TGATGA/TARGA Image File Formattga
OGCAPIOGCAPI
STACTASpatio-Temporal Asset Catalog Tiled Assetsjson
STACITSpatio-Temporal Asset Catalog Items
GPKGGeoPackagegpkg
CADAutoCAD Driverdwg
PLSCENESPlanet Labs Scenes API
NGWNextGIS Web
GenBinGeneric Binary (.hdr Labelled)
ENVIENVI .hdr Labelled
EHdrESRI .hdr Labelledbil
ISCEISCE raster
ZarrZarr
HTTPHTTP Fetching Wrapper


References


Parameters

 NameTypeIdentifierDescriptionConstraints
InputShapes ExtentShapes, inputEXTENT_SHAPES--
OutputGridsGrid list, outputGRIDS--
OptionsFilesFile pathFILES--
Multiple Bands OutputChoiceMULTIPLE-Available Choices:
[0] single grids
[1] grid collection
[2] automatic
Default: 2
SubsetsText, CMDSUBSETSSemicolon separated list of subset names or indexes (zero-based). If empty (default) all subsets will be imported (if there are any).-
Select from Multiple BandsText, CMDSELECTIONSemicolon separated list of band indexes (zero-based). If empty (default) all bands will be imported.-
Select from Multiple BandsBoolean, GUISELECT-Default: 0
Alphanumeric SortingBoolean, GUISELECT_SORTSorts bands by their name before the selection dialog opens.Default: 0
TransformationBooleanTRANSFORMalign grid to coordinate systemDefault: 1
ResamplingChoiceRESAMPLINGResampling type to be used, if grid needs to be aligned to coordinate system.Available Choices:
[0] Nearest Neighbour
[1] Bilinear Interpolation
[2] Bicubic Spline Interpolation
[3] B-Spline Interpolation
Default: 0
ExtentChoiceEXTENT-Available Choices:
[0] original
[1] user defined
[2] grid system
[3] shapes extent
Default: 0
LeftFloating pointEXTENT_XMIN-Default: 0.000000
RightFloating pointEXTENT_XMAX-Default: 0.000000
BottomFloating pointEXTENT_YMIN-Default: 0.000000
TopFloating pointEXTENT_YMAX-Default: 0.000000
Grid SystemGrid systemEXTENT_GRID--
BufferFloating pointEXTENT_BUFFER-Minimum: 0.000000
Default: 0.000000

Command-line

Usage: saga_cmd io_gdal 0 [-GRIDS <str>] [-FILES <str>] [-MULTIPLE <str>] [-SUBSETS <str>] [-SELECTION <str>] [-TRANSFORM <str>] [-RESAMPLING <str>] [-EXTENT <str>] [-EXTENT_XMIN <double>] [-EXTENT_XMAX <double>] [-EXTENT_YMIN <double>] [-EXTENT_YMAX <double>] [-EXTENT_GRID_D <double>] [-EXTENT_GRID_X <double>] [-EXTENT_GRID_Y <double>] [-EXTENT_GRID_NX <num>] [-EXTENT_GRID_NY <num>] [-EXTENT_GRID_FILE <str>] [-EXTENT_SHAPES <str>] [-EXTENT_BUFFER <double>]
  -GRIDS:<str>           	Grids
	Grid list, output
  -FILES:<str>           	Files
	File path
  -MULTIPLE:<str>        	Multiple Bands Output
	Choice
	Available Choices:
	[0] single grids
	[1] grid collection
	[2] automatic
	Default: 2
  -SUBSETS:<str>         	Subsets
	Text, CMD
  -SELECTION:<str>       	Select from Multiple Bands
	Text, CMD
  -TRANSFORM:<str>       	Transformation
	Boolean
	Default: 1
  -RESAMPLING:<str>      	Resampling
	Choice
	Available Choices:
	[0] Nearest Neighbour
	[1] Bilinear Interpolation
	[2] Bicubic Spline Interpolation
	[3] B-Spline Interpolation
	Default: 0
  -EXTENT:<str>          	Extent
	Choice
	Available Choices:
	[0] original
	[1] user defined
	[2] grid system
	[3] shapes extent
	Default: 0
  -EXTENT_XMIN:<double>  	Left
	Floating point
	Default: 0.000000
  -EXTENT_XMAX:<double>  	Right
	Floating point
	Default: 0.000000
  -EXTENT_YMIN:<double>  	Bottom
	Floating point
	Default: 0.000000
  -EXTENT_YMAX:<double>  	Top
	Floating point
	Default: 0.000000
  -EXTENT_GRID_D:<double>	Cell Size
  -EXTENT_GRID_X:<double>	Lower Left Center Cell X-Coordinate
  -EXTENT_GRID_Y:<double>	Lower Left Center Cell Y-Coordinate
  -EXTENT_GRID_NX:<num>  	Number of Columns
  -EXTENT_GRID_NY:<num>  	Number of Rows
  -EXTENT_GRID_FILE:<str>	Grid File
  -EXTENT_SHAPES:<str>   	Shapes Extent
	Shapes, input
  -EXTENT_BUFFER:<double>	Buffer
	Floating point
	Minimum: 0.000000
	Default: 0.000000