Glossary¶
This page defines the PyGREET terms used across the manual and shows the color and icon of each library entity.
Entity Colors and Icons¶
The library colors each entity type as follows.
| Folder Name | Subfolder | Color | Entity Icon |
|---|---|---|---|
| Flows | Elementary Flow | Purple | ![]() |
| Flows | Non-elementary Flow | Light Gray | ![]() |
| Processes | Stationary Processes | Light Blue | ![]() |
| Processes | Transportation Processes | Orange | ![]() |
| Conversions | - | Pink | ![]() |
| Transportation Modes | Tanker | Yellow | ![]() |
| Transportation Modes | Barge | Yellow | ![]() |
| Transportation Modes | Truck | Yellow | ![]() |
| Transportation Modes | Pipeline | Yellow | ![]() |
| Transportation Modes | Rail | Yellow | ![]() |
| Transportation Modes | MagicMove | Yellow | ![]() |
| Transportation Modes | Generic | Yellow | ![]() |
| Operational Mode | Orange | ![]() |
|
| Vehicles | - | Red | ![]() |
| Vehicle Type | - | Indigo | ![]() |
| Pathways | - | Green | ![]() |
| Pathway Mixes | - | Dark Blue | ![]() |
| Global Parameters | - | Dark Gray | ![]() |
| Locations | - | Light Blue | ![]() |
| Impact Methods | - | Dark Teal | ![]() |
| Impact Categories | - | Purple | ![]() |
Glossary of Terms¶
Note
The Acronyms page lists the acronyms used in PyGREET, including the system boundaries below.
| Term | Synonyms | Definition |
|---|---|---|
| Acceptance Threshold | The minimum judge score, from 0 to 10 (default 7), that a suggestion of Flow AI-Assisted Mapping needs to be accepted. PyGREET leaves suggestions below it out of the replacements. See Flow AI-Assisted Mapping. | |
| Active Dataset | The dataset PyGREET currently has loaded, highlighted in the Active column of the Local Datasets table. Editors show its name as Active Dataset:. See Dashboard and Datasets. | |
| Amount Group | An input group defined by an overall amount, as a number with a unit. A stationary process can have several. See Stationary Processes. | |
| Backhaul | The empty return trip of a transportation step, which has its own energy intensity. You can select Account for backhaul travel on a step for every mode except Pipeline and Rail. See Transportation Processes. | |
| Blend | A pathway mix that combines two resources, possible when the mix's output resource lists the other under Compatible Resources. Blending in a mix is generally discouraged: for higher modeling fidelity, blend in a stationary process instead. See Pathway Mixes. | |
| Canonical Form | The form in which PyGREET stores LCA data and pathways, in a matrix-suitable format similar to openLCA. | |
| Compatible Resource | A resource listed under Compatible Resources of another resource. An entity that uses a resource can take it from entities that produce any of its compatible resources, for example crude oil and bituminous oil. See Flows. | |
| Contribution Analysis | A results view that shows where a metric is produced, as a tree table of the processes that contribute to it. See Pathways. | |
| Conversions | An abstraction that models emissions from a combustion process or a chemical reaction. | |
| Cradle-to-Grave | The broadest system boundary tracked in GREET. It extends the Well-to-Wheel boundary (or the Well-to-Pump boundary, for non-vehicle products) to include manufacturing, maintaining and disposing of the vehicle or equipment over its lifetime. | |
| Data Editors | Library | The part of the application where you edit every GREET entity: pathways, processes, conversions, vehicles and so on. |
| Dataset | The set of flows, processes, pathways and other entities you work with in PyGREET. See Dashboard and Datasets. | |
| Default Dataset | The built-in reference dataset shipped with PyGREET, marked in the Default column of the Local Datasets table. Clone it and work in the clone, so you keep a backup to return to. See Dashboard and Datasets. | |
| Density | A flow attribute, optional, that PyGREET uses to convert between mass, volume and energy and to calculate coproduct allocation ratios. In Settings, Density is also the control that sets how much fits on screen: Comfortable, Compact (the default) or Dense. See Flows and Settings. | |
| Efficiency Group | An input group defined by an overall efficiency, as a percentage. A stationary process can have at most one. See Stationary Processes. | |
| Energy Intensity | The fuel energy needed to move one unit of cargo mass over one unit of distance. PyGREET calculates it for Barge, Tanker and Truck modes, and uses the value you enter for Rail and Pipeline. See Transportation Energy Intensity. | |
| External Import | An import through which flows came into the dataset. A rule of a Flow Rule-Based Mapping can be restricted to a specific import, and a Flow AI-Assisted Mapping is defined over the flows of the imports you select. See Flow Rule-Based Mapping. | |
| Flow AI-Assisted Mapping | A mapping in which an AI-assisted semantic mapping service proposes replacements for the flows of one or more external imports. You choose the imports and an acceptance threshold, then review the suggestions. See Flow AI-Assisted Mapping. | |
| Flow Groups | Resource Groups | An entity that holds the association of flows (resources) to a group. For example, Fuels = Gasolines (Gasoline 87, Gasoline 91, ...) + Diesels (Military diesel, Biodiesel, ...). |
| Flow Rule-Based Mapping | A mapping made of rules you write that find flows across the dataset and replace them with other flows. See Flow Rule-Based Mapping. | |
| Flows | Resource, Emissions | A material substance (gasoline, gypsum, sand, alcohol and so on) or a quantity of energy (electricity, thermal energy and so on). Flow also names the summary of all movements of one substance or energy type in a system (pathway). The usage context decides whether a flow is a resource or an emission, not the flow itself, so you can use an elementary flow as either. In a process, you can use a resource in downstream processes, but not an emission, because it has ended up in the environment. |
| Formula Parser | Formula Evaluator | The function that turns the text of a formula into a function PyGREET can run. |
| Formula/Time Series Editor | Formulas and Parameters | The window where you write and process formulas. In a time series, each parameter can have a different value for each target simulation year, and the collection of all values for all years is the time series. For example, the amount of diesel used in a conversion can be 1 mmBtu in 2020, 0.9 mmBtu in 2025 and 0.8 mmBtu in 2030. Each of those values can be a formula, such as "A+B" in 2040, where A and B are variables. |
| Global Parameters | Simulation Parameters | Named values you define once and reuse in the formulas of any editor. The library groups them, and you can use each one as a local parameter. For example, a global parameter can set whether to use higher or lower heating values, or which year to use for the simulations. |
| Graphical Results View | A results view that shows the pathway on the canvas, with a table beside it that gives the results for the entire pathway. See Pathways. | |
| Impact Category | A set of one or more impact factors used to calculate impacts during LCIA calculations. | |
| Impact Factor | An individual impact value associated with a flow and contained in an impact category. | |
| Impact Method | A group of one or more impact categories. PyGREET runs one impact method during calculations. | |
| Input Group | A set of inputs of a stationary process that together make one total, defined by an overall amount or efficiency. Each input in the group is either a share of the group or an amount. See Stationary Processes. | |
| Loss Ratio | The dimensionless fraction of the reference amount lost over a transportation step. PyGREET obtains it from the loss rate you enter, according to whether the loss depends on mass, distance or time. See Transportation Step Losses. | |
| Mapping Type | exact, proxy, unmapped | How a suggested target relates to its source flow in Flow AI-Assisted Mapping. exact is the same substance under a different name, proxy is a different substance used as a substitute, and unmapped has no target flow. See Flow AI-Assisted Mapping. |
| Mass Share | The share of the cargo that a transportation step carries, shown as a percentage on the step. The shares of parallel steps should total 100%. See Transportation Processes. | |
| Merge Strategy | The choice of Prefer Existing, Prefer Incoming or Prefer Union that you make when you merge a ZIP package, a GREET.Net file or an R&D GREET data update into the active dataset. See Dashboard and Datasets. | |
| Operational Mode | A configuration of powerplants and fuels that is active while a vehicle operates. It sets the vehicle's energy use and tailpipe emissions per unit of distance. See Operational Modes. | |
| Parameters | A numerical value (a number and a unit) that describes one property of an entity. For example, the density (parameter) of gasoline (flow) is currently about 0.710 g/mL for the most common gasoline. Every numerical value in GREET can have a different value for each simulation year. | |
| Pathway | A directed graph of transformations of resources (substances or flows), made of stationary and transportation processes connected by directed arrows. A pathway usually produces one or a few flows. | |
| Pathway Mix | Mix | A combination of pathways that you define. For example, with electricity pathways for US average and Diesel 10MW generator, you can create a mix of 30% US average and 70% Diesel generator to meet the energy needs of the pathway you build. |
| Processes | Stationary and transportation processes. | |
| Product | A designated output of a pathway. | |
| Products Menu | The menu where you browse, select and drill down from Categories > Mixes > Products > Pathways. | |
| Reference Unit | The unit of the impact factors of an impact category. You type it once, and it is the same for all impact factors in the category. See Impact Categories. | |
| Resources | Inputs and outputs of GREET processes. They are organized in groups (categories, 11 in total to date). A resource can have physical properties and belong to more than one group. | |
| Save as Draft | A checkbox in the bottom tab area of an editor that marks the entity as a draft, to show you will revise it later. See Work with Tabs. | |
| Stationary Process | A substance transformation used to build pathways, for example oil to gasoline refinery. It also defines the emissions, coproducts and by-products of the technological process. | |
| Target Year | The reference year used across calculations and time-dependent parameters. You set it in Settings, and the results header shows the year the results are calculated for. See Settings. | |
| Technology Lag Year | The number of years PyGREET subtracts from the simulation year when it reads the year-dependent data of a vehicle of a given vehicle type. See Vehicle Types. | |
| Technology Year | The simulation year minus the Technology Lag Year of the vehicle type. It selects the year whose data a vehicle uses: the closest year at or before it, or the earliest if all are later. See Vehicle Types. | |
| Transportation Mode | Mode | The definition of a mode of transport, usually the formula and the attributes needed to characterize it. Examples: airplane, helicopter, heavy truck, barge, ocean tanker, pipe. The formulas and required attributes vary widely between modes. Each mode is defined by three parameters: energy intensity, process fuel and emission factors for each process fuel. You can define more than one process fuel for a transportation step. When you do, assign each process fuel a weighted percentage. |
| Transportation Process | A multi-step transportation process, for example Location 1 to Tanker to Truck to Location 2. | |
| Transportation Step | Step | One portion of a transportation process: one instance of transportation from one location to another. |
| Usage Tab | The tab at the bottom of most editors that shows where the current entity is used across the dataset, as a table of direct dependencies and the dependencies nested under them. See Work with Tabs. | |
| Utility Factor | The fraction of vehicle miles traveled that a plug-in vehicle drives in its primary Charge Depletion mode, derived from its all-electric range. PyGREET splits the remaining share evenly among the other operational modes. See VMT Share. | |
| Variables | Local Variables, Local Parameters | A fixed value, or a reference to a parameter-year value or formula, available inside one formula of one parameter. |
| Well-to-Pump | The system boundary covering the upstream supply chain of an energy product or resource, from raw resource extraction (the "well") through processing and transportation to delivery at the point of use (the "pump"). It does not include combustion or use of the product. | |
| Well-to-Wheel | The system boundary that extends Well-to-Pump to include operation of the fuel or resource in a vehicle (combustion, use), ending when the vehicle has consumed the fuel (the "wheel"). It combines the upstream (Well-to-Pump) and operational stages into one result. | |
| WTP & WTW Panel | The panel above the main Library that holds ready-made well-to-pump and well-to-wheels results: Vehicles, organized by vehicle type, and Pathways / Pathway Mixes, organized by the product or resource they produce. See Find Data in the Library. |




















