## Help – User Guide for Indonesian Multi-scaled Grid System QGIS Plugin

IMSGS is a QGIS plugin that provides comprehensive support for calculating, mapping, and analyzing in a data-driven framework. The main objective of IMSGS is to provide automation of the determination of Indonesia's Environmental Support and Capacity in compliance with the national guidelines of the Ministry of Environment and Forestry.

### Generate Grid

Create a vector layer with a grid covering a given extent. The grid is fixed for the Indonesian region by defining λmin, λmax, φmin, φmax points based on the World Geodetic System 1984 (WGS84) reference system. The resolution can be chosen as required and can be extracted by the size of the input layer. Every grid contains a unique identifier that differentiates between grids.

(PARAMETER)

Label | Name | Type | Description
--- | --- | --- | ---
Input Vector Layer (optional) | INPUT | [vector: Polygon] | Input vector polygon layer that will be used as output geometry extent
Geometry Extent [WGS 84] (optional) | STRING_PARAM | String | Specify λmin, λmax, φmin, φmax points based on the World Geodetic System 1984 (WGS84) reference system
Grid Resolution | RADIO_PARAM | Enumeration Default : 30'' x 30'' | Grid System Resolution: • 30’ x 30’ – 55.5 x 55.5 (km) • 15’ x 15’ – 27.75 x 27.75 (km) • 7’30” x 7’30” – 13.875 x 13.875 (km) • 2’30” x 2’30” – 4.625 x 4.625 (km) • 30” x 30” – 0.900 x 0.900 (km) • 5” x 5” – 0.150 x 0.150 (km)
Extract Grid by Vector Layer (optional) | EXTRACT | Boolean | Extract the vector layer grid according to the input vector layer
Output Layer | OUTPUT | [vector: Polygon] Default: [Create temporary layer] | Specify the output layer. Choose one of the following: • Create Temporary Layer • Save to File… • Save to GeoPackage • Save to Database Table The file encoding can also be changed here.

(OUTPUT)

Label | Name | Type | Description
--- | --- | --- | ---
Output Layer | OUTPUT | [vector: Polygon] | Output vector layer with one columns : 1. IMSGSID : Grid ID

### Distribute Population of Grid

Obtain the population distribution for each grid. The population distribution depends on the grid, road type, land cover type, and administrative boundary data containing population information. The weighting of road and land cover data is filled in manually/freely by the user. The results of the population distribution calculation are then used to calculate the water and food demand for each grid.

(PARAMETER)

Label | Name | Type | Description
--- | --- | --- | ---
Input IMSGS Grid Layer | INPUT | [vector: polygon] | Input vector layer containing grids with unique identifier for each grid
Input Land Cover Layer | LC_LAYER | [vector: polygon] | Input land cover layer containing weights for each land cover type
Select Field that Contains Land Cover Type’s Weight | TableWeightLC | [tablefield: any] [list] Default: None Parent: LC_LAYER | Selecting the land cover layer column that contains the land cover type’s weights
Input Road Layer | RT_LAYER | [vector: line] | Input road layer containing weights for each road type
Select Field that Contains Road Type’s Weight | TableWeightRT | [tablefield: any] [list] Default: None Parent: RT_LAYER | Selecting the road layer column containing the road type’s weights
Input Administrative Boundaries Layer | INPUTA | [vector: polygon] | Administrative boundary layer input that contains administrative boundary name and population
Select Field that Contains Administrative Boundary Name | INPUTNAME | [tablefield: any] [list] Default: None Parent: INPUTA | Selecting the administrative boundary layer column that contains administrative boundary name
Select Field that Contains Population | INPUTPOP | [tablefield: any] [list] Default: None Parent: INPUTA | Selecting the administrative boundary layer column that contains the population number
Output Layer | OUTPUT | [vector: Polygon] Default: [Create temporary layer] | Specify the output layer. Choose one of the following: •Create Temporary Layer • Save to File… •Save to GeoPackage •Save to Database Table The file encoding can also be changed here.

(OUTPUT)

Label | Name | Type | Description
--- | --- | --- | ---
Output Layer | OUTPUT | [vector: Polygon] | Output vector layer with seven columns which are: 1. IMSGSID : Grid ID 2. WRT : Total Road Type Weight of each grid 3. WLC : Total Land Cover Type Weight of each grid 4. WGrid : Total Weight of each grid 5. Wadmin : Total Weight of each administration boundary 6. Admname : Name of grid's administrative boundary 7. Population : Population count of each grid

### Environmental Carrying Capacity (Water)

Environmental Carrying Capacity (Water) consists of: • Generate Water Needs Distribution • Generate Water Availability Distribution • Generate Water Need and Capacity Difference and Status

1. Generate Water Needs Distribution

The distribution of water needs in each grid is based on population and land cover.

(PARAMETER)

Label | Name | Type | Description
--- | --- | --- | ---
Input IMSGS Population Layer | POPUL_GRID | [vector: polygon] | Input vector layer containing a grid with population data for each grid
Select Field that Contains Population | POPUL_FIELD | [tablefield: any] [list] Default: None Parent: POPUL_GRID | Select the column layer that contains the population data on each grid
Input Household Water Usage Standard per Year (m³/year/capita) | STD_WATER | [number] Min Value : 1 Default : 43.2 | The standard of Household Water Requirements per year is 43.2 m³/year/capita. This can be filled automatically or manually
Input Correction Factor for Household Water Usage per Year | COR_FCT | [number] Min Value : 1 Default : 2 | Standardized set of decent living water requirements, i.e. number 2 as a correction factor. This can be filled automatically or manually.
Input Vegetation Layer that Contains Seasonal Crop Intensity per year | VEG | [vector: polygon] | Input vector vegetation layer containing seasonal crop intensity per year
Select Field that Contains Seasonal Crop Intensity per year | VEG_INT | [tablefield: any] [list] Default: None Parent: VEG | Selecting a column vegetation layer containing crop intensity data of season per year
Input Vegetation Water Usage Standard per Season (m³/s/ha) | STD_VEG | [number] Min Value : 1 Default : 10368 | Standard water use (1 liter/second/hectare); 0.001 m^3/second/ha x 3600 x 24 x 120 days per season. This can be filled automatically or manually.
Output Layer | NEED | [vector: Polygon] Default: [Create temporary layer] | Specify the output layer. Choose one of the following: • Create Temporary Layer • Save to File… • Save to GeoPackage • Save to Database Table The file encoding can also be changed here.

(OUTPUT)

Label | Name | Type | Description
--- | --- | --- | ---
Output Layer | OUTPUT | [vector: Polygon] | Output vector layer with five columns which are: 1. IMSGSID : Grid ID 2. Population : Population count of each grid 3. Dgrid : Household water needs of each grid 4. Qgrid : Water needs based on land cover of each grid 5. Tgrid : Total water needs for each grid

2. Generate Water Availability Distribution

The water availability distribution is determined with the principle of disagregation with the calculation of distributed Environmental Performance Index.

(PARAMETER)

Label | Name | Type | Description
--- | --- | --- | ---
Input IMSGS Layer | Grid | [vector: polygon] | Input vector layer containing grids with unique identifiers for each grid
Input Layer that Contains Environmental Performance Index | IJH | [vector: polygon] | Input vector layer containing environmental services index column
Select Field that Contains Enviromental Performance Index | IJH_V | [[tablefield: any] [list] Default: None Parent : IJH | Select the column layer containing the environmental services index column
Input Watershed Area Layer | WAS | [vector: polygon] | Input vector layer containing watershed area name and total water availability
Select Field that Contains Total Water Availability (m³/year) | WAS_V | [tablefield: any] [list] Default: None Parent : WAS | Select the layer column that contains water availability in the Watershed layer
| Output Layer | OUTPUT | [vector: Polygon] Default: [Create temporary layer] | Specify the output layer. Choose one of the following: • Create Temporary Layer • Save to File… • Save to GeoPackage • Save to Database Table The file encoding can also be changed here.

(OUTPUT)

Label | Name | Type | Description
--- | --- | --- | ---
Output Layer | OUTPUT | [vector: Polygon] | Output vector layer with two columns which are: 1. IMSGSID : Grid ID 2. K_Grid : water availability for each grid

3. Generate Water Need and Capacity Difference and Status

Analyze how much of the maximum population can be supported with existing water availability. The threshold determination is carried out with information on the need, availability, and need for water for a decent life (KHL) in the form of a constant.

(PARAMETER)

Label | Name | Type | Description
--- | --- | --- | ---
Input IMSGS Water Needs Layer | NEED | [vector: polygon] | Input vector layer containing the water needs distribution for each grid. The water needs distribution vector layer for each grid has been generated in 'Generate Water Needs Distribution'.
Select Field that Contains Water Needs for Each Grid | NEED_VAL | [tablefield: any] [list] Default: None Parent : NEED | Select the column layer that contains the distribution of water needs for each grid
Input IMSGS Water Availability Layer | AVAIL | [vector: polygon] | Input vector layer containing the water availability distribution for each grid. The water availability distribution vector layer for each grid has been generated in 'Generate Water Availability Distribution'.
Select Field that Contains Water Availability for Each Grid | AVAIL_VAL | [tablefield: any] [list] Default: None Parent : AVAIL | Select the column layer that contains the distribution of water availability for each grid
Input Water Needs for a Decent Life Value per Year | WN_STD | Default : 800 | Insert the value of water sufficiency number, in the form of a constant in unit of m³/capita/year, This can be filled automatically or manually
| Output Layer | OUTPUT | [vector: Polygon] Default: [Create temporary layer] | Specify the output layer. Choose one of the following: • Create Temporary Layer • Save to File… • Save to GeoPackage • Save to Database Table The file encoding can also be changed here.

(OUTPUT)

Label | Name | Type | Description
--- | --- | --- | ---
Output Layer | OUTPUT | [vector: Polygon] | Output vector layer with seven columns which are: 1. IMSGSID : Grid ID 2. Population : Population for each grid 3. AgridW : Water availability for each grid 4. NgridW : Water needs for each grid 5. Difference : Difference between water availability and needs for each grid 6. Status : Status for each grid either exceed or not. 7. Threshold : Maximum population can be supported with existing water availability

### Environmental Carrying Capacity (Food)

Environmental Carrying Capacity (Food) consists of: • Generate Energy Needs Distribution • Generate Energy Availability Distribution • Generate Energy Need and Capacity Difference and Status

1. Generate Energy Needs Distribution

The energy needs distribution is determined based on the calculation of the Energy Sufficiency Value (AKE) of the population of each grid for a year.

(PARAMETER)

Label | Name | Type | Description
--- | --- | --- | ---
Input IMSGS Population Layer | popgrid | [vector: polygon] | Input vector layer containing a grid with population data for each grid.
Select Field that Contains Population | popfield | [tablefield: any] [list] Default: None Parent : popgrid | Select the column layer that contains the population data on each grid
Input Energy Needs Value | AKE | [number] Default : 2100 | Energy Sufficiency Value (AKE) is the amount of food energy needed by an individual to carry out daily activities. The AKE of the average Indonesian population for a year, which is 2,100 kcal/day/capita. Can be filled automatically or manually
Output Layer | OUTPUT | [vector: Polygon] Default: [Create temporary layer] | Specify the output layer. Choose one of the following: • Create Temporary Layer • Save to File… • Save to GeoPackage • Save to Database Table The file encoding can also be changed here.

(OUTPUT)

Label | Name | Type | Description
--- | --- | --- | ---
Output Layer | OUTPUT | [vector: Polygon] | Output vector layer with three columns which are: 1. IMSGSID : Grid ID 2. Population : Population for each grid 3. AKEGrid : Energy needs for each grid

2. Generate Energy Availability Distribution

The energy availability distribution is determined with the principle of disagregation with the calculation of distributed Environmental Performance Index.

(PARAMETER)

Label | Name | Type | Description
--- | --- | --- | ---
Input IMSGS Layer | grid | [vector: Polygon] | Input vector layer containing grids with unique identifiers and administrative boundary name for each grid.
Input Administrative Boundary | admlay | [vector: Polygon] | Input administrative boundary layer containing energy production data
Select Field that Contains Administrative Boundary Name | admfield | [tablefield: any] [list] Default: None Parent :admlay | Select the layer column containing the administrative boundary name from Administrative Boundary layer
Select Field that Contains Food Energy Production | enerfield | [tablefield: any] [list] Default: None Parent : admlay | Select the layer column containing energy production from the administrative boundary layer
Input Layer that Contains Food Environmental Performance Index | ESPlay | [vector: Polygon] | Input vector layer containing the environmental services performance value
Select Field that Contains Food environmental Performance Index | IJEPBPESP | [tablefield: any] [list] Default: None Parent : ESPlay | Select the layer column containing the Food environmental Performance Index
Output Layer | OUTPUT | [vector: Polygon] | Specify the output layer. Choose one of the following: • Create Temporary Layer • Save to File… • Save to GeoPackage • Save to Database Table The file encoding can also be changed here.

(OUTPUT)

Label | Name | Type | Description
--- | --- | --- | ---
Output Layer | OUTPUT | [vector: Polygon] | Output vector layer with two columns which are: 1. IMSGSID : Grid ID 2. EnerAvai : Energy availability for each grid

3. Generate Energy Need and Availability Distribution and Status

Analyze how much of the maximum population can be supported with existing food availability. The threshold determination is carried out with information on the need, availability, and Energy Sufficiency Value (AKE) in the form of a constant.

(PARAMETER)

Label | Name | Type | Description
--- | --- | --- | ---
Input IMSGS Energy Needs Layer | needgrid | [vector: polygon] | Input vector layer containing the energy needs distribution for each grid. The energy needs distribution vector layer for each grid has been generated in 'Generate Energy Needs Distribution'.
Select Field that Contains Energy Needs for Each Grid | needfield | [tablefield: any] [list] Default: None Parent : needgrid | Select the column layer that contains the distribution of energy needs for each grid
Input IMSGS Energy Availability Layer | avagrid | [vector: polygon] | Input vector layer containing the energy availability distribution for each grid. The energy availability distribution vector layer for each grid has been generated in 'Generate Energy Availability Distribution'.
Select Field that Contains Energy Availability for Each Grid | avafield | [tablefield: any] [list] Default: None Parent : avagrid | Select the column layer that contains the distribution of energy availability for each grid
Insert Energy Sufficiency Value | AKE Default : 2100 | [number] Default : 2100 | Energy Sufficiency Value (AKE) is the amount of food energy needed by an individual to carry out daily activities. The AKE of the average Indonesian population for a year, which is 2,100 kcal/day/capita. This can be filled automatically or manually
Output Layer | OUTPUT | [vector: Polygon] Default: [Create temporary layer] | Specify the output layer. Choose one of the following: • Create Temporary Layer • Save to File… • Save to GeoPackage • Save to Database Table The file encoding can also be changed here.

(OUTPUT)

Label | Name | Type | Description
--- | --- | --- | ---
Output Layer | OUTPUT | [vector: Polygon] | Output vector layer with seven columns which are: 1. IMSGSID : Grid ID 2. Population : Population for each grid 3. AgridF : Energy availability for each grid 4. NgridF : Energy needs for each grid 5. Difference : Difference between energy availability and needs for each grid 6. Status : Status for each grid either exceed or not. 7. Threshold : Maximum population can be supported with existing energy availability