What's new

We continue to maintain and improve CLEM providing fixes, new features and new components as required while APSIM is also continuously improved over time. These changes are available with each Upgrade of APSIM Next generation which are available from the Upgrade button on the Main menu. You may be requested to provide your details before upgrading to the latest version.

Always make a backup of your simulation files (*.apsimx), before opening in an upgraded version. If you need to downgrade to a previous version of APSIM any simulation files that have been run or saved in a later version will not open.

We recommend saving the full descriptive summary from your simulation. At present the automatic saving of this file is not enabled. Select the CLEM component, select Summary Tab, click the link to Descriptive summary. When presented with the summary in your favourite browser, right click on the screen and select save as. Save the file [yourfilename].html. This will allow you to open the file and see all your settings if you have to reset values after the upgrade.

This page outlines the important updates provided to date and any changes you may need to make to your simulation set up files.

Version numbers

You can use the current release number of the APSIM Next Generation framework as the overall CLEM version for reporting and citation purposes. Anyone will be able to install, or revert to, this version number to run your simulations in future. Each CLEM component also provides a version numbers with a history of changes made to the component. You can view the current version of any component by selecting the Version tab in the main display area after selecting the component in the simulation tree.

 

I am currently working with individual project simulations as opposed to pure model development. This validation and checking task will help me highlight any potential issues and I will fix and improve user interface, descriptive summaries and code logic as I proceed. I will inform you of any updates that may result in changes to your output.

Adam

Important updates and notes from the developers

Upgrade number Component(s) Description of changes
   

NOTE! This help system will not be updated after 21 June 2023 while we find new software to manage our reference system and user guide due to the current subscription-based licensing becoming too expensive. Please contact us if you have any questions about the current versions of CLEM and changes appearing in the APSIM Upgrade pathway

Current known issues

 
  • Reports generate error when there is a space in the reporting variable or event. Replace [Resources].Ruminants.Bos indicus.Property with [Bos indicus].Property in the report section. This issue is currently being addressed by APSIM.
2023.06.7253

Ruminants

Pasture

Rum. Attributes

Summary report

BuySell

2023.03.7175 Herd management

Adjusting herd numbers at the start of the simulation:

The Manage ruminants activity can automatically adjust herd numbers in the initial cohorts at the start of the simulation to reflect the desired minimum number of breeders kept to maximum number of breeders kept. This functionality is improved in this update to not only adjust male and female breeder numbers, but also allow for the adjustment of the remainder of individuals such as sucklings, weaners, pre-breeders in proportion to the proportional change in female breeders, thus scaling the initial herd to the required breeder numbers. This is a useful tool when running an Experiment across a range of herd sizes as the herd can scale to the number of breeders needed.

Reporting of herd adjustments is now provided in Information messages from the simulation (see CLEM component/messages) rather than in the herd ledger.

2023.02.7146 Ruminant growth We are checking the ruminant energy from feed and growth functionality to ensure it is up to date with latest Nutrient requirements of domesticated ruminants. This will allow better handling of supplements and assigning gross energy and protein degradability based on the feed type.
  • The impact of crude protein (CP) on digestion, energy relations and growth was not being applied. We are still investigating the best approach for handling the impact of CP supply. The model now implements a reduction in energy from intake by around 23% when consuming the poorest pasture with Dry Matter Digestibility (DMD) of around 42% (the same as NABSA).

This upgrade will affect your results: Intake and therefore growth will be reduced when feed quality has a low DMD.

2023.01.7136 Ruminant growth This upgrade addresses a bug identified in the calculation of energy required per kg of weight gain for ruminants.

This upgrade will affect your results: The corrected weight gain for ruminants is lower than previous versions. Check all simulation outcomes as growth will impact other aspects of herd management and finances.

2023.01.7136 CLEM The CLEM component will now report that a multiple simulation experiment was last run in the Messages tab and report all errors and warnings generated during the experiment simulations with the associated name.
2023.01.7133 Ledger report This fixes the report value (financial) of the resource when gained or lost in the Ledger Report.
2022.12.7130 Trucking
  • Issues identified with loading ruminants onto multiple trucks addressed. Improved Descriptive summary reporting for trucking.

  • No longer ignores activities or timers that are not needed in the Activities performed report but shows empty row with a warning in setup column

2022.12.7129

Ruminant level timer

Ruminant reporting

This update adds a Ruminant level timer that allows you to compare a specified value against the number of unique individuals, or the sum, mean, minimum or maximum value of a property of Individual ruminant in the filtered group.

Reporting the location of individuals is now included

  • The Resource ledger report now includes Location as a reported property when Resource Group is set to the Ruminant herd. This represents the location of the individual when added or removed from the simulation.

  • Ruminant herd summary now includes an option to include the location of individuals in the grouping rules for reporting. This allows summaries based on paddock (Location) provided as a column in the output database table.

The Resource ledger report now includes a range of switches to determine which properties of Individual ruminant are included in the report. These are only visible when Resource Group is set to the Ruminant herd and can significantly reduce output database sizes when simulating large herds by removing unneeded output columns.

You will need to set all Ruminant properties that you needed included in the Herd Ledger using the new switches

2022.11.7126 Various

New features

  • The HTML (web browser) version of the Activities performed report now includes status messages as tooltips (displayed when ouse cursor hovers over cell) identified by a red triangle in the upper right corner of the cell

Fixes a few identified bugs

  • Incorrect calculation of minimum and maximum labour rates for AsRatePerUnitsAllowed in Labour requirement

  • Removed error reported when no pasture is available in ecological indicator period is one month

  • Fixed to include OnErrorAndStop or Skip when shortfall of land during manage pasture initialisation

2022.11.7124 Grazing systems

The following improvements and fixes have been made for grazing systems

2022.11.7114 Labour allocation

While checking issues with labour allocation across multiple hired people some issues were detected and the labour allocation process was found to be confusing to the user.

  • Checked and fixed labour allocation in Labour requirement

  • Improved labour required property descriptions and added tool tips that are available for clarification in the user interface

  • You may need to reset the Labour limiter style of Labour requirement from perUnitAllowed to the new AsRatePerUnitsAllowed wherever set.

  • Removed extra "full stop" (.) at end of transaction category from labour allocations

  • Fixed linkage of resource type specified in Manage external resource multiplier to Manage external resources

  • Changed Resource shortfalls report to report required and available rather than provided as provided is often 0 at the time of presenting errors

  • Updated shortfall status reported for labour shortfalls

2022.11.7109 Manage external resources

Some fixes have been made to the recent update of Manage external resources and Manage external resource multiplier as these were reported to have some bugs

  • Fixed linkage of resource reader to manage external resources

  • Fixed filtering of specified resources

  • Ensured validation errors for manage external resources are displayed

  • Fixed error message when an invalid units of measure is specified in a Companion components.

A updated general approach to naming units of measure used across manage crop product and crop task components

You will need to reassign some of the units of measure assigned to Manage crop product and Crop task activity to the new land units of crop, hectares of crop, land units harvested or hectares harvested

2022.11.7106 Ruminant trucking

The Apply trucking component used in Buy and sell ruminants has undergone a full code check and improvements to meet user requirements. This section had never been fully implemented and was causing some issues for the couple testing users. This component now fully supports the Insufficient resources available action with implications for individuals transferred by the parent buy/sell activity. Advanced simulations where resource limitations below a trucking component will not feed back through the trucking component and onto the buy/sell activity as this requires a full reallocation of individuals to all available trucks with the new limits considered, but the accounting of resources is correct prior to needed reallocation. This will be implemented as required.

Management of both buying and selling tasks in the one instance of the Buy and sell activity was resulting considerable duplicate code and becoming increasingly difficult to manage. For this reason the act of managing purchases (buy) or sales (sell) is now specified by a new ActivityStyle property and you will require separate instances of Buy and sell ruminants to manage purchases and sales.

New approach to buying and selling ruminants is required

You will now require separate instances of the Buy and sell ruminants activity to manage purchases and sales which is specified in the ActivityStyle property of each component

Fixes

2022.10.7104 Manage external resources
  • This upgrade requires 2022.11.7106 (above) to be fully implemented

    New functionality has been added to Manage external resources that allows for the identification of resources to be considered if present in the resource input file.

  • A new Manage external resource multiplier component has been added to modify the amounts provided by a resource filefor a specified resource.

2022.10.7097

ReportPivot and ReportQuery

and weaning

Fixed

  • Report pivot and Report query components were generating errors when no database had been created (or empty datasource) and an Experiment run is performed. These reports now generate their database View after the experiment multiple simulations are complete and the database has been written

  • Added missing filter identifier for Manage ruminants and renamed filter names for clarity. If you have been using custom filters to further restrict animals in manage ruminants, you may need to change the value selected.

Improved functionality

  • The sale of weaners is now possible for enterprises needing to sell/agist weaners

2022.09.7088 Resource purchase and Grow out females

Fixed

  • Buy resource activity was not producing a financial transaction.

  • Companion components were not able to access the "Adjust - new grow out females" measure from Manage ruminants

  • Added ability to Identify iteration number to skip shuffling rainfall allowing the historic rainfall sequence to be included in experiment runs.

2022.08.7078 Reporting
  • The Pasture pools report has been updated to remove the need for custom code to define properties reported. This report has been updated to include a range of pasture-based, and pool-based reporting properties as well as switches to report in tonnes (rather than kg) and per hectare.

  • Ruminant herd summary now includes a group by Sex and Class which will include sex for Report pivot. Please ensure your group style setting is correct after the new entry was added to the list. This will affect age-based grouping.

  • Fixes to avoid errors on creation of database views from some Report query and Report pivot, especially when no database is created.

  • All ruminant reports now validate the Graze food store type specified to place individuals in where appropriate.

  • Fixed Pasture data reader SQLite when working with Rainfall shuffler

  • Allow multiple Relationship with the same name to display graphs in descriptive summaries

2022.08.7076

Ruminant Purchase and

Reporting

Implements the recently added Arrange ruminant purchase activity to work with ruminant cohorts and manage trade herd purchases

Also

2022.08.7074 Pivot Report Fixes errors thrown during large experiment runs using Report pivot
2022.08.7072 Grazing

Fixes issue with calves and weaners not putting on enough weight.

  • Calves are no longer allowed to be fed, even supplements, unless they have a determined potential intake above the milk intake.

  • Pasture now correctly accounted for in calf intake and growth

2022.08.7070 Grazing

Additional bugs reported from the identifiable component (end of development) release are provided here.

  • Pasture quality was not provided to ruminants and so pasture energy was limited

  • Fine tuning of applying growth and potential intake calculations to sucklings, orphans, weaners and all other individuals.

  • New Grazing efficiency report provided

2022.08.7065 Weaning and grazing

Changes to the timing and definition of the weaning terms have been made. Orphaned individuals (mother moved without suckling offspring, sold or died) are no longer considered weaned but remain in the Suckling class with only access to limited forage based on age. Individuals will only be considered weaned if they meet the criteria of a Wean ruminants activity or undertake natural weaning. The IsWeaner property and Weaner class remain weaned individuals less than 12 months old after which they are considered a Pre-breeder.

This upgrade also provides the following fixes and improvements:

  • A new property has been added to Resource shortfalls report the specifies a cut-off shortfall of pasture as a proportion of the herds desired intake before it will be reported as a shortfall

  • Inferring pregnancy state at start up was not correctly considering the timers associated with Controlled mating resulting in births outside expected time frames.

  • Natural weaning happens at the start of the month after age criteria is met to allow management weaning to occur if required.

  • New ruminant property IsSucklingWithMother determines if a suckling still has milk from mother.

  • Updated the RelatesTo reporting in Buy and sell ruminants

  • Fixed the Status reported for Graze ruminants when insufficient pasture is available. This will report the warning icon when no pasture is available.

2022.07.7065 Transaction categories

The Transaction category functionality has been improved. This functionality was never fully completed. You now have control over automatically generating Transaction categories from the tree structure, even using component names, and reporting category levels as separate columns in Resource ledger report with user-specified column names.

This upgrade also provides the following fixes and improvements:

  • Issue where no last harvest tag provided for rotational cropping

  • Improved pasture management when using Manage crop method. Now allows multiple Manage crop product to point to single Graze food store type as long as using timers to ensure only a single activities is used in any time step.

  • Fixed initialisation of pasture biomass when using Manage crop product (only first of multiple instances fort he same Graze food store type will initialise)

  • Fixed issue with Ruminant feed group not working correctly after previous upgrade introducing Companion components

  • Included ecological indicator reporting in pasture managed by Manage crop product (e.g. utilisation)

  • Improved reporting of shortfall in pasture grazed from both required and desires levels (were reduced by tropical pasture quality)

  • Removed unneeded "available" column from Resource ledger report

  • Fixed switch to allow losses to be reported as negative values in Resource ledger report

  • Updates to many Relates to reporting values with unneeded entries removed

  • Missing entries of Activity or Relates to now reported as NULL in Resource ledger report

2022.07.7059 Ruminant activities

This upgrade addresses the following issues identified after 2022.06.7045:

2022.06.7045 All activities

This is a significant upgrade!

We recommend an additional installation of APSIM Next Generation to test this version on sensitive project simulations and where you are working with important simulations from previous versions

Automatic simulation file conversion!

Your simulation files will automatically converted to this version when first opened in this update. We recommend you backup all simulation files prior to using this version as they will NOT be backward compatible with older versions once opened and saved

This upgrade represents the final changes made to the development process and implements the generic activity approach with access to fees, labour and identifiers linked to parent activities. For this we introduce the concept of Companion components to provide more functionality to your activities.

While we have tested each component the significant code changes in this upgrade may have introduces some issues that will need to be addressed.

Upgrade of activities and use of fees and labour

  • During this process every activity is being refactored to the new approach and fully checked. This new style will remove drop down options that do not relate to the activity. This update will also make adding new features easier in future and simplifies performing activities in clock events other than GetResources
    • Most ruminant activities (where appropriate) now allow Pay herd fee and Labour requirement based on the numbers (fixed, per head and even per AE) of animals used in activity
    • GrazeAll, GrazePasture, GrazePastureHerd - updated and fixed bug limiting pasture eaten by sucklings off milk
    • The model now determines what activities must supply a Ruminant group (i.e. you must specify which individuals the activity will act upon) and also where the default filtering is assumed (see help of each activity for details). This ensures you are aware of the individuals being processed in activities such as Mark ruminants for sale and Manage ruminant tag where you will need to add an empty Ruminant group in order to specify the entire herd is requested.
    • A new OnPartialResourcesAction UseAvailableWithImplications allows the shortfall of resources such as labour and finances to reduce the activity where available.
    • Full upgrade of Descriptive Summaries to account for all changes

New features

Improvements

  • Improved Apply trucking for transporting ruminants with custom truck and trailer configurations and multiple trucks for sales and purchases
  • Added new MonthsSinceWean and MonthsSincePurchase properties of ruminants.
  • Cut and carry limiter is now Carry limiter to allow for use across a range of weight limited activities
  • Access to, and identifying Relationships in activities
  • Ability to specify whether you want to perform stocking and destocking tasks in Manage ruminants to allow destocking and restocking to be performed at different times.
2022.04.7029 Attribute individuals
  • Fixed incorrect reporting of missing Report model as child of Ruminant attribute summary and prevents creation of multiple erroneous reports in simulation file
  • Allow random sort at any position in Ruminant group so herd can be shuffled before proceeding to remove any order determined by herd creation
  • Added a Set attribute from herd component that implements herd based attribute value (mean, min, median etc) for males mated in controlled mating

2022.04.7021

Animal pricing
  • Fixed issue identified with incorrect pricing being applied to Ruminant purchases and sales.
  • Fixed bug where using Take and Skip components on a Ruminant group returned no individuals (when style set to TakeIndividuals)

2022.04.7021

Managing crops
Relates to APSIM Issue #7130

Other

  • Ensure sucklings weaned if mother dies. There is no surrogacy in the model at present.
  • Added new SexAndClass property to Ruminants to allow sex based suckling, weaner and breeder reporting

2022.04.7021

Managing transmutation
  • Fixes an issue where Transmute ByPrice and Direct were not working properly. Please let us know if this causes any issues with your transmutations.
  • Allows interval of 1 (monthly) for Interval timer. Note, this is effectively the same as not having this timer.
  • Minor labelling improvements to property labels
  • Fixes issue where validation issues did not raise and error and stop simulation.
2022.02.7017 Manage ruminants

Significant changes made to the components outlined below. This upgrade implements new functionality. You will need to set some values in the user interface and should read your entire simulation summary description to identify current tasks and new features that may be turned off. See warning at top of page about creating a backup of your simulation files and summary description

The Manage ruminants activity has undergone a significant upgrade to implement the requirements of current users including:

  • Ability to specify which tasks are performed by the activity
  • Added a new example simulation showing the main actions performed in Manage ruminants while performing sensibility tests
  • Improved order of validation in events to allow some post validation processes
  • Improved custom filtering of individuals for all tasks (see Custom filtering of individuals)
  • Updated descriptive summary to reflect changes
  • Wean ruminants and Manage ruminant tag now require at least one Ruminant group to identify individuals and are performed in the Animal mark event
The help system has been updated to reflect all changes

Other improvements:

  • Added missing help link to filter components
  • New multiple categories feature in Property tab
  • Fixed error reported when moving around simulation tree
  • Fixed reporting and display of validation errors that had stopped with a recent APSIM update
  • By special request each CLEM component now includes a Notes property for easy commenting and less need to include Memos
  • First month of financial year property and FinancialYear properties added to Finance for reporting with an Include financial year switch in Resource ledger report
  • Replaced IsCalf and the Calf class with IsSuckling and Suckling class to reflect multiple ruminants types. FIX: While this change should happen automatically, you will need to change any text entries of "Calf" in filters and queries. You will be given an error when you try to use IsCalf in filters.
2202.02.7011 Various
  • Fixed issue with castration task missed in some months
  • Changed the timing event of HumanFoodStoreTypes in Feed people to targets
  • Fixed typos and improved descriptions
2022.02.7009 Human feeding

2022.01.6993

Herd management
  • Fixed incorrect sale of breeding sires when adjusting the herd at start up
  • Updated the sale reason property used in Mark ruminants for sale. This replaces the current MarkSaleReason property with a HerdChangeReason property to avoid conflicts in future. A check will be performed to ensure you select a sale reason.
  • You will have to reassign all sale reason fields in Mark ruminants for sale activities of your simulation
  • Updated description of minimum size for first mating (proportion on SRW) for clarity
  • Updated help to reflect previous removal of the overhead switch property in Pay expense
  • Removed redundant Category property from Ruminant herd cost as now uses TransactionCategory
2022.01.6992 Reporting
  • Fixed report dollar value causes error in Resource balances report

  • Fixed report transactions by price group causing error in Resource ledger report

  • Fixed problem where "serialising delegates not supported" error occurs on the second run of a simulation linked to filtering rules built in UI for descriptive summary

2021.12.6990 Ruminant breeding
  • Fixes error selecting not ready for breeding females to report and therefore ensures full accounting in conception status report.
  • Randomises pregnant females for conception to avoid list order issues
2021.12.6987 Labour in small farm simulations

Included in (2021.11.6983)

Note new version numbering!

Breeding statistics, attributes (genetics)
  • Checked and fixed conception reporting (easy analysis of birth and weaning rates)
  • Checked and fixed reporting of male attributes and ignore missing values to better herd outputs
  • Various improvements to descriptive summary to report on new features
  • Added Ruminant group styles that allow for custom filtering and selecting of individuals in management decisions. For example selecting breeders to sell to reduce her, or the order in which individuals are identified as replacement breeders (i.e. by condition or genetic merit).
  • Further check and validation of Breed ruminants and Manage ruminants
  • Added switch to allow you to turn of return of pregnant females from max age sale pool when breeders needed.
  • Further validation checks and general CLEM user experience improvements
  • Updates and fixes to relating to new icons
Included in (2021.11.6983)

Feed people to targets, Transmute, Resource pricing

Various fixes and improvements applied to run multi-farm/shared market simulations and targeted feeding of farm family

  • Problem with price based transmute when using FinanceType fixed
  • Problem with reading resource pricing from resource price file fixed
  • Improvements made to the process of feeding people on a farm to specific target levels (e.g. energy)
  • Fixed bugs in applying cohort based labour calculations. Will also allow decimal numbers rather than integer counts.

26/11/2021

(2021.11.26.6976)

message reporting APSIM now allows the user to determine the level of messages reported by models (in the Summary component). This upgrade provides the appropriate messages type to each CLEM messages; error, warning, information. It also fixes issues with the display of message in the messages tab of the CLEM component since a recent upgrade.

26/11/2021

(2021.11.25.6963)

User interface

Updated icons for new .net core APSIM next generation user interface

25/11/2021

(2021.11.25.6962)

Filtering individuals

This upgrade provides improvements to the new approach for filtering individuals

  • Simulation time has been reduced to 25% of previous versions providing benefits for those simulating large herds
  • Validation has been improved to assist with setup and trap more issues to avoid unhelpful error messages
  • A default value to be used in SortByAttribute has been added to apply when the specified attribute is missing from an individual
  • A filtering example with reporting of testing performed is now included in Examples/CLEM

Various minor fixes

  • Mark ruminants for sale now requires a Ruminant group to identify individuals to mark. An empty Ruminant group is now needed to request the entire herd for the task.
  • Some typos and wording addressed in Descriptive summaries and warnings

16/11/2021

(2021.11.16.6943)

Rotation cropping

This upgrade allows the area planted to change between rotation crops and will therefore provide accurate accounting of crop-based labour requirements (see new Crop Area Multiplier in Manage crop product)

  • Use available land, no longer removes the land from the Land type but dynamically adjusts to available land in the store.

Other minor fixes and improvements to Descriptive Summaries

3/11/2021

(2021.11.03.6921)

Breeding with attributes

The model now allows the mandatory individual Attributes of sires used in controlled mating to be randomly obtained from the existing herd, resulting in no herd improvement if sufficient sires are used in mating. This is achieved by omitting the Set attribute with value component from Controlled mating

This upgrade also includes some improvements to the Set previous conception and descriptive summaries.

3/11/2021

(2021.11.02.6902)

Labour

Ruminants

Fixed reported bugs

Added new Set previous conception component.

8/10/2021

(2021.10.08.6835)

Breeding Fixed issue handling attribute inheritance when performing uncontrolled mating with no inherited attributes

27/9/2021

(2021.09.21.6799)

Various

Problem fixed: An error was produced when the grow herd was not castrated and allowed to mature before sale as breeders tried to pass the "grow out" attribute to offspring. Rule: Null value attributes cannot be inherited.

Updated component descriptions.

Improved warning when pricing not available for individuals in report herd groups by value

Added property to Manage ruminants to stop the simulation when the breeder herd reaches a set multiplier x the maximum breeders to prevent runaway exponential herd growth in the individual-based model if sales are not performed.

Improved checking of operator and value to compare in Filter by property for validation

Improve wording in some warnings for clarity

17/9/2021

(2021.09.17.6802)

All CLEM

This upgrade represents the full release of CLEM with all initial functionality and user requests implemented and a significant re-factor of the code-base for readability by advanced users and improved simulation performance. This upgrade provides stricter warning and error notification and you may find previously unreported issues need to be addressed before running your simulation.

Please report any issues or unexpected behaviour.

The help system has been updated to reflect all changes

Additional changes and fixes included:

  • New Attribute Summary Report
  • Updated Herd summary component allows the herd to be grouped by age (years, months) or the ruminant class.
  • The Gender property of ruminants, other animals and labour has been renamed Sex. FIX apsimx simulation in user interface: The new Sex entry will need to be assigned to all males in Ruminant initial cohort and Specify ruminant components. You will need to replace Gender and GenderToString() with Sex in all custom reports and Report query and Report pivot components where used. Delete your database file [simulation file name].db and run your simulation.
  • A bug found in the Resource balances report when reporting ruminant adult equivalents has been fixed
  • Memos are now formatted in descriptive summary
  • Moved Maximum age for mating from Ruminant type parameters to Controlled mating as this is a management decision not a property of the animal. There is no upper breeding age for natural/uncontrolled mating. FIX: If using this property, you will need to set it in your controlled mating component. Controlled mating now also includes a Number of joinings per male property for use with genetic simulations.
  • Fixed bug where some transmutation resulted in infinite resources
  • Female breeders now contain property of last mating style
  • Upgraded Labour requirements report to work with latest developments
  • Possible uncontrolled mating warnings are shown in Descriptive Summary when settings allow them
  • Faster animal pricing code
  • More errors now include the parent component name to assist where common named components are used
  • Move ruminants activity (and Ruminant herd report) no longer assume all animals when a Ruminant group is missing. You now at least need to add a Filter Group with no filter components to move all individuals. Fix: add filter groups to all Move activities.
  • The initial biomass property of Manage pasture has been moved to the Graze food store type to allow initial pasture biomass at setup to be offered when using the simple approach. This component also includes some additional properties to assist with calculating initial biomass pools that were previously hard-coded. Fix:move your initial biomass value from the Manage pasture to the Graze food store type component. You can leave the other values with the default settings appropriate for northern Australian seasonal pasture production.

17/9/2021

(2021.09.17.6802)

Transmutation

 

Significant changes made to the components outlined below. This upgrade implements new functionality that will require adjustments to your simulation file and reset properties. See warning at top of page about creating a backup of your summary description

This release provides an overhaul of the Transmutation components with better terminology, a cleaner interface and full inclusion of labour and ruminants. Transmutation involves transmuting (or converting) a resource (B) into a resource (A) that is currently in shortfall (deficit) for an activity. A new Transmute component replaces the previous TransmutationCost and TransmutationCostUsePricing with Transmute labour and Transmute ruminants allowing Labour and Ruminant resources to be transmuted. All transmutations (except labour) can use the Resource pricing structures specified and this will respect all purchase and selling rules and any dynamic pricing with full transactions to Finance reflecting sell (B) to buy (A) if required.

FIX apsimx file in text editor:

Any simulation file containing the old transmutations will need to be fixed before it will open in this release.

You can replace any occurrence of the code below with "Children": [ ], and rebuild all transmutations from scratch in the user interface, or

for each transmutation component in your tree make the following changes, after which you can open the simulation in APSIM and set the Transmute style and Resource for price-based transactions as needed. This also relates to the old Models.CLEM.TransmutationCostUsePricing with the same changes needed

"Children": [

{

"$type": "Models.CLEM.Transmutation, Models",

"AmountPerUnitPurchase": 1000.0,<---- replace with TransmutationPacketSize

"WorkInWholeUnits": false,<---- replace with UseWholePackets

"TransactionCategory": "Transmutation",

"Name": "Buy",

"Children": [

{

"$type": "Models.CLEM.TransmutationCost, Models",<---- replace with Transmute

"ResourceTypeName": "Finances.General account",<---- replace with TransmuteResourceTypeName

"CostPerUnit": 800.0,<---- replace with AmountPerPacket

"Name": "TransmutationCost",

"Children": [],

"IncludeInDocumentation": true,

"Enabled": true,

"ReadOnly": false

}

],

17/9/2021

(2021.09.17.6802)

Filtering individuals

Significant changes made to the components outlined below. This upgrade implements new functionality that will require adjustments to your simulation file and reset properties. See warning at top of page about creating a backup of your summary description

An important aspect of the model is the ability to select individuals (currently ruminants and labour) from the whole population upon which to perform an activity. This functionality is being redeveloped to allow filtering on any property or method (without arguments) associated with the individual allowing full customisation and detailed management decisions to be applied. The new changes also include sorting of the group upon which to act allowing activities to select individuals ordered by value (e.g. sell those for poorest body condition first). Filtering and Sorting also apply to Attributes either whether they exist or not, or by the value associated with the attribute tag.

You can also specify the number of individuals to be returned using the Take from filtered component. This is now available in all filter groups and the previous Proportion property of some filter groups has been removed. FIX in UI: You will need to add a Take from filtered component below any filter group where you were previously returning a set proportion.

FIX apsimx file in text editor:

Replace all concurrences of .RuminantFilter, and.LabourFilter, with .FilterByProperty,. Save the file and open it in the upgraded APSIM.

As you may have used RuminantFilter as the component name you can search and replace "Grouping.RuminantFilter," with "Grouping.FilterByProperty,". NOTE: Ensure you include the full stop "." at the start and comma ',' at the end of your search and replace terms as we do not want to change the "RuminantFilter" in the valid "RuminantFilterGroup", or "LabourFilter" in the valid "LabourFilterGroup" entries

"Models.CLEM.Grouping.RuminantFilter, Models", <---- replace with FilterByProperty

"Models.CLEM.Grouping.LabourFilter, Models", <---- replace with FilterByProperty

FIX apsimx simulation in user interface:

You will then need to reset the Property used, Operator (<, >, =, >=, <=,) and Value to compare properties for all of your filters. Use the backup of your Summary information Descriptive Summary (see top of page) to see the previous settings.

The new filtering is smarter and if you include any of the properties associated with Females or Males (e.g. RuminantFemale.IsPregnant) the filter will only return the sex specified. This means you no longer need the Sex = Female filter, but may leave it for readability. It also means you will get no records returned if mixing male and female specific properties.
4/8/2021

ReportBalances

Managing herd

Fixed a bug reported where Ruminant.Count was sometimes null, and found that the ruminant reporting was out of step in Resource balances report. ReportBalances now remembers the last tab selected. Next upgrade fixes problem where some balance reports are blank due to old values in the simulation file.

Added functionality to get replacement breeders from calves and weaners before being sold prior to Manage ruminants

Better reporting of weaning reason now supports AgeAndWeight category when both conditions met.

30/7/2021

ReportBalances

ReportLedger

Ruminants

Summaries

The Resource balances report has been updated to provide new economic properties and a better user interface.

FIX: You will have to re-specify the resource groups to report in the new Resource groups property of Resource Balance providing as a comma separated list of names of groups in the entry box in the user interface.

When reporting Ruminant transactions with the Resource ledger report you will now have an animal Class (e.g. calf, weaner, breeder...) column provided.

FIX: You will have to re-specify the resource group to report in the new Resource group property of Ledger Report from the drop-down list provided in the user interface.

The help system now contains a full description of all the Individual ruminant properties and methods that you will be able to use in upcoming filtering or your own custom reports. In doing so the Ruminant individual has been cleaned up. A new Sex property replaces Gender (will be removed in future after you have done changeover) and SaleFlag returns the value without need for SaleFlagAsString method.

Memos included in your simulation tree are now reported in your Descriptive Summary

20/7/2021 Economics

The Ruminant herd component now has a transaction grouping style property that will group transactions and balances for analysis

The Resource balances report now allows dollar value as well as physical amount to be reported. Other switches allow for the reporting of land present, ruminant weight, adult equivalents, and labour by available days or individuals. The balance report now also accepts the Interval timer to control timing of the report for productivity year

Transmutation has been improved to allow the exact amount to be provided if sufficient other resources and all transactions are now reported with a user specified transaction category

20/7/2021 FilePricing A new Price data reader allows an input file to control resource pricing during the simulation which can be reported using a Price change report
20/7/2021 Ledgers All activities now contain a TransactionCategory property that will be reported in the ledger report (activity specific Category properties have been removed). This allows full customisation of labelling transactions of activities and transmutations for economic analysis. The model will propagate most of these new values for you, after which you are free to change the values. Validation errors will be thrown if these new values are missing.
20/7/2021 Graphing Graphs will again accept the resulting views from Report query for x and y series values
8/7/21

Castration

BreedForMilking timer

Other

The growth rates of castrated males will be greater than non-castrated males as they have lower maintenance energy demands (Nutrient requirements of domesticated ruminants, 2007)

Improved logic has been provided to determine the timing of controlled mating and the individuals that can be bred to try and maintain continuous lactation and milk production from the herd (see Breed for milking timer)

Other fixes and improvements

  • Updated Activities performed report to maintain tree structure in report
  • Introduced IsWildBreeder class to represent breeding males from herd that are not flagged as sires (with higher value and performance).
  • Fixed duplicated reporting of some HarvestTimers in Activities Performed report

A known problem where filtering by sex specific properties may not return the correct list of individuals is being addressed and will be fixed in an upcoming release of the new filtering and sorting components. Rather than those meeting the condition, all individuals of the sex are returned. Fixed in upgrade 13/9/21

28/6/2021

Removed old components

Herd management

General processes

The previous Relationship tracker has been removed. You will need to provide a Relationship with Relationship running value component to provide this functionality.

Removed CustomSQL and PivotTable as they are replaced by Report query and Report pivot respectively.

The model now includes a castrate switch (CastrateGrowOutMales in Manage ruminants) when separating young males. These individuals will have an Attribute named "Castrated" that can be used for filtering or you can use the updated IsCastrate and IsSire properties. As expected castrated individuals cannot breed.

The model better handles disabling components (especially Finance) by not enforcing any limits on purchasing and transmutations.

13/5/2021

Herd management and Breeding and applying individual Attributes

The controlled mating switch in Breed ruminants has been replaced with a new Controlled mating add-on component that also handles all fixed and variable costs associated with controlled mating.

You will now need to specify the details of all purchase individuals  in Manage ruminants (breeders and sires), Managing a trade herd (trade individuals) and Perform predictive stocking based on ENSO (individuals to restock) using Specify ruminant components. The properties that defined the age of breeders to purchase have been removed from Manage ruminants. This improves model transparency and allows further customisation by the user.

Breed ruminants now allows tracking of parental attributes with inheritance of attributes and associated values at birth. The Ruminant initial cohorts and Ruminant initial cohort components, as well as Controlled mating, can have attributes supplied with Set attribute with value. The herd attribute statistics can be reported to track changes over time.

8/5/2021

Resource Ledger Reports

New properties have been added to the Resource ledger report including the Style of the report defining whether to include gain & loss columns or transaction type and amount columns. You are also now able to specify whether you want to include additional price and unit conversions with your transaction details and whether the losses should be reported as negative values. The tab structure of the display has changed to allow for these changes and hide unneeded entry screens.

This upgrade also addresses a couple of bugs that were reported after the latest changes to the user interface such as missing property tabs and scrollbars on CLEM components.

1/5/2021

Various,

Herd destocking

A new ReportQuery (replaces CustomQuery which will be removed, see warning 16/3/2021) component has been added.

The Perform predictive stocking based on ENSO activity has been added to allow destocking (and restocking) decisions to be made based on Southern Oscillation Index sequence and predicted ENSO phase. This activity requires detailed user understanding and will need to be validated by early users.

23/3/2021 Various
  • Updated Resource Transactions to report style (Gain or Loss) and amount for each transaction for use with pivot style analysis of Resource ledger report. Gain and Loss Columns remain the default style for Ledger reports
  • Activities performed report now correctly creates the HTML version when selected
  • A property MarkedForSaleReason is provided in Mark ruminants for sale activity so you can apply some of the sale flags to your selection

16/3/2021

ReportPivot  and reported bug fix

A new Report pivot component has been added to replace the previous PivotTable. Add this new component below any report and set the properties to create your report which can be seen in the data tab. These ReportPivot tables can then be used in APSIM graphs.

A known problem with various reports not showing correctly has been fixed (PivotTable, CustomQuery and ReportActivityPerformed)

The automatic creation of the Activities Performed HTML report on completion of the simulation has been disabled by APSIM. We are working to provide this functionality.

12/3/2021

User interface

This upgrade implements a number of background code changes needed for CLEM components to use the upcoming APSIM user interface. You will now be able to switch to the updated property presenter (see home/settings) which will soon become the standard across all APSIM Next Generation. This upgrade also improves the presenting of reports in html for display in a browser during your CLEM simulations, relating particularly to the Activities performed report and Labour requirements report. Please report any issues you find in using the new interface.

29/1/2021

Manage crops

Cropping examples

Manage herd

Other fixes

This update provides the ability to perform multiple crop harvests between planting and a specified last harvest. While this applies to the timing of all crop related tasks it is especially relevant when using rotational cropping as the rotation will now not occur until after a harvest tagged with "last". All previous simulations will run as expected as this functionality is achieved by specifying a Harvest tag column in your Crop data reader and providing the required tags in the input data file.

The cropping example provided with CLEM has been updated to include all new features. This example now also includes an online description of the setup and results. A new section on using Example simulations has also been added to the help system

A number of bugs have been identified and fixed due to recent changes in the Manage ruminants component. These relate to placing individuals in specified paddocks. The issues only appeared after the 20/1/2021 upgrade.

An erroneous reporting of calves being unfed has been fixed.

Minor fixes:

20/1/2021

Activities performed report

Ruminant

Manage herd

Feed ruminants

Herd costs

Manage crops

Pasture reader

 

Happy New Year CLEMsters. We hope 2021 is full of whole farm modelling.

A new html (web-based display) version of the Activities performed report is now available to view your web browser. A number of users have appreciated being able to have the Descriptive summaries open in another application window allowing APSIM UI to remain in the Properties tab. This approach now applies to the new version of the Activities performed report with new properties such as auto create on run and rotate allowing you to simplify the creation of reports and display the activities across the columns in the html view. All these new properties are available in the user interface. The performance in creating all html descriptive summaries has been significantly improved and the CLEM component now includes a switch to create a full descriptive summary of the simulation when performed (look for the simulation file name with a .html extension). Links to both the relevant help page and the html summary files are now provided in the Summary tab for each component rather than the previous formatted summary. The Labour requirements report now also provides a html report and works again in the UI display.

A number of changes were needed to standardise and add additional functionality to the Ruminant components' properties. The sire property has now been renamed IsSire in line with IsBreeder and IsWeaner, and the previous, strict definition of a heifer has been changed to something more generalisable to a range of ruminants (weaned, up two 1st pregnancy or specified age) with the term PreBreeder replacing Heifer term throughout the model and all reporting categories. FIX: This change will need all custom SQL scripts and reports to be updated, and is automatically handled in CLEM specific ledgers. A new Health score property has been added that reports a range from -2 (under-weight leading to death) through 0 (normalised weight for age) to +2 (maximum weight for age possible) as an index of current body condition. We are planning on developing reports to track the general health of your herd through time, but this property can be added to all reports now.

Their have been a number of significant changes to the operation of the Manage ruminants activity to help with managing small-holder herds and fix a number of bugs identified. One of these was to rearrange the properties within categories in the display, while also adding female specific growing out age and weight targets as well as pasture location. "Growing out" of heifers has been significantly improved along with the maintenance of minimum and maximum number of breeders through time. A number of warnings have been added to ensure filters a correctly targeting individuals to remove (e.g. reduce breeders cannot include males)

We are currently working on providing the functionality to better manage

  • replacement animals from the herd (e.g. replace breeders, sires and draught bullocks before they are lost from age) especially when age of maturity is more than one breeding cycle from weaning and replacement animals need to be tracked and not sold. This will also allow for a swap of the "old for young" when conditions are met. This has started with a Replacement property for males that prevents individuals form being sold or castrated before being replacement sires from the herd if enabled.

A bug was fixed in Feed ruminants where the activity was reported as successful when no animals were fed rather than Not Needed.

Herd costs no longer allow a value of 0 as this should be achieved by disabling the component if not required.

The Managing crops section and help has been improved to better reflect the range of cropping styles and how to set them up in CLEM by including a single farm crop in a field as an example.

Improved speed performance when loading large pasture data-cubes in advanced grazing.

Various typos and minor fixes and improvements, especially in descriptive summaries have been addressed.

New filterable properties provided from Ruminants

14/12/2020 Report resource balances

The column names used in this report are determined by the name of the resource type being reported. The column names will now have any spaces in the resource type name replaced with underscore characters.

FIX: You will need to reselect column names to the new underscore version where a space was previously present in all graphs (especially Y values) and graph filters.

NOTE: If you do not provide the date [Clock].Today as a Variable it will be automatically added with a column name Date the same as ledgers.

9/12/2020 Messages, Versions and Descriptive summary display

Due to an update in the programming language framework used by APSIM Next Generation we are no longer able to provide the graphically formatted display of versions, messages and descriptive summaries within the APSIM user interface. Component versions and the messages (errors, warnings and information) from the last simulation (Messages in CLEM component) are now provided as text.

The descriptive summary can now be viewed in a web browser with the link provided in the summary tab. We may add the ability for this to automatically update as you select components in future (let us know if you'd like this feature), but for now you will have to refresh the browser to update the details. This allows you to have a separate window showing your setup while working primarily with the Properties tab.

A full summary of the all settings and messages from your most recent simulation will be provided soon as either a html or pdf file.

2/12/2020 Resource transactions

The reporting of resource transactions (Resource ledger report) has been improved by adding a Category (previously 'Reason') and a RelatesToResource (A resource this activity relates to, but not the resource used in the transaction) field for better grouping and analysis. A number of activities (e.g. Crop task activity) will require this Category property to be set (see individual activity for details)

NOTE:This is a major change and may not be fully working. Please report any situations where the report does not provide the correct information.

FIX: Most changes will occur in the background, however SQL scripts with 'Reason' will have to be changed to 'Category'. New scripts utilising the RelatesTo field will be available soon.

FIX: You will need to provide a Category property for some activities. You will also need to change any graph that previously had a drop down set to "Reason" of Filter using Reason.

FIX: [Clock].Today has been renamed Date in all transaction ledgers. All SQL scripts and graphs (especially value of X) will need to be updated.

26/11/2020/ Resource Activity Sell

Greater functionality has been added to Sell resource activity to help you define how resources are sold through a new SellStyle property and an associated Value.

FIX:You will need to check that all Resource sell activities are correctly set after upgrading. This will involve setting the Selling style and changing the Value from 0 (default) to the required amount (see Sell resource activity)

14/11/2020 Timer Activity Sequence This new Sequence timer provides the ability to specify a repeating sequence that the parent timer will follow. At present only the Crop harvest timer supports this component.
5/11/2020 Ruminant Activity Manage

The Manage ruminants activity currently performs many tasks including the management of the breeder and sire numbers (including at start-up), selling old breeders and sires and managing the sale of young males and females when they reach specified age or weight. It is realised that this may be too many tasks for a single activity when the user wishes to separate the timing of such aspects or apply different rules for selecting individuals. As the Mark ruminants for sale activity provides greater flexibility when managing the sale of specified individuals (e.g. dry breeders, steers, old breeders), this change to CLEM allows the user to manage the marking of individuals for sale using the Mark ruminants for sale activity and disable the various implementations of this performed in manage ruminants activity, leaving this activity to handle only the management of breeder numbers.

You should not need to change any simulation files. Ensure that the new "mark for sale" switches automatically set in your simulation are appropriate.

If there is sufficient interest we could provide a simpler Manage ruminant breeders that is a cut-down version of the larger version and assumes that the user will provide Mark ruminants for sale activities for the sale of all individuals.

4/11/2020

Ruminant Activity Muster

The term "muster" (RuminantActivityMuster) has been replaced in CLEM with "move" (RuminantActivityMove) to better reflect the action in the activity where specified individuals are moved to a new location, whereas mustering represents a larger task of moving the herd through the yards and undertaking a range of additional activities such as separating individuals for sale, weaning, branding and pregnancy testing.

FIX: you will need to replace RuminantActivityMuster with RuminantActivityMove in all your simulation files by opening them in a text editor, using search and replace and saving the file before it can be opened in APSIM.

26/10/2020 External resources

New functionality has been added to input (buy) or output (sell) any resource* external to the farm simulation provided as input data using a Resource data reader and the Manage external resources activity. This activity can also include financial and labour constraints on the transactions.

* this does not currently support Land, Labour, Graze or Ruminant resource types.

17/9/2020 Ruminant feeding

The Feed ruminants activity has been improved to provide:

  • A user defined value allowing overfeeding of individuals above their potential intake is now in Ruminant type under the Advanced properties and the Diet section. This property has a minimum (and default) value of 1 and was previously hard coded as 1.2 (evidence from previous literature review). FIX: You will need to change this value if you need a value other than 1 or you receive a validation error. This value only applies to manual feeding styles (i.e. Specified daily amount, Specified daily amount per individual, Proportion of weight and Proportion of feed available) that allow excess feed to be provided . This multiplier does not influence grazing intake calculations and will not consider any previous overfeeding when grazing is performed after manual feeding.
  • The feed activity has improved reporting of feed allocation including new wastage and overfed wastage ledger entries. These entries allow you to identify wasted food that was ignored (wastage) or previously included in the total amount fed (overfed wastage). These values will help you improve feeding strategies to reduce wastage, especially that fed to animals beyond what they can eat.
17/9/2020 Various
  • Fixed invalid help links, typos and Manage ruminants status not updated on MaxAgeSale
  • Default relationship now 0,0
  • Allow Cut and carry activity to use herd to define amount
  • Removed weight loss due to birth. Although energy is consumed to grow a fetus, this weight is never added to the mother's weight and so it is erroneous to subtract birth weight from breeder at birth.
  • Fixed additional milk production calculation to ensure milk outputs match
  • Added calling activity name to the ledger entry for a transmutation
  • All activities creating greenhouse gas emissions now include properties to specify the Greenhouse gas type store in which to place the emissions. The model will default to using the previous approach of automatically using stores named Methane, CO2 or N2O if found. The new approach alerts you to the previously hidden link to greenhouse gas processes.
4/09/2020

Various:

Ruminant Breed,

Ruminant Manage,

Pasture,

Ruminant graze

 

The following changes and fixes may influence your simulation results:

  • Ruminant breeding: Fixed bug where pregnant breeders older than the maximum conception age never gave birth and led to strange results and death at zero weight.
  • RuminantFemale: IsBreeder now uses high weight rather than current weight to avoid weight loss causing reversion of breeder status and invalid outcomes.
  • RuminantBreed: Cow weight no longer modified by birth weight as weight of fetus is never added to mother's weight but handled only in energy use
  • RuminantManage: Better allocation of mothers to sucklings at start of simulation
  • RuminantGraze: Suckling milk intake now included in total intake for determining additional pasture required. (bug fixed)
  • Pasture utilisation is now capped at 100% (i.e. when more pasture consumed than grew in year)
  • Initialised pasture at start of simulation is not considered new growth.

Improvements

  • Pasture pools were previously "erroneously" reported by pool index rather than age (months), and while they were sorted the matrix style display (Pasture pools report) was not reporting what the user would expect for the style of report. Pasture pools can now be reported by index or age (months) whereby multiple pools of same age will be combined. The GrazeFoodStoreType.Pool(index) method (for advanced users) now includes a flag to use age Pool(index, use age). FIX: you will only need to adjust the Pool() method if used in manual reporting. The Pasture pools report will automatically use age of pools from now on.
  • The model has improved management of the breeder herd around the MaximumBreedersKept using smarter forecasting of upcoming mortality, heifers available and fixing some double accounting of maximum age sales. This reduces the variation previously seen around the maximum number of breeders kept (overshoots) and will influence sales and purchases.
23/07/2020

Various:

Ruminant Groups,

Ruminant Breed,

Ruminant Manage

 

 

The following changes and improvements have been made:

  • Properties requiring a month of the year now use a drop down list rather than integer number (No change needed to simulation file)
  • The renamed Ruminant group replaces the previous RuminantFilterGroup and RuminantDestockGroup. Multiple Ruminant groups can now be applied to activities that support multiple groups (see Move, Destock, Manage). This change will require changes to your simulation file. FIX:Open your simulation apsimx file in a text editor (e.g. notepad) and search for Models.CLEM.Groupings.RuminantFilterGroup and Models.CLEM.Groupings.RuminantDestockGroup and replace with Models.CLEM.Groupings.RuminantGroup. You will also need to set the new Proportion property of the Ruminant group to 1 for all existing Ruminant Groups.
  • A new Ruminant activity group is now used to define simulation level ruminant filtering for a range (branches or folders) of activities. This was previously achieved with the Ruminant Filter Group. Most simulations will not be using this functionality, but if you have you will need to change Ruminant Filter Groups with the new Ruminant activity group throughout the simulation tree (see Ruminant groups)
  • A new range of Ruminant filter options have been provided and use the IsState() naming convention. These include the new IsWeaner, IsCalf, IsSire, IsSteer, IsCastrate (future implementation) as well as previous IsPregnant, IsBreeder and IsHeifer.
  • A new Category property of Ruminant is available for reporting (see Ruminant herd report). This will report the category of an individual (Calf, Weaner, Heifer, Steer, Breeder, Sire, Castrate).
  • Inferring pregnancy status and initial herd size at start-up have been improved, to include prenatal mortality and consider heifers toward breeder numbers respectively.
10/07/2020 Relationship running value

The Relationship running value now replaces the (see 16/4/2020 below). This should be the last change to this component and improves performance and future scalability of CLEM.

If you use the Manage pasture activity for Australian beef systems needing land condition and grass basal area calculations you will need to make changes to your aspimx file.

FIX:Open your simulation apsimx file in a text editor (e.g. notepad) and:

Search for Models.CLEM.RelationshipTracker

Replace Models.CLEM.RelationshipTracker with Models.CLEM.Relationship

Note the values of StartingValue, Minimum and Maximum for the land condition and grass basal area relationships

Save the changes and open the simulation in CLEM

For each Relationship below your Manage pasture add a Relationship running value and set the property values to those noted above. Name these components "LC" for the land condition relationship running value and "GBA" for the grass basal area relationship running value.

10/07/2020 Graze food store fertility limiter This new Graze food store fertility limiter component introduces the functionality offered by NABSA (Fertility - N decline yld property of the land type) to limit nitrogen content of new pasture as a function of the biomass produced in a year and/or the month of growth. Add this component below each Graze food store type that requires the limits to be applied.
10/06/2020 Data readers

The FileGRASP and FileSQLiteGRASP data readers have been replaced by generic versions to reflect the range of simulation models capable of providing pasture production to CLEM. This update will require modifications to your apsimx file for any simulation using these components.

Error: Could not find type "Models.FileSQLiteGRASP" or "Models.FileGRASP" when opening the simulation file

FIX:Open your simulation apsimx file in a text editor (e.g. notepad) and:

replace Models.CLEM.FileGRASP with Models.CLEM.FilePasture

replace Models.CLEM.FileSQLiteGRASP with Models.CLEM.FileSQLitePasture.

replace ModelNameFileGRASP with PastureDataReader

This will maintain the names used in the simulation tree and all settings. You may have to reselect the reader in your Manage Pasture activity.

16/04/2020 Relationship

Changes were made to simplify using Relationship. These included moving the functionality that tracks of a value based on the relationship to a new component. This is currently used in grazing simulations to track Grass Basal Area and Land Condition in Manage pasture when using modelled pasture production data with the Pasture data reader SQLite.

The specific relationship used to determine Adult Equivalents under Labour has been removed and now uses the Relationship component with "AE" included anywhere in the component name for identification.

These changes will cause APSIMX files including the adult equivalent, GBA and LandCondition relationships to cause an error and stop when you try to open them. You will need to perform the following changes on the apsimx file in a text editor before opening the simulation.

FIX Adult Equivalent relationship:Find Models.CLEM.Resources.LabourAERelationship in the apsimx file opened in a text editor (e.g. Notepad).

Replace Models.CLEM.Resources.LabourAERelationship with Models.CLEM.Relationship

A few lines below (below XValues, YValues... NameOfYVariable), DELETE the rows starting StartingValue, Minimum, and Maximum.

FIX Grass Basal Area and Land Condition relationships:Search for Models.CLEM.Activities.Relationship in the lines below where these were located you will find Name with an entry such as GrassBasalArea and LandCondition to confirm you have the correct location.

Replace Models.CLEM.Activities.Relationship with Models.CLEM.RelationshipTracker

20/06/2019 All

Changes to the ResourceTransaction class and CLEM reporting allows greater flexibility to report Resource Type and Activity details as well as using methods() with arguments in APSIM reports. The Methods will not show up in the autocomplete box so you will need to know method names and argument details. This has been implemented to allow Resource units converter to report resources in customised units.

This change will result in many old simulations using APSIM Reports to create resource ledgers to stop working. The Resource ledger report component will automatically handle these changes however you will need to fix custom resource ledgers.

FIX:Add ".Name" to all ResourceType and Activity entries in ledger reports. e.g. [Land].LastTransaction.ResourceType.Name as ResourceType and [Land].LastTransaction.Activity.Name as Activity

1/11/2018 All

Beta release.