Environment Variables

RIOS honours the following environment variables which can be used to override default behaviour globally:

Environment Variable

Description

Default

ApplierControls name

RIOS_DFLT_DRIVER

The name of the default GDAL driver

HFA

drivername

RIOS_DFLT_DRIVEROPTIONS

Creation Options to be passed to GDAL. Can be ‘None’. This is now deprecated, in favour of RIOS_DFLT_CREOPT_*

COMPRESSED=TRUE IGNOREUTM=TRUE

creationoptions

RIOS_DFLT_CREOPT_<driver>

Driver-specific creation options. These are new, and intended to supercede the old generic default. Can be specified for any driver, but defaults are given as below

From generic variable

creationoptions should be None to use these

RIOS_DFLT_CREOPT_HFA

Default creation options for HFA

COMPRESS=YES IGNOREUTM=TRUE

RIOS_DFLT_CREOPT_GTiff

Default creation options for GTiff

TILED=YES INTERLEAVE=BAND COMPRESS=LZW BIGTIFF=IF_SAFER

RIOS_DFLT_FOOTPRINT

0 for intersection, 1 for union

Intersection

footprint

RIOS_DFLT_BLOCKXSIZE

Window X size

200

windowxsize

RIOS_DFLT_BLOCKYSIZE

Window Y size

200

windowysize

RIOS_DFLT_OVERLAP

Overlap between blocks

0

overlap

RIOS_HISTOGRAM_IGNORE_RFC40

If set, this will force writing of histogram to ignore GDAL’s RFC40 capabilities. Mostly helpful when using HFA files, as RFC40 seems to have some problems with them in versions of GDAL older than 2.2.0.

Not set

Not in controls

RIOS_DFLT_JOBMGRTYPE RIOS_PBSJOBMGR_QSUBOPTIONS RIOS_PBSJOBMGR_INITCMDS RIOS_SLURMJOBMGR_SBATCHOPTIONS RIOS_SLURMJOBMGR_INITCMDS

See rios.parallel.jobmanager for a description of these variables

RIOS_DFLT_OVERVIEWLEVELS

Global default overview levels. A comma-separated list of reduction factors, as per gdaladdo command

4,8,16,32,64, 128,256,512

overviewLevels

RIOS_DFLT_MINOVERLEVELDIM

Minimum dimension of overview layers. Overview layers with any dimension less than this will not be created.

33

overviewMinDim

RIOS_DFLT_OVERVIEWAGGTYPE

Default aggregation type for overviews, used with formats not supporting LAYER_TYPE

AVERAGE

overviewAggType

RIOS_DFLT_AUTOCOLORTABLETYPE

Enforces automatic color tables on thematic output rasters. Value is a string passed as autoColorTableType to rios.rat.genColorTable()

No automatic color table generated

autoColorTableType

RIOS_NO_VRT_FOR_RESAMPLING

If set to ‘1’ will mean that resampling with VRTs is disabled and a temporary file in the output format will be used instead. Added in RIOS 1.4.5.

0 = Use VRT

Not in controls

RIOS_AWSBATCH_STACK

The CloudFormation stack name to use for AWS Batch jobs

RIOS

Not in controls

RIOS_AWSBATCH_REGION

The AWS Region to look for the CloudFormation stack specified by DFLT_BATCH_STACK.

ap-southeast-2

Not in controls

RIOS_NOMSG_TIMEOUT

For AWS Batch sub jobs. The number of seconds after the last received message before deciding the main has crashed and exiting the job.

1 hour

Not in controls