Resource units converter

CLEM.Resources.ResourceUnitsConverter

Provides a means to report any resource in another unit.

There may be situations where it is beneficial to report the amount of a resource in a different unit of measure for analysis. CLEM provides the ResourceUnitsConverter component as a means of identifying a range of conversions that can be used for each resource. This is achieved by adding any number of ResourceUnitsConverter components beneath the Resource Type component in the simulation tree and supplying a conversion factor. Once this component is present you can access the .ConvertTo(converterName) method of any Resource Type in a Report and the .ConvertTo(converterName, amountType) of the LastTransaction items of a ledger report where amountType is either "gain" or "loss" depending on which value needs to be converted.

The Resource ledger report will automatically add any converters found to the output.

 

A farm simulation may wish to track the energy content of all food products purchased or grown on the farm. This can be achieved by adding a ResourceUnitsConverter named "energy" to each food type resource and specifying the conversion factor to the new units. All reports could then not only output (i.e. kg) of the food types, but also energy content (MJ).

When reporting greenhouse gas accounting and emissions it is common to report each gas in CO2 equivalents. A CO2 equivalent ResourceUnitsConverter (say named CO2e) can be added to each Greenhouse gas type and then used to report gains of losses of all greenhouse gases in the simulation in CO2 equivalents.

The following parameters are used to define this activity

The factor used to convert the parent Resource Type from the standard units used in the simulation into another unit.