Skip to content

Library / Search

Overview

The Library and Search features in PyGREET are designed to provide folder-based and tabular access to all system components. The interface is context-aware, showing only the relevant folders based on the active editor, which helps streamline the user's focus and minimize unnecessary clutter. This system organizes the entities within PyGREET into discrete categories to aid in analysis.

The Library / Search window
Figure 1: The Library / Search window

Entity Color Coding and Icons

Folders and their tabs are visually coded with specific background colors to help users quickly recognize content types. Note that some folders, such as the Stationary Process and Transportation Process folders, are linked together in a larger parent folder (i.e the Processes folder). In those cases, those parent folders are gray.

Folder Name Subfolder Color Entity Icon
Flows Elementary Flow Purple Elementary Flow
Flows Non-elementary Flow Light Gray Non-elementary Flow
Processes Stationary Processes Light Blue Stationary Process
Processes Transportation Processes Orange Transportation Process
Conversions - Pink Conversion
Transportation Modes Tanker Yellow Tanker
Transportation Modes Barge Yellow Barge
Transportation Modes Truck Yellow Truck
Transportation Modes Pipeline Yellow Pipeline
Transportation Modes Rail Yellow Rail
Transportation Modes MagicMove Yellow MagicMove
Transportation Modes Generic Yellow Generic
Operational Mode Orange Operational Mode
Vehicles - Red Vehicle
Pathways - Green Pathway
Pathway Mixes - Dark Blue Pathway Mix
Global Parameters - Dark Gray Global Parameter
Locations - Light Blue Location
Impact Methods - Dark teal Impact Method
Impact Categories - Purple Impact category

Search Functionality

Basic Search Functionality

The library may be searched by typing into the search bar at the top of the library. Library elements will be filtered to only include entities that contain the search query in their names.

Note

The search is case insensitive and will be shown in lower case.

Example: Searching for "nna ng" will only show entities with "NNA NG" in their name.

Searching the library for "nna ng". Only entities with NNA NG in their name are shown
Figure 2: Searching the library for "nna ng". Only entities with NNA NG in their name are shown

Advanced Search Functionality

In Addition to normal search features, Library elements may be filtered by entity type using the pattern "@[Entity Type]/"

Example: Searching for "@flows/natural gas" will only show flow entities with "natural gas" in their name

Searching the library for "@flows/natural gas". Only flow entities with natural gas in their name are shown
Figure 3: Searching the library for "@flows/natural gas". Only flow entities with natural gas in their name are shown

When searching for resources, alternative names can also be used as search parameters.

Searching for Benzene by Alternative Name in the library
Figure 4: Searching for Benzene by Alternative Name in the library

Creating and Opening Entities

Existing entities can be opened, and new entities created, by interacting with the library:

  • Create a new entity: Click the + icon on the right side of the label that appears when you hover over a folder
  • Open an entity: Click on it - the entity will be loaded into a new tab on the main view of PyGREET