Transportation Modes¶
Define the vehicle or infrastructure that moves a cargo, with the parameters PyGREET uses to calculate its energy intensity. Each step of a transportation process uses one mode.
There are 7 categories of transportation mode, each with slightly different parameters:
- Tanker
- Barge
- Truck
- Pipeline
- Rail
- MagicMove
- Generic
A transportation mode always has two bottom tabs:
- General Information Tab
- Usage Tab
The Usage Tab is explained in Work with Tabs.
Tanker and Barge¶
Tanker and Barge modes have the same three sections, along with the name and notes:
- Mode parameters used to calculate energy consumption
- Payload and energy consumption
- Fuel groups
Mode Parameters Used to Calculate Energy Consumption¶
You enter these parameters, and PyGREET calculates the energy consumption of the vessel from them. Each parameter can be a formula or time series data.

| Parameter | Meaning |
|---|---|
| Average Speed | The average speed from the destination to the originating location. |
| Load Factor to | The throttle: the percentage of installed power used from the originating location to the destination. |
| Load Factor From | The throttle: the percentage of installed power used from the destination back to the originating location. |
| Brake Spec. Fuel Cons. (or Typical fuel consumption), Typical HP, HP/Payload factor | Together, these three parameters estimate the energy intensity of the barge or ocean tanker. |
Payload and Energy Consumption¶
This table sets the payload capacity of the vessel for each cargo. PyGREET combines the payloads with the parameters above to calculate the energy intensity. The payload is the mass or volume of cargo the vessel can carry.
Payload is the maximum amount of goods a vessel, truck, barge or other mode can carry while it stays within safe operational or legal weight limits.
To add a payload:
- Hover over the Payload and Energy Consumption subsection title and select the + icon.
- In the Cargo column, choose the flow.
- Enter the payload.
When you define the payload, PyGREET calculates and shows the energy consumption to and from.

Fuel Groups¶
All transportation modes share the Fuel Groups table. Each mode gets its energy from fuels that carry an upstream pathway. Fuel groups let you store different fuel blends for a mode.
Each fuel group has:
- One or more fuels, listed in the Fuel column
- A share of the fuel group
- The conversion to use for each direction of travel
To add a fuel group or a fuel:
- New fuel group: hover over the Fuel Groups subsection title and select the + icon.
- New fuel: hover over the fuel group title (for example, Default) and select the + icon.

Truck¶
A Truck mode has the same structure as Tanker and Barge. The difference is in the Mode Parameters used to Calculate Energy Consumption section: you define the fuel economy of the vehicle for each leg of the trip.

| Parameter | Meaning |
|---|---|
| Fuel Economy To | Fuel economy from origin to destination (assumed loaded, or full). |
| Fuel Economy From | Fuel economy from destination back to origin (assumed unloaded, or empty). |
Pipeline¶
A Pipeline mode has two sections:
- Energy Consumption
- Fuel Groups
PyGREET does not calculate the energy consumption of a pipeline. You enter it as a value for liquids or solids, and a few materials have their own value.
Energy Consumption¶
This table holds the energy intensity for each cargo that moves through the pipeline. Energy intensity is the energy consumed to move a unit of payload over a unit of distance.
To add a cargo:
- Hover over the Energy Consumption subsection title and select the + icon.
- Select the name of a cargo to open its flow in Flows.
Note
The default Pipeline mode in the GREET dataset also has default data for resources whose resource state is solid or liquid, for compatibility with earlier GREET data. You can modify them here. A note that explains this appears when you hover over them.
The Fuel Groups section works as for the modes above, except that Conversion From is filled in automatically as not applicable, because a pipeline has no backhaul.

Rail¶
A Rail mode has two sections:
- Mode Parameters used to Calculate Energy Consumption
- Fuel Groups
You define two parameters:
- Average speed
- Energy intensity of the mode
The Fuel Groups section is the same as for Pipeline.

Note
PyGREET uses the same energy intensity for any resource transported and for any fuel the train uses.
MagicMove¶
A MagicMove mode is a dummy connector for a transportation process. It has no inputs besides its name and notes. It represents a step that produces no impacts or emissions.
Include a MagicMove on the canvas for clarity. When you give a MagicMove a mass share, you show that part of the cargo has zero environmental impact. Leaving the block out instead leaves a missing mass balance and makes it unclear whether you skipped a logistics step by mistake or on purpose.
Generic¶
A Generic mode is a reusable element you can use across several transportation processes. Because you define its parameters, it supports analysis beyond the fixed models for trucks, barges and tankers that GREET defines.
A Generic mode has two sections:
- Energy Consumption
- Fuel Groups
Energy Consumption¶
The table is the same as the Pipeline Energy Consumption table, but a Generic mode also allows backhaul. Each cargo row has an Energy Intensity To and an Energy Intensity From value.

The Fuel Groups section is the same as for Tanker and Barge.
Equations
See Transportation Energy Intensity for the formulas that calculate the energy intensity of Barge, Tanker and Truck modes, and for how Rail and Pipeline are handled.