Settings Reference

ACOLITE uses a hierarchical settings system. Settings can be specified in:

Create a settings file with only the parameters you want to change from defaults.

Input/Output Settings

Setting	Default	Description
`inputfile`	None	Input file(s) or directory, comma-separated
`output`	None	Output directory path
`geofile`	None	External geolocation file
`output_geolocation`	True	Include lat/lon in output
`output_xy`	False	Include x/y coordinates
`output_geometry`	True	Include sun/view geometry
`output_lt`	False	Output TOA radiance
`output_bt`	False	Output brightness temperature
`verbosity`	5	Output verbosity level (0-10)

Setting	Default	Description
`limit`	None	Bounding box: South,West,North,East
`polygon`	None	Polygon file (GeoJSON, shapefile) or WKT
`polygon_limit`	True	Use polygon bounding box for initial crop
`polygon_clip`	False	Clip output to polygon boundary
`region_name`		Name for the region (used in filenames)
`station_lon`	None	Station longitude for extraction
`station_lat`	None	Station latitude for extraction
`station_box_size`	None	Size of extraction box
`station_box_units`	km	Units for box size (km, m, pixel)
`limit_buffer`	None	Buffer to add around limit
`limit_buffer_units`	degrees	Buffer units (degrees, km, m)
`merge_tiles`	False	Merge adjacent tiles (Sentinel-2)
`l1r_crop`	False	Crop at L1R level

Setting	Default	Description
`atmospheric_correction`	True	Enable atmospheric correction
`atmospheric_correction_method`	dark_spectrum	Correction method
`dsf_aot_estimate`	tiled	AOT estimation mode (tiled, fixed, segmented)
`dsf_fixed_aot`	None	Fixed AOT value (when dsf_aot_estimate=fixed)
`dsf_fixed_lut`	ACOLITE-LUT-202110-MOD2	LUT for fixed AOT mode
`dsf_nbands`	2	Number of bands for AOT fit
`dsf_aot_compute`	min	AOT aggregation method (min, mean, median)
`dsf_spectrum_option`	intercept	Dark spectrum method (intercept, darkest, percentile)
`dsf_percentile`	1	Percentile for dark pixel selection
`dsf_intercept_pixels`	1000	Pixels for intercept calculation
`dsf_model_selection`	min_drmsd	Model selection criterion
`dsf_wave_range`	400,2500	Wavelength range for DSF (nm)
`dsf_exclude_bands`	None	Bands to exclude from DSF

Setting	Default	Description
`dsf_tile_dimensions`	100,100	Tile size in pixels (rows, cols)
`dsf_tile_smoothing`	True	Smooth tile AOT values
`dsf_tile_smoothing_kernel_size`	3	Smoothing kernel size
`dsf_tile_interp_method`	linear	Interpolation method between tiles
`dsf_min_tile_cover`	0.10	Minimum valid pixel coverage per tile
`dsf_min_tile_aot`	0.01	Minimum allowed AOT
`dsf_max_tile_aot`	1.20	Maximum allowed AOT
`dsf_smooth_aot`	False	Smooth final AOT field
`dsf_smooth_box`	10,10	Smoothing box size
`dsf_aot_fillnan`	True	Fill NaN values in AOT

Setting	Default	Description
`gas_transmittance`	True	Apply gas transmittance correction
`min_tgas_aot`	0.85	Minimum transmittance for AOT retrieval
`min_tgas_rho`	0.70	Minimum transmittance for reflectance

Setting	Default	Description
`ancillary_data`	True	Retrieve ancillary data automatically
`ancillary_type`	GMAO_MERRA2_MET	Ancillary data source
`uoz_default`	0.3	Default ozone (atm-cm)
`uwv_default`	1.5	Default water vapor (g/cm²)
`pressure`	None	Fixed pressure (hPa)
`pressure_default`	1013.25	Default pressure (hPa)
`wind`	None	Fixed wind speed (m/s)
`wind_default`	2	Default wind speed (m/s)

Setting	Default	Description
`dem_pressure`	False	Use DEM for pressure correction
`dem_pressure_resolved`	True	Per-pixel DEM pressure
`dem_pressure_percentile`	25	DEM percentile for tile pressure
`dem_source`	copernicus30	DEM source (copernicus30, copernicus90, srtm)
`dem_shadow_mask`	False	Apply DEM shadow masking
`dem_shadow_mask_extend`	True	Extend shadow mask
`dem_shadow_mask_extend_metres`	3000	Shadow extension distance

Setting	Default	Description
`dsf_interface_reflectance`	False	Model air-water interface
`dsf_interface_option`	default	Interface model option
`dsf_residual_glint_correction`	False	Apply residual glint correction
`dsf_residual_glint_wave_range`	1500,2400	SWIR range for glint estimation
`glint_mask_rhos_wave`	1600	Wavelength for glint masking
`glint_mask_rhos_threshold`	0.05	Glint mask threshold

Setting	Default	Description
`adjacency_correction`	False	Enable adjacency correction
`adjacency_correction_method`	None	Method (radcor)
`radcor_kernel_radius`	5.0	RAdCor kernel radius (km)
`radcor_max_vza`	15	Maximum view zenith angle
`radcor_aot_estimate`	tsdsf	AOT estimation for RAdCor

Setting	Default	Description
`l2w_parameters`	None	Parameters to compute (comma-separated)
`l2w_mask`	True	Apply masking to L2W products
`l2w_mask_wave`	1600	Wavelength for land masking
`l2w_mask_threshold`	0.0215	Reflectance threshold for masking
`l2w_mask_water_parameters`	True	Mask water parameters
`l2w_mask_negative_rhow`	True	Mask negative water reflectance
`l2w_mask_negative_wave_range`	400,900	Wavelength range for negative check
`l2w_mask_cirrus`	True	Apply cirrus masking
`l2w_mask_cirrus_threshold`	0.005	Cirrus reflectance threshold
`l2w_mask_high_toa`	True	Mask high TOA pixels
`l2w_mask_high_toa_threshold`	0.3	High TOA threshold
`l2w_mask_smooth`	True	Smooth mask
`l2w_mask_smooth_sigma`	3	Smoothing sigma

Setting	Default	Description
`l1r_export_geotiff`	False	Export L1R as GeoTIFF
`l2r_export_geotiff`	False	Export L2R as GeoTIFF
`l2w_export_geotiff`	False	Export L2W as GeoTIFF
`export_cloud_optimized_geotiff`	False	Create Cloud Optimized GeoTIFF
`l1r_export_geotiff_rgb`	False	Export L1R RGB as GeoTIFF
`l2r_export_geotiff_rgb`	False	Export L2R RGB as GeoTIFF

Setting	Default	Description
`rgb_rhot`	True	Generate TOA RGB image
`rgb_rhos`	True	Generate surface RGB image
`rgb_rhow`	False	Generate water-leaving RGB
`rgb_red_wl`	650	Red band wavelength (nm)
`rgb_green_wl`	560	Green band wavelength (nm)
`rgb_blue_wl`	480	Blue band wavelength (nm)
`rgb_min`	0.0,0.0,0.0	Minimum values for RGB scaling
`rgb_max`	0.15,0.15,0.15	Maximum values for RGB scaling
`rgb_gamma`	1.0,1.0,1.0	Gamma correction per band
`map_l1r`	False	Generate L1R maps
`map_l2r`	False	Generate L2R maps
`map_l2w`	False	Generate L2W maps
`map_title`	True	Include title on maps
`map_colorbar`	True	Include colorbar
`map_scalebar`	False	Include scale bar
`map_dpi`	300	Map resolution (DPI)

Setting	Default	Description
`output_projection`	False	Reproject outputs
`output_projection_epsg`	None	Target EPSG code
`output_projection_resolution`	None	Output resolution (m)
`output_projection_resampling_method`	bilinear	Resampling method
`reproject_outputs`	L1R,L2R,L2W	Which levels to reproject

Setting	Default	Description
`tact_run`	False	Enable thermal processing
`tact_profile_source`	era5	Atmospheric profile source
`tact_reptran`	medium	libRadtran spectral resolution
`tact_emissivity`	water	Emissivity assumption
`tact_range`	3.5,14	Thermal wavelength range (µm)
`use_system_libradtran`	False	Use system libRadtran installation

Sentinel-2

Setting	Default	Description
`s2_target_res`	10	Target resolution (m)
`geometry_type`	grids_footprint	Geometry interpolation method
`geometry_res`	60	Geometry resolution (m)
`s2_dilate_blackfill`	False	Remove blackfill lines

Sentinel-3 OLCI

VIIRS

Landsat

Setting	Default	Description
`landsat_qa_bands`	PIXEL,RADSAT,SATURATION,AEROSOL	QA bands to process
`landsat_qa_output`	False	Output QA bands

PRISMA

Setting	Default	Description
`prisma_rhot_per_pixel_sza`	True	Per-pixel SZA for TOA
`prisma_store_l2c`	False	Store L2C data