Other animals buy

CLEM.Activities.OtherAnimalActivityBuy

Arranges the purchase of specified other animals.

The Other animals buy activity is used to arrange purchase of new individuals.

You can also use Activity fee and Labour requirementon most other animal activities to also manage associated costs for you, especially where on the activity and the time of action knows the details of the individuals being treated. In these situations you are able to add a Activity fee component below the controlling parent activity.

The following parameters are used to define this activity

A category label for this activity used for grouping transactions (see Resource ledger report for more details).

As some activities are generic and can apply to a range of tasks or costs, these Activities use the TransactionCategory property to identify the action in any transaction ledger. For example, there may be multiple herd tasks and costs associated with managing a breed and each of these should provide a Category to describe them such as "Vet" could be associated with all tasks and costs relating to vet services.

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 Other animals cohort components which are used to define the details (Age, Sex, Other Animal Type) of the individual and number of individuals to be purchased.

This activity will create financial transactions. It uses the herd pricing provided with the Other animals type in the resources section.

An Activity fee set to the full purchase value is required to handle payments using any resource type with an automatic exchange rate. Shortfalls can result in a reduction in the number of individuals purchased.

The following components will add additional functionality to this activity

This activity provides the following measures for components: Number to buy and Purchase value

This activity provides the following units for components: fixed, per head and value of individuals

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 Get Resources Required event of the setup and time-step events. This is the standard, monthly clock event by which CLEM activities request resources and perform actions based on the resources provided, therefore this activity will compete with most activities in the time-step with their location in the simulation tree determining the order they are processed (this includes activities located on other CLEM and Market components). If this activity relies on another activity having been performed, or other activities rely on this activity in the time-step, ensure it has been performed in the correct order based on it's position in the simulation tree.

Herd costs 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

Any other animals

You can further customise this selection by adding Other Animal Groups

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 individuals were provided for any tasks
partial Only a portion of the potential individuals were included based on shortfalls
success All individuals were included

See also