Running openLCA for the first time

When you launch openLCA for the first time, it does not contain any data. On the left side, you see an empty Navigation field. On the right, you see the Welcome page.

openLCA Welcome page

The Welcome page provides quick links to openLCA Nexus, instructional videos, case studies, this user manual, the openLCA download page where you can download the latest version of the software as well as LCIA methods, and, eventually, a link to more information on the openLCA network and its users.

Here, we describe the available toolbar functions, and provide guidance on using openLCA’s basic features:

openLCA toolbar

Click on the ▶ to expand the respective tab:

File

The following options are available under File:

  • Save / Save As... / Save All: This option saves the work that is currently opened in the editor tabs. Unsaved tabs will be not included in the calculations that will be performed.

  • Close / Close All: This option closes the current/all windows opened in the editor.

  • Preferences: Under preferences, you can customize openLCA upon your needs. Here, you can find settings as memory allocation for openLCA, and language selection.

    • Collaboration: Here, you can select your preferred configurations for working with the collaboration server.

      • Check restrictions before commit: this option will be deprecated in the upcoming 2.1.1 release o openLCA.

      • Check referenced changes: if this is checked, openLCA will scan - after selecting datasets for a commit - the database for changes in datasets that are referenced by the selected datasets and suggests to also commit them. E.g. if you want to commit a process dataset, and you have added a newly created flow to the input table, the flow is considered a referenced change.

      • Enable comments: if this is checked, openLCA loads comments that were added to data sets on the LCA Collaboration Server and displays them in the model editors.


        Preferences Collaboration

      More information about the Collaboration Server can be found in the respective chapter.

    • Configuration: Here you can choose among eleven available languages (Arabic, Bulgarian, Catalan, Chinese, English, French, German, Italian, Portuguese, Spanish or Turkish). You can also select the maximum memory usage (see chapter)


      Preferences Configuration

    Note: You need to restart openLCA to activate configuration changes.

    Furthermore, you can reset your window settings if you encounter a bug or if you found yourself lost with the number of open windows.

    Dark mode: Our dark mode seamlessly follows the mode set for your entire system. To enable the dark mode in openLCA you need to select it on your operating system.

    • Experimental features: These features are still in development, but you can already access them by checking this box. We welcome any feedback to further refine them.


      Preferences Experimental Features

    • Import/Export: Here you can change the ILCD Network settings (currently under development).

    • Logging: Here you can set what information should be written in openLCA's log file. You can also keep the log file opened permanently if you want.

    • Number format: If you are not a fan of the six-decimal display format, you can modify it here. This setting will not affect calculation results and it is just for your convenience, adjusting the format in the user interface.

    In case you made a mistake here, "Restore Defaults" will always bring you back to the default settings.

  • Import: See section "Importing and combining databases"

  • Export: See section "Exporting data"

  • Exit: This option closes openLCA, as well as clicking on the small cross at the right corner of openLCA.

Database

Note: Almost all the functions described here can also be accessed via right click with mouse on the navigation panel.

The following options are available under "Database" when a database is opened:

  • New Database: For creating a new database, see section "Creating a new empty database" for details. It is also possible to activate the "New Database" function by right-clicking the navigation window.

  • Restore Database: For restoring a database, see section "Restoring a database" for details.

  • Backup Database: Copy the database into an archive file to save it.

  • Validate: Checks the database about inconsistencies and creates a validation report.

  • Copy: Creates a copy of the active database.

  • Rename: Renames the active database.

  • Delete Database: Deletes the active database from openLCA. Please note, this action is irreversible!

  • Close Database: Closes the active database. Alternatively, opening another database will automatically close the active one.

  • Check linking properties: Performs a comprehensive provider check on the active database and displays the results in a table. It will show if processes lack a default provider, whether product or waste flows exist with multiple providers, if and which product flows have multiple providers and identifies provider linking options that are uncritical with the active database.

  • Properties: Shows the database's location on the computer and the type of the database.

  • Compress database: This function will remove deleted datasets from the active database freeing up space in the database.

  • Contents: Under the two tabs, "flows" and "processes" are available. Clicking on them shows a list of all the flows or all the processes within the database. This option allows you to filter all flows using the CAS number or chemical formula.

Tools

The following options are available under "Tools":


Options under Tools

  • Show views

The following options are available after clicking on "Show views" and "Other":


Options under Show views, Other

  • General

    • Console: Displays the log file
    • Minimap: Not available, a relict from creating openLCA with eclipse
    • Outline: Displays a list of all the processes of a product system, including all its background processes. It is only applicable after you’ve created a product system. Open the product system’s Model Graph (tab) and choose the "Outline" option from "Views". The outline allows you to choose the processes you wish to show or hide from the Model Graph.
    • Palette: Not available, a relict from creating openLCA with eclipse (don't worry)
    • Properties: Not available, a relict from creating openLCA with eclipse (don't worry)
  • Other

    • Commit History: Shows the commit history of the synchronization with the collaboration server, see section "Link with Collaboration Server".
    • Compare with repository: Shows the comparison with the collaboration server, see section "Link with Collaboration Server".
    • Navigation: The Navigation window displays the databases you have imported into openLCA and all the data sets they include.
  • Developer Tools:

    • SQL: A tool that can be used to carry out SQL queries in openLCA.
    • Console: The console tool is the live feed of our program with the same content as our log-file.
    • Python: openLCA supports the possibility to run Python programs directly in openLCA. With this feature, you can automate calculations in openLCA, write your own data imports or exports, perform sensitivity analysis calculations by varying parameter values, and much more.
    • IPC Server: Inter-Process Communication is a platform-independent data exchange interface via HTTP. IPC Server allows running openLCA services via Python’s standard library

    To find out more details on scripting in openLCA, see "Scripting in openLCA" chapter.

  • Bulk-replace: It is a tool that allows the replacement of a flow or product provider with another flow or provider.

  • Flow mapping (experimental): Still under development but already available for you!

  • Library export (experimental): Still under development but already available for you!

  • Get EPDs from EC3: With openLCA 2 it is now possible to download or download EPDs from EC3 (Embodied Carbon in Construction Calculator) by Building Transparency. This requires access to the Building Transparancy server. Also an upload is possible.

  • Formula interpreter: Use this interpreter to check if your formulas are correct. More information on the interpreter is accessible by opening the formula interpreter and typing "help" in the command line.


    openLCA Formula Interpreter

Help

Under "Help" you can find information on the openLCA copyright and openLCA log file as well as a link to this user manual and other free resources.

openLCA search function

On the top-right corner of the page, the "Search" function allows you to search for keywords in openLCA (e.g. name of flows, processes, social indicators, currencies, etc.). You can search across all sections or specify specific areas. In openLCA 2, you can also search for datasets within accessible repositories on the collaboration server and import them into the local working database.


Search function in openLCA

When you search for a term, you can even filter the results:


Filtering after using the search function in openLCA

Working with tabs

In openLCA 2, every new window is organized as a tab next to the welcome one within the main window. Right-clicking on a tab provides different management options, improving the user-friendliness of openLCA.


Right-clicking a tab

Tabs can be detached and moved around on the screen. By dragging and dropping a detached tab next to an existing tab in openLCA, you can reverse the detachment. This feature allows you to run openLCA in a single-window and multi-window mode, particularly beneficial when working with multiple screens.

To show two tabs either underneath or next to each other, drag one tab till a double line appears on your screen.

Placing tabs underneath or next to each other

Note: An asterisk "*" in front of the tab's name indicates that the data of your tab is not saved and therefore an older state of this tab will be included in any calculation.

Note: If you are unhappy with your choice of tabs and windows, you can always reset them under File → Preferences → Configuration → Reset Window.