Buy and sell ruminants

CLEM.Activities.RuminatActivityBuySell

Arranges either purchase or sales of ruminants.

The ruminant buy and sell activity is used to undertake all herd sales and purchases and track costs and revenue. This includes applying all trucking rules as well as labour and financial costs. This activity requires other activities to determine which individuals need to be bought and sold in the given time-step. The ruminant manage, seasonal destocking, ENSO destocking, Mark ruminants for sale and ruminant trade activities all flag individuals as ready for sale and can add individuals to the required purchase pool.

The sell task is undertaken at the end of the time step, before individuals are aged and purchases are undertaken (see Events). Therefore the timing of this activity is separate from the other activities and so it's position in the tree is only important relative to other buy and sell activities and resources will be used at the time of sale or purchase after all other normal activities have utilised the resources.

The following parameters are used to define this activity

This parameter defines whether this activity performs purchases or sales.

You will require separate instances of this component in your simulation tree to arrange the purchases and sales of individuals. In previous versions both tasks were handled in a single instance, but this is not longer appropriate.

This option will ensure this instance of this component undertakes all steps to arrange for the purchase of any individuals identified in the time step in which it is enabled.

This option will ensure this instance of this component undertakes all steps to arrange for the sale of any individuals marked for sale in the time step in which it is enabled.

This parameter points to one of the defined Finance types in the Finance group of the Resources available for this simulation. This entry is a drop down list of available Finance types.

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 activities uses the herd resource (individuals flagged for sale) and the pool of requested individuals for purchase.

The following components will add additional functionality to this activity

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 there will be no financial limit to purchases and purchase value will not be tracked.

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. These costs will be incurred at the time of (purchase or sale). Payments can be fixed or made per head, or as a proportion of total sales. These will typically include R&D fees, yard feeds and sales commission.

Trucking logistics is a common aspect of the purchase and sale of individuals. The Apply trucking component can be added below this activity to provide trucking rules, costs and include emissions.

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

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

This activity uses the following events (see Events)

Animals are purchased during this event so that they will be present with purchase age and weight at the start of the following month. Animals are purchased based on the purchase individuals list in the Herd resource that other activities (Manage and Trade) add to. This activity will only purchase if sufficient funds are available (when the Finances resources are present).

Requires Activity style to be set to Arrange purchases

This event is performed at the end of every month before the ResourceAging event. This allows sales to be performed as soon as sufficient individuals have been flagged as ready for sale. The Ruminant Manage Activity will usually only flag enough individuals for sale when it runs in a specified month, however young males and dry breeders will be flagged for sale during all months and may provide enough individuals for a sale based on minimum truck loads before sale property of this activity.

Requires Activity style to be set to Arrange sales

Purchases and sales are defined on all individuals of the current herd considering any filter groups above the activity.

This task will be performed on individuals meeting the following filter rules

Individuals in the purchase list

You can further customise this selection by adding Ruminant groups with the identifier Purchases

This task will be performed on individuals meeting the following filter rules

Marked for sale

You can further customise this selection by adding Ruminant groups with the identifier Sales

The class of individuals sold will be included in the RelatesTo column for all transactions (Finance).

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 There were no individuals to buy or sell
success All individuals were purchased and/or sold
skip This activity was skipped based on Partial resources action and the resources required by child components
partial Only a portion of the required purchases and/or sales were performed
warning The trucking rules restricted the purchase and/or sales of individuals

See also