Apply trucking
CLEM.Activities.TruckingSettings
Provides trucking rules, costs and emissions.

You can include any number of Trucking components under the Buy and sell ruminants activities. This allows the activity to determine sales or purchases based on trucking rules as well as include costs and emissions. This add-on is optional so that trucking doesn’t need to be included in the simulation. This component does not currently support mixed breed/species truck loads. Animals are loaded based on either a set number per loading unit (deck or pen) or from a weight based relationship to determine this value for each animal. You can also specify the configuration of decks, trailers and trucks as well as specify a range of trucking options that will be considered in the order they are provided. Loading will not currently stop animals of different sizes being placed on the same truck.
When trucking prevents the required animals being transported, it will be the last individuals in the sale/purchase lists that will be left behind, so defining the order in which individuals are process with a Ruminant group and Sort by property will ensure your desired action is performed.

The following parameters are used to define this component

A label to identify whether this truck specification relates to the purchase or sales transporting.

The distance (km) to market for calculating trucking costs. This will relate to the identifier set above.

This determines the number animals that fit in a loading unit, truck load. This does assume that all the animals are of equivalent size which can be achieved by filters the animals to be transported and setting trucking details for each group.

The minimum number of load units (decks/pods) per truck defines the minimum truck/trailer/bed configuration will determine how many animals must be for purchase or sale before trucking is undertaken. A value of zero will result in transporting all individuals regardless of the truck load (i.e. one truck for one individual would be possible. This will be more expensive as full trucking costs will be calculated for small numbers of individuals.

The maximum load (decks/pods) per truck allows different jurisdiction transporting rules to be included.

This parameter defines the number of load units (decks/pods) per trailer and is used to define how many trailers are included with a truck. This property allows a series of number to be provided representing each trailer from the cab to the back. If more trailers than number are provided the model will use the last number supplied for all remaining trailers. For example if the first trailer had one pod and the remaining two could hold two pods you can supply 1,2 as this value.

This is the truck Tare Mass (kg, including half fuel) used for calculating emissions.

The aggregate trailer mass (ATM, kg) is the mass of trailer and tow ball down weight. This parameter allows an array of values representing each trailer (see loads per trailer above).

This parameter defines the minimum number of load units before transporting will be undertaken. A value of 0 will transport any individuals.

For truck configurations where additional trailer can be added, this parameter determines the minimum load unit (deck/pod) before adding a new trailer. A value of 0 will transport add a trailer for any individuals.

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 will add additional functionality to this activity

If you provide a Greenhouse gases store with Greenhouse gas type components and include a Greenhouse gas emission component the emissions from trucking will be calculated based on the units specified. This component will allow emissions to be calculated fixed, per truck, per km trucked, or per tonne km.

Any number of Ruminant groups with associated filters can be provided to refine the individuals for this truck (see details) from the overall individuals considered for transporting. This allows you to specify the individuals for trucking based on size, polled or horned etc.

Any number of Pay herd fee can be added to the trucking component. This component will allow fees to be applied fixed, per head, per truck, per km trucked, per loading unit, or per tonne km as defined by this component for the given task.

This activity will obey all Ruminant activity group in the simulation tree at and above it's location.
Only one instance of this component is permitted in each Activity.

Adding a Labour requirement below this activity will mean that labour is calculated and required to undertake the task.

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

This component and any related expenses and emissions is performed during the BuyAnimals and SellAnimals events of the setup and time-step events and managed by the Buy and sell ruminants activity.

The following sections outline the how this component adds additional functionality to Buy and sell ruminants

By default transport of purchases 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

By default transport of sales will be performed on individuals meeting the following filter rules
Ready for sale
You can further customise this selection by adding Ruminant groups with the identifier Sales

Animals will be loaded in the order they are provided which by default is the order purchases were requested for purchases and the order individuals are present in the herd list for sales, also an artefact of the history of the simulation when individuals were added. You can add a Ruminant group with filters and sorts to ensure they are supplied in the correct order.
Animals are added one by one taking into account the load limits per loading unit (deck/pod), whether there are sufficient remaining individuals to add additional trailers or trucks based on the truck and trailer configuration.

A greenhouse gas emission from trucking can be created and stored in the Greenhouse gases based on a number of units provided by this component. For example setting the kg gas emitted per tonne km (total vehicle, trailer and payload weight in kg multiplied by the km transported) and the associated units per tonne km in a Greenhouse Gas Emission component below this component will create emissions from herd transporting. This needs to be done for each trucking setting provided.

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 transporting was required |
![]() |
success | The required individuals were all transported |
![]() |
warning | Loading rules resulted in no individuals being transported |
partial | Resource shortfalls or loading rules limited the individuals transported |
See also