Arrange ruminant purchase
CLEM.Activities.RuminantActivityPurchase
Arrange for the purchase of specified ruminants

This activity will add a number of specified ruminants to the purchase list for purchase by the Buy and sell ruminants. This can be used to arrange top up of individuals, buy special individuals or organise the purchase of trade individuals.

The following parameters are used to define this activity

The label of tag to assign individuals for tracking
Optional

The pasture represented by a Graze food store type is a managed paddock or field where individuals can be placed.
This entry is a drop down list of available Graze food store type resources of the Graze food store available for this simulation
An option to move to "Unspecified - general yards" is also available. This would be used to move animals back to the homestead for part of the year for lot feeding.

This parameter will determine what action is taken if there are insufficient resources to perform this activity.
You can report an error and stop the simulation, skip this activity or use the resources available. See What to do when resources are limiting

The following components are required to use this activity

This activity contains any number of Specify ruminant components used to define the individuals added during restocking.

This activity will create financial transactions. It uses the herd pricing provided with the Ruminant type in the resources section.
If no bank account is included or no herd pricing supplied in the herd description in the simulation there will be no financial limit to purchases and purchase value will not be tracked.

The following components will add additional functionality to this activity
This activity provides the following units for components: fixed and per head

A Relationship can be added below this activity to define the number of individuals that are purchased as a relationship with the pasture biomass in the month of purchase. This allows a simple means of controlling the number of trade animals kept in a paddock based on pasture availability. (v1.0.2). This companion component requires the identifier Number to stock vs pasture
NOTE
This approach will not consider the number of animals already present in the paddock and will apply the calculated number to all cohorts of individuals being added by the trade activity if multiple types are provided.

Any Labour requirement will include labour allocation to perform this activity based on any specified identifiers and units and may limit the outcomes if supported and OnPartialResourcesAvailableAction set to UseAvailableWithImplications

Any Activity fee will include financial costs based on any specified identifiers and units and may limit the outcomes if supported and OnPartialResourcesAvailableAction set to UseAvailableWithImplications

This activity will occur in every time-step unless timers are used to restrict this activity (see Using timers).

This activity is performed during the Animal manage event of the setup and time-step events. This ensures this activity has the ability to modify other activities sales and purchases and that all management happens before buying, selling and trucking decisions are made.
Purchasing individuals takes place at the very end of the monthly time-step so that these individuals are present for the following time-step. These individuals will not age from the initial age in the month of purchase.
Individuals are marked for sale and sold during the month time-step.
Therefore, you may have a slight carry over between purchase and sale of individuals.
Any timer will only influence the purchase aspect of the trade activity. The activity will mark individuals for sale in any month where the sell criteria are met and a Buy and sell ruminants takes place.

The following status values apply to this activity and are shown in Activities performed report:
![]() |
blank | The activity was not considered in this time-step |
![]() |
not needed | No trading was required |
![]() |
success | trade individuals were requested and/or marked for sale |
See also