3 May 2017 – APSIM 7.9 Release Notes

3rd May 2017

APSIM changed to use Microsoft Visual C++ 2015

APSIM has been changed to use Microsoft Visual C++ 2015. The implications for users is that the installation process can be more complicated. The APSIM Installer will check for Microsoft Visual C++ 2015 and attempt to install it if required. On versions of Windows before Windows 10 (i.e. Windows 7, 8, and 8.1) it may be necessary for the user to manually install Microsot KB2999226 (Update for Universal C Runtime in Windows).

This update can be found here

For this to succeed though, it may be necessary to update Windows via Windows Update. For example on Windows 7, we have found it necessary to install Windows 7 service pack before installing the above update.

Enhancements to the root development routines and water extraction routine in APSIM-Cotton

APSIM-Cotton is extensively based on the OZCOT (Hearn, 1994) cotton model. OZCOT was designed with a very empirical approach to root development. The equations used were developed for the heavy clay soils at Myall Vale, NSW Australia and the only variables that are used to estimate rooting depth are the depth of the soil profile and the Days After Sowing (DAS). Plant growth, environmental conditions and soil hospitality for root growth play no part in the root development. This was a legacy of the OZCOT model and was not consistent with the approach used for other models in APSIM. In order to implement the standardised APSIM approaches for soil water uptake and root development which utilise the “kl” extraction factors and “xf” soil constraint factors for each soil layer, the cotton model required modifications.

Click here for more detail.

New biochar model for APSIM

A biochar model has been developed and incorporated into APSIM by Iowa State University. This can be found by clicking on “New” in the APSIM user interface, selectng the Biochar folder and opening the .apsim file. For more information read:

Archontoulis, S.V., Huber, I., Miguez, F.E., Thorburn, P.J., Rogovska, N., Laird, D.A., 2016. A model for mechanistic and system assessments of biochar effects on soils and crops and trade-offs. GCB Bioenergy 8, 1028–1045. doi:10.1111/gcbb.12314

Changes to command line programs

The syntax of several command line programs has been extended to allow specification of factorial instances. These instances are additions to the simulation path argument, of the form

Simulation=/path/to/simulation@factorial=factor1=level1;factor2=level2

The program Apsim.exe accepts multiple .apsim, .con and .sim filenames, one optional simulation argument, and optional doAllFactors=(bool), and MaxOutputLines=(int) arguments. If the simulation arguments first character is the “@” character, it is interpreted as a filename containing a list of simulations to perform – one per line.

The program ApsimToSim.exe accepts the first argument as an apsim file for conversion, and one optional simulation argument. It writes the name of the output file written to standard error.

The program ApsimModel.exe accepts the first argument as an .apsim or .sim file, and one optional simulation argument. If no simulation argument is given, only the first simulation will be run. The standard output stream is the summary information of that simulation, which Apsim.exe usually saves.

Apsim.exe attempts to convert (via ApsimToSim) and run (via ApsimModel) simulations in parallel. The number of parallel instances is determined by the environment variable NUMBER_OF_PROCESSORS.

The program BundleApsim.exe creates a zipfile for submission to remote batch processors such as condor or PBS. Its default parameters are taken from the GUI’s “Run On Cluster” form. Inside are a .sub file for condor, and a .pbs file for PBS, both may require hand edits for the local installation.

List of all changes and fixed defects

The complete list of changes to APSIM can be found here