Ruminant herd summary
CLEM.Reporting.RuminantHerdSummary
A component to generate summarised monthly herd details for reporting.

This component is placed within your Activities holder to perform monthly summarizing of the herd for reporting. As herds on extensive farming systems can contain large numbers of individuals it is not efficient to report the status of every individual, every time-step for reporting. This activity summarises the herd by breed, sex, location and a specified grouping and determines the number of individuals in each group as well as average weight, average weight gain, average intake, adult equivalents and the number pregnant, lactating, and births for breeding female groups. This component then raises a ReportItemGenerated event and passes the associated details which can be reported in an APSIM Report.

The following parameters are used to define this report and are entered under the Properties tab in the user interface

The style of grouping individuals in the herd.
The ByClass and ByAge styles will use a Group column in the database with the value of the group reported.

This will use the method previously used with all column names and individuals grouped by age in months

Individuals will be grouped by class

Individuals will be grouped by age in months. This option will produce a large report.

Individuals will be grouped by age in years (e.g. <12 will be 0, <24 will be 1)

This switch will determine if the location of individuals is included in the grouping rules and allow you to report herd summaries by location or the paddock where individuals are located at the end of the month when the report is performed.
Individuals that were moved from a paddock during the month will be included in the new paddock statistics.

This option will include an additional grouping category (All) which represents the entire herd in the analysis.

The following components will add additional functionality to this activity

This component will respect timers (Interval timer, Month range timer, Date range timer)

Any Ruminant group can be used to define the individuals included in the report. Any Ruminant activity group components located as ancestors up the tree will also be used.


You will need to add an APSIM Report component to your simulation. In future we may develop a automated version of this report.
This example assumes the ruminant herd summary is named "SummariseHerd".
Once this report is added you will need to assign the following settings.

[Clock].Today
(needed for ByAge and ByClass grouping style)
[Activities].SummariseHerd.ReportDetails.Group as Group
[Activities].SummariseHerd.ReportDetails.Breed as Breed
[Activities].SummariseHerd.ReportDetails.Herd as Herd
[Activities].SummariseHerd.ReportDetails.Age as AgeGroup
[Activities].SummariseHerd.ReportDetails.Sex as Sex
[Activities].SummariseHerd.ReportDetails.Number as Num
[Activities].SummariseHerd.ReportDetails.AverageWeight as AvgWt
[Activities].SummariseHerd.ReportDetails.AverageWeightGain as AvgWtGn
[Activities].SummariseHerd.ReportDetails.AverageIntake as AvgIntake
[Activities].SummariseHerd.ReportDetails.AdultEquivalents as AE
[Activities].SummariseHerd.ReportDetails.NumberPregnant as NoPregnant
[Activities].SummariseHerd.ReportDetails.NumberOfBirths as Births
Any of these entries can be omitted to reduce the size of the report table.

[Activities].SummariseHerd.OnReportItemGenerated

Run your simulation and the summarised details report will be in the datastore
See also