MAgPIE 4.11.0

[4.11.0] - 2025-07-11

changed

• 15_food add calculation of consumer margins to the postsolve for calculation in model run
• 53_methane CH4 emissions from enteric fermentation are now calculated using vm_feed_intake
• 55_awms Manure excretion is now calculated using vm_feed_intake
• 70_livestock pasture feed balance flows dynamically linked to pasture demand in regions with high historical scavenged feed use
• default.cfg input data upgraded from rev4.118 to rev4.119 (minor update population and GDP)
• README added forestry to model description
• readme added setup instruction specifics for Linux/macOS
• scenario_config update of VLLO scenario to EAT-Lancet 2
• scripts changed setting in the 'mitigation and conservation' start script.

added

• 56_ghg_policy added optional temporal fader for start of C prive driven afforestation
• 70_livestock added new interfaces vm_feed_intake and vm_feed_balanceflow
• core added unused set number_order to force number sets like maccs_steps to be ordered
• default.cfg added switch to control the inclusion of feed balance flows in the calculation of future feed intake

removed

• main Removed Dockerfile, as that is no longer supported/maintained

fixed

• 32_forestry clean-up of switches for rotation length calculation. Removed c32_interest_rate. Merged with c32_rot_calc_type.
• 71_disagg_lvst added set.gms to the off realization to make these sets available for other modules independent of the selected realization

MAgPIE 4.10.1

[4.10.1] - 2025-05-27

changed

• 21_trade changed export share calculation to be done at region level in the model
• default.cfg changed running magpie by default with optfile for specified solver settings (Tol_Optimality)
• default.cfg input data upgraded from rev4.117 to rev4.118, default for bioenergy demand and GHG prices changed from R32M46 to R34M410, rcp4p5 used for SSP2-NPi2025 in line with MAGICC climate outcome and REMIND assumptions.
• scenario_config.csv SSP2 food system assumptions for ScenarioMIP VLLO to avoid sudden jump of calorie intake after 2025
• script/start/test_runs.R Test runs adjusted based on availability from coupled runs for R34M410.
• scripts disaggregation.R moved disaggregateLandConservation function to magpie4
• scripts request 24h for SLURM jobs (except for medium which still requests 7 days)

added

• 80_optimization added writing of conopt opt files with using scalars from input
• default.cfg added option to set Tol_Optimality (GAMS solver setting) to a certain value (GAMS-default 1e-7, new MAgPIE-default 1e-8)

removed

• 80_optimization removed older optfile, that should be tried if no optimal solution can be found

fixed

• 18_residues fixed equation for cluster level production of crop residues in flexreg_apr16 realization
• 32_forestry fixed inconsistency in the application of s32_max_aff_area
• 44_biodiversity expanded age-classes from 150 to 300 years in line with ac set. This bugfix is crucial for the BII indicator.

MAgPIE 4.10.0

[4.10.0] - 2025-04-03

changed

• 09_drivers removed SSP2EU scenario from set
• 15_food included a convergence mechanism to support convergence between iterations
• 15_food tax recycling for income effect in elastic food demand
• 21_trade Cost for additional imports to maintain feasibility reduced from 12300 to 1500 USD17MER per tDM to avoid implausibly high costs and prices for wood and woodfuel
• 32_forestry revised plantation establishment assumptions
• 32_forestry timber plantation harvest is no longer enforced at rotation age to avoid conflicts with q21_trade_reg_up, which can result in huge costs and negative prices for wood
• 35_natveg revised wood harvest assumptions
• 38_factor_costs code cleanup, documentation
• 41_area_equipped_for_irrigation code cleanup
• 56_ghg_policy Minimum CO2 price of 1 $ per ton CO2 on emissions from deforestation and other land conversion in all time steps to avoid sudden jumps in carbon stock changes (cfg$gms$s56_minimum_cprice <- 3.67)
• 60_bioenergy renamed c60_bioenergy_subsidy to s60_bioenergy_1st_subsidy to more clearly reflect its use and changed its unit to USD17MER per GJ. Adjusted q60_bioenergy_incentive accordingly
• 60_bioenergy renamed s60_bioenergy_gj_price_1st to s60_bioenergy_1st_price and s60_bioenergy_price_2nd to s60_bioenergy_2nd_price
• 73_timber revised timber demand calculations
• config.cfg default for cfg$gms$cropland changed from "simple_apr24" to "detail_apr24"
• config.cfg default for cfg$gms$s29_fallow_max changed from 0.4 to 0
• config.cfg default for cfg$gms$s29_treecover_max changed from 0.4 to 1
• config.cfg default for cfg$gms$s35_forest_damage changed from 2 to 0
• default.cfg default for cfg$gms$bioenergy change from 1stgen_priced_dec18 to 1st2ndgen_priced_feb24
• default.cfg default for s60_bioenergy_1st_subsidy (formerly c60_bioenergy_subsidy) changed from 246 USD17MER per ton to 6.5 USD17MER per GJ based on mean GJ per ton of 1st generation bioenergy products.
• default.cfg default for module 44_biodiversity changed from bii_target_apr24 to `bii_target
• default.cfg input data upgraded from rev4.116 to rev4.117
• default.cfg Reactivated external scenario for damage from shifting agriculture (cfg$gms$s35_forest_damage <- 2)
• default.cfg settings for land conversion cost calibration updated
• scenario_config.csv cfg$gms$s56_minimum_cprice no longer used for NCD
• scripts changed c30_bioen_water switch to all in EAT2p0 start script and re-included missing BAU_MITI scenario
• scripts land conversion cost calibration for cropland - FAO as target data set instead of MAgPIEown
• scripts reduced setup information written to main.gms

added

• 11_cost added cost term for soil carbon management
• 22_land_conservation added option for base protection reversal
• 32_forestry Upper annual limit for re/afforestation (s32_annual_aff_limit) applied to NPI/NDC and CO2-price driven re/afforestation (default: 3% of overall forest establishment potential)
• 58_peatland Limit for annual peatland rewetting (2% of degraded peatland per year) to avoid adhoc rewetting of degraded peatlands with the introduction of the CO2 price (cfg$gms$s58_annual_rewetting_limit <- 0.02)
• 59_som added soil carbon management option to cellpool_jan23 realization
• default.cfg added selection of low and middle-income countries isoCountriesLowMiddleIncome
• default.cfg added setting for soil carbon management to config and set cellpool_jan23 realizaton as new default for 59_som module.
• scenario_config.csv added column NPI-revert
• scenario_config.csv added columns AR-natveg and AR-plant for CO2 price re/afforestation and AgroForestry settings
• scenario_config.csv added scenario VLLO based on SDP-MC
• scripts output script for testing elastic demand
• scripts start script for ScenarioMIP MAgPIE standalone runs
• scripts The constraint to maintain 20% semi-natural vegetation at the 1x1km scale is passed on to SEALS, if the setting is changed from the default.cfg

removed

• 15_food/anthropometrics_jan18 removed as outdated
• 44_biodiversity realisation bii_target_apr24 removed because it is identical to bii_target. bii_target set as new default.
• 59_som removed cellpool_aug16 realization (out-dated parameters)
• 60_bioenergy removed s60_bioenergy_1st_subsidy_fix_SSP2, s60_2ndgen_bioenergy_dem_min_post_fix since no longer in use
• scenario_config.csv GDP scenario for VLLO in scenario_config.csv changed from SDP-MC to SSP1 (needed for consistency with REMIND)
• scenario_config.csv removed column SSP2-EU

fixed

• 29_cropland identical results for historic period when using s29_treecover_bii_coeff 0 and 1 in scenarios.
• 32_forestry added contraint q32_ndc_aff_limit to make sure that NPI/NDC re/afforestation does not happen at the cost of forests and other natural vegetation.
• 35_natveg added interface vm_natforest_reduction
• 44_biodiversity scaling of equation q44_bii removed, which caused non-matching LHS and RHS
• 56_ghg_policy bugfixes for regional GHG policy fader
• 59_som soil carbon reference stock for natural vegetation changed to mean value over cluster ("other_land" lu types)
• core/macro wrong use of vm_supply corrected in macro m21_baseline_production
• scripts/output peatland share calculation fixed in disaggreagtion.R and minor bugfixes in disaggreagtion_LUH2.R

MAgPIE 4.9.1

[4.9.1] - 2025-01-28

changed

• scripts peatland rewetting now automatically considered in extra/runSEALSallocation.R

added

• scripts added start script for land-based mitigation and biodiversity conservation paper
• scripts release number can be passed as an argument to test_runs.R to tag as release
• start_scripts added lock_timeout as option to start_run function

fixed

• 44_biodiversity bugfix i44_biome_share, code cleanup, added scaling of q44_bii

MAgPIE 4.9.0

[4.9.0] - 2024-12-05

changed

• 35_natveg revised age-class initialization of secondary forest
• 38_factor_costs updated use of USDA cost shares
• config changed default input data to use 2017USD
• config default for c60_bioenergy_subsidy changed from 369 to 246 USD17MER per ton
• config SHAPE scenarios start year of dietary shift changed to 2025
• config updated input data to rev4.114
• core number of age-classes doubled from 150 to 300 years for better match of growth curves with potential natural vegetation.
• extra/disaggregation Peatland now considered in disaggregation of land pools
• inputdata changed GDP base year from 2005USD to 2017USD
• module_documentation all references to USD05 changed to USD17
• modules update of scaling factors in several modules
• scripts NPI/NDC policies synced to the year 2025 - update of additional data to additional_data_rev4.59.tgz
• scripts REMIND coupling reads data in US$2017, not US$2005
• scripts renamed disaggregation_mrdownscale.R -> mrdownscale_LUH2.R

added

• 32_forestry added option s32_npi_ndc_reversal
• 35_natveg added option s35_npi_ndc_reversal
• 56_ghg_policy added new interface pcm_carbon_stock to avoid use of vm_carbon_stock.l in equations
• 58_peatland added option for exogenous peatland rewetting
• 62_material added switch to turn off future material demand for bioplastic
• config added SSP1-POP-GDP SSP2-POP-GDP and SSP5-POP-GDP
• modules[29-35] added initial values for ov_bv for better starting point
• scripts add mrdownscale script (0.5deg downscaling using LandUseInit as reference)

removed

• 13_tau removed interface fm_pastr_tau_hist
• 31_past removed grasslands_apr22 realization

fixed

• 10_land Simplified land transition matrix for improved feasibility
• 11_costs changed equation to fix bug in total water cost calculation
• 28_ageclass bugfix input data unit and code clean-up. Renamed feb21 realization to oct24
• 29_cropland treecover age-class growth was not working properly because ac_sub was erroneously not fixed
• 44_biodiversity bugfix biorealm_biome.cs3 in input data (shares did not add-up to 1)
• 56_ghg_policy Fader for GHG emission pricing policy
• 70_livestock bugfix scaling.gms file in wrong folder
• config additional data increased to additional_data_rev4.58.tgz which fixes missing gdp2017 conversions in f20_processing_unitcosts
• config settings in default.cfg for some switches in 73_timber did not work correctly
• scripts script/output/extra/resubmit.R

MAgPIE 4.8.2

[4.8.2] - 2024-09-24

changed

• 15_food revision of MP/SCP implementation for milk and meat alternatives. Added demand for fat and sugar as ingredients for MP-based milk alternatives. Added optional demand for fat as ingredient for MP-based meat alternatives.
• 21_trade refactor equations for enhanced readablility and improve documentation
• 29_cropland added option for linear and sigmoidal faders
• 32_forestry Interfaces vm_landexpansion_forestry and vm_landreduction_forestry have been corrected by harvested and replanted timber plantation area
• 58_peatland variable v58_scalingFactorExp converted into parameter p58_scalingFactorExp to avoid infeasibilites. p58_scalingFactorRed has been revised.
• 80_optimization abort GAMS in case of execution errors, added threads = 1 as default to avoid infeasibilites and Flg_NoDefc = TRUE as option
• config cfg$gms$land_snvchanged from "secdforest, forestry, past, other" to "secdforest, other"
• config additional data update additional_data_rev4.53.tgz
• config default settings for 58_peatland revised
• config initial treecover on cropland starts from zero
• config split scenario_config into project-specific configs
• config Submissions with high memory requirements now get 16 CPUs and 80GB of memory to account for the new specifications of PIK's new HPC 'Foote'. maxMem was renamed to highMem, because 80GB of memory does not correspond to the maximum available memory of a compute node.
• config The default realization for the 38_factor_costs module was switched to sticky_feb18. In this realization, capital stocks and their depreciation are tracked, giving some inertia to random relocation of production, improving high resolution outputs.
• script replaced gdx package with gdx2 package calls
• script scripts/start_functions.R decide individually for demand and price whether they are read from a REMIND report.
• script updated EATLancet project start scripts
• scripts .nc files are no longer created by default after disaggregation
• scripts output/extra/highres.R use default 13_tc realization
• scripts rewrite of merge_report.R based on rds files and rbind, which allows for more flexibility when merging reports. Avoid inconsistent use of "GLO" instead of "World" in report.rds files.

added

• 42_water_demand added water abstraction type dimension for non-ag uses
• 56_ghg_policy added optional temporal and regional fader for GHG emission pricing policy
• 70_livestock added realization fbask_jan16_sticky
• config added scenario_config_year_fix.csv for choosing until when parameters are fixed to SSP2 values
• cropland added option for discarding initial treecover on cropland
• script added output script for conversion of validation.mif file into validation.rds
• script check of variables needed in piamInterfaces in report_rds.R
• script for downscaling to 0.25 deg using LUH2v2h as reference via mrdownscale
• scripts added out of bounds check as output script
• scripts added output report EU_report.R that uses EU_report.Rmd
• scripts added output script converting all grid-level .mz files to .nc (netCDF)
• scripts added script for automatic submission of SEALS allocation runs ./extra/runSEALSallocation.R
• scripts added start script for 'Healthly Landscapes' paper paper_healthyLscps.R

fixed

• 15_food fixing parameter declaration of i15_processed_kcal_structure_iso
• 35_natveg bugfix secdforest and other land restoration to avoid double-counting of restoration in equation q29_land_snv
• 80_optimization bugfix for variables levels not obeying the bounds in nlp_par, conopt changed to conopt3
• scripts fixing an error in start.R and output.R which occurred if more than one slurm job was submitted at the same time.

MAgPIE 4.8.1

[4.8.1] - 2024-06-19

notes

• for running MAgPIE without POP/GDP update, change all instances of rev4.109 to rev4.107 in these two files: config/default.cfg and config/scenario_config.csv
• rev4.108 should not be used anymore because MER-GDP was wrong and was identical to PPP-GDP

changed

• 29_ageclass module 29_ageclass has been renamed to 28_ageclass to make space for 29_cropland just before 30_croparea
• 30_crop module 30_crop renamed to 30_croparea, which now only accounts for crop area.
• 30_crop Semi-Natural Vegetation (SNV) implementation has been moved from 30_crop to 29_cropland
• 30_crop the previous 30_crop/endo_apr21 realization has been moved to 30_croparea/simple_apr24
• 30_crop the two realizations penalty_apr22 and rotation_apr22 have been merged into a single 30_croparea/detail_apr24 realization
• default.cfg update additional data to rev4.51
• scripts adjusted SLURM job handling
• scripts updated EL2p0 start scripts

added

• 10_land added interface pm_land_hist with historic land use patterns
• 29_cropland new module 29_cropland accounting for crop area, fallow cropland and tree cover on cropland with two realizations: detail_apr24 and simple_apr24 (default).
• 42_water_demand added non-agricultural water demand for entire year

removed

• 32_forestry removed technical balance term v32_land_missing_ndc

fixed

• 22_land_conservation avoid infeasibilities due to very small numbers, account for cropland tree cover and lower bound of cropland
• 32_forestry avoid infeasibilities due to very small numbers
• 35_natveg avoid infeasibilities due to very small numbers
• 44_biodiversity Fixing to SSP2 parameters until 2025 was not working
• config update to input data rev4.109. In the previous rev4.108, MER GDP was wrong and was identical to PPP GDP

MAgPIE 4.8.0

[4.8.0] - 2024-06-10

changed

• 14_yields revised timber yield calculations
• 15_food, default.cfg and scenario_config.csv changed fader setup and introduced new switches for specifying food substitution scenarios and exogeneous food intake scenarios
• 22_land_conservation and default.cfg Added options for baseline protection
• 32_forestry renamed interface pm_demand_ext to pm_demand_forestry
• 32_forestry revision and simplification of forestry implementation, renamed realization from dynamic_feb21 to dynamic_may24.
• 35_natveg vm_land(j2,"forestry") included in NPI/NDC constraint q35_min_forest
• 35_natveg replaced the realisation dynamic_feb21 with realisation pot_forest_may24. The new realisation provides additional information on the potential forest area, which is now used to constrain forest and forestry expansion and recovery. The remaining area for forest establishment is provided to the forestry module via the new interface parameter pcm_max_forest_est.
• 41_area_equipped_for_irrigation updated (non-default) AEI data (from Mehta2022 to Mehta2024)
• 52_carbon Separate carbon densities for forest and other land. Before there was only a single carbon density for natural vegetation land.
• 70_livestock default.cfg and scenario_config.csv** changed fader setup and introduced new switches for specifying feed substitution with SCP scenarios
• 80_optimization Simplifed cycling through CONOPT4, CONOPT4 with OPTFILE, CONOPT4 without preprocessing and CONOPT3.
• default.cfg changed default realization for 44_biodiversity to new realization bii_target_apr24
• default.cfg defaults for cfg$gms$sm_fix_SSP2, cfg$gms$sm_fix_cc and other switches changed from 2020 to 2025
• default.cfg Forestry sector included by default by using the ForestryEndo settings from scenario_config.csv: s32_initial_distribution = 1, s32_demand_establishment = 1, s32_hvarea = 2, s35_secdf_distribution = 2, s35_hvarea = 2, s73_timber_demand_switch = 1
• default.cfg update additional data to rev4.50
• scripts modified agmip_merge_report to use piamInterfaces
• scripts start/test_runs.R added 2 more test runs from FSEC

added

• 15_food added additional sigmoid food substition scenarios sigmoid_75pc_25_50, sigmoid_50pc_25_50 and sigmoid_25pc_25_50
• 21_trade Minimum trade margin for forestry products s21_min_trade_margin_forestry
• 30_crop added regional cropland equation q30_crop_reg and presolve growth constraint
• 44_biodiversity added new realization bii_target_apr24, taking into account f44_rr_layer
• 60_bioenergy added new realization 1st2ndgen_priced_feb24 to enable price-driven 2nd gen bioenergy production
• 73_timber added interface im_timber_prod_cost
• citation added abstract
• core added coup2110timesteps
• default.cfg added cropland growth constraint cfg$gms$s30_annual_max_growth
• default.cfg added settings for new price-driven bioenergy realization 1st2ndgen_priced_feb24: cfg$gms$s60_2ndgen_bioenergy_dem_min_post_fix, cfg$gms$c60_bioenergy_subsidy_fix_SSP2, s60_bioenergy_gj_price_1st,
• default.cfg added technical cost for missing BII increase cfg$gms$s44_cost_bii_missing
• default.cfg cfg$gms$s80_secondsolve option for second solve statement with 0=off as default
• scenario_config.csv added preset for GENIE project
• scripts added "checkSummation" output script for consistency checking a report.mif
• scripts added automatic set writer for new bioenergy realization to start_functions
• scripts added start scripts for the GENIE project
  s60_bioenergy_price_2nd, c60_price_implementation

removed

• 14_yields removed interface pm_timber_yield_initial
• 21_trade removed interface pm_selfsuff_ext, removed v21_manna_from_heaven
• 32_forestry removed interface pm_representative_rotation
• 35_natveg removed growing stock calculation and calibration, which is no longer needed.
• 62_material/16_demand Removed double structure for forestry products. pm_demand_foresty is now used in 62_material
• 73_timber removed interfaces pm_demand_forestry_future and sm_wood_density
• scripts removed support for spam files in start_functions
• scripts/output/extra removed scripts disaggregation_cropsplit and disaggregation_transitions

fixed

• 14_yields fix division by zero in preloop of managementcalib_aug19
• 44_biodiversity avoid division by zero
• 58_peatland Added balance variable to avoid random infeasibilites
• 80_optimization fixed a bug in nlp_apr17; cycling through CONOPT4, CONOPT4 without preprocessing and CONOPT3 was not working
• extra/disaggregation fixed bug in disaggregation of land conservation related to switch from 59k to 67k that produced erroneous outputs
• scenario_config.csv same revision for input files as in default.cfg
• scenario_fsec.csv scenario settings
• scripts/start/test_runs.R include all default output script, in particular disaggregation.R, which is needed for BII
• start/projects/fsec.R scenario settings

MAgPIE 4.7.3

changed

• 21_trade Revision of trade module. Replaced cfg$gms$s21_trade_bal_damper in favour of cfg$gms$k_import21, which allows for additional imports to maintain feasibility
• 21_trade v21_import_for_feasibility now available for all countries, not just for importers
• 70_livestock if c70_fac_req_regr is set to reg: use of USDA/FAO values for historic factor requirements for livestock instead of using regression values and change of calibration year from 2005 to 2010 for regional factor requirements regression
• config updated FSEC scenario config for revision and included new calibration file (after cost fix in preprocessing)
• default.cfg updated inputdata revision to 4.104 to have NDC scenarios included
• scripts cfg$gms$s35_secdf_distribution <- 2 for FSEC
• scripts modified output reporting for SEALS to account for forestry plantations
• scripts/calibration/landconversion_cost.R Revised calibration approach for conversion costs for cropland. Information from all calibration time steps in combination with a lowpass filter is now used for deriving the calibration factors, which avoids the previous zickzack pattern. The previous option cfg$damping_factor_landconversion_cost has been removed in favor of cfg$lowpass_filter_landconversion_cost.

added

• 14_yields added minimum threshold for wood yields. Below this threshold, wood yields are set to zero.
• config added switch for minimum timber yields
• 56_ghg_policy added NDC scenarios
• 60_bioenergy added NDC scenarios
• scripts start script for EAT2p0 Deep Dive project

fixed

• 15_food Small number rather 0 in condition checking calorie balancing
• 34_urban static realization was not working because vm_carbon_stock was referenced without the set stockType
• 52_carbon removing jump of carbon content into fully grown forest when a forest changes from second-last age class to last age-class.
• 58_peatland Equation q58_scalingFactorExp revised to avoid division by zero.
• 80_optimization duplicated solve statement in all instances to avoid non-matchting left- and right-hand sides of equations

MAgPIE 4.7.2

[4.7.2] - 2024-04-02

changed

• 21_trade Revision of trade module. Replaced cfg$gms$s21_trade_bal_damper in favour of cfg$gms$k_import21, which allows for additional imports to maintain feasibility
• 58_peatland Threshold in equations changed from 1e-10 to 1e-8 to avoid rare divisions by zero
• 70_livestock if c70_fac_req_regr is set to reg: use of USDA/FAO values for historic factor requirements for livestock instead of using regression values and change of calibration year from 2005 to 2010 for regional factor requirements regression
• config updated FSEC scenario config for revision and included new calibration file (after cost fix in preprocessing)
• scripts modified output reporting for SEALS to account for forestry plantations

added

• 30_crop Improved representation of cropland requiring relocation in response to introducing semi-natural habitat at the 1 km level based on high-resolution satellite imagery.
• config added .codeCheck with additonal configuration when running gms::codeCheck
• scripts add additional BII reporting variables in FSDP_collect.R
• scripts added a new validation_cell.R output script that generates a pdf with the comparison of magpie land use and crop type outputs with LUH and MAPSPAM historical data at cellular resolution.

removed

• core removed no longer needed set si Suitability classes

fixed

• 52_carbon i52_land_carbon_sink was not identical before 2020 for different RCPs. Fixed by setting to RCPBU until the year defined in sm_fix_cc.
• inputdata currency fixed in historic value of production for crops and livestock which affects e.g. total labor costs and in turn hourly labor costs, bugfix in aggregation weight of capital cost share out of factor costs