Importing data and combining databases
Previously we have described the "Restoring a database" function, which is specifically intended for zolca files. As working with data, in particular during the life cycle inventory data collection phase, is rather complex, openLCA supports various data formats to work with.
Supported Import and Export formats:
- EcoSpold1
- ILCD
- Excel
- SimaPro CSV
- Zolca
- JSON-LD
Note for macOS users: If you are using Safari, the browser will automatically unzip your downloaded zip files. However, you need the zipped file for import in openLCA (e.g. when you want to import JSON-LD, methods packages, ILCD...). You can solve this issue in two ways:
-
Use another browser for downloads, where the zip-files are not automatically unpacked after successful download.
-
Zip the archives again by using a third-party tool, because the build-in archive tool from Apple will add additional resources to the zip-file that can create issues when importing the file in openLCA.
Importing data
To import data into openLCA, click on "File" and then "Import", or right-click on the Navigation Window and choose "Import".
Under the "Import" section, you can find the following options:
-
File: This option allows you to import data in various formats, including zolca, EcoSpold 1, Excel, HSC Sim Flow (experimental), ILCD, and SimaPro CSV. The import format is detected automatically.
-
From Git: This option enables you to establish a connection to a Git repository for importing data (what we do not do for now).
-
Other: This option allows you to manually specify the format of the import, in the picture below you can see the wizard.
Import Wizard
The details for each option are displayed below:
Importing a database from an exported zolca file
The fastest way to open a zolca-format database in openLCA, is outlined in the "Restoring a database" section. Alternatively, you can use the "Import" function with the following steps:
- Click on "File" and then "Import".
- Select "Import entire database" and then click on "Next".
- Choose the option "From exported zolca-File" in the import wizard.
- Locate the desired zolca file in your file browser and select "Open". Then, click "Finish".
Import from exported zolca-File
After importing it, the database will be "inactive". To activate it and gain access to its flows, processes, and other components, simply double-click on it.
Note: The program decompresses the files into a different directory (C:\Users\NAME\openLCA-data-1.4). As a result, the original zolca file remains compressed and won't be directly affected by changes made to the database within the software
Importing an existing database
In openLCA, an existing database refers to a database that has already been imported or created within the software. To import data from an existing database into the currently active database, you can follow these steps:
- Start by following steps 1 to 2 as described above.
- Select the option "Existing database".
- Use the drop-down menu to choose the desired database from the available options.
- Finally, click on "Finish" to complete the import process.
Importing databases and data sets as Ecospold, Excel, ILCD, SimaPro CSV, and JSON-LD
By following these steps, you can import databases in various formats into existing openLCA databases, allowing you to expand and enhance your data resources:
- If needed, create a new empty database in openLCA to also import the respective reference system (elementary flows, units etc.) from the database/data set.
- Double-click on the target database to activate it before importing the data.
- Navigate to the "File" menu and select "Import". Choose "Other" from the options.
- Select the specific format of the database you want to import (e.g., Ecospold, Excel, ILCD, SimaPro CSV, or JSON-LD).
Here are some notes on specific formats, be aware that this is not an exhaustive guidance but provides just some key aspects:
-
For SimaPro CSV files, add a flow in the window and optionally select a flow mapping file. If you are importing multiple CSV files without a mapping file, import all the CSV files together to ensure correct mapping.
-
For ILCD files, select the import file from the directory and optionally a flow mapping file. ILCD databases have to be in .zip format to be imported.
-
For Ecospold1 files, ensure to check and assign units using a flow mapping file.
-
JSON-LD is the in-house format for openLCA. You can import entire databases, LCIA methods or any other database element to import. JSON-LD data has to be in .zip format.
When importing JSON files, you have three options for the case of already existing datasets:
-
Never update a data set that already exists: The system will check for matching UUIDs. If a match is found, the existing dataset will remain as it is.
-
Update data sets with newer versions: If matching UUIDs are found, the system will update the existing datasets only if the imported version is newer (the version can be checked in the "General information" tab of every dataset).
-
Overwrite all existing data sets: If matching UUIDs are found, the system will replace the existing datasets automatically with the imported ones irrespective of versioning.
Datasets with UUIDs that are not present in the current database will be imported anyway, regardless of the option you choose.
On the dedicated chapter, you can find more details about importing LCIA methods in JSON-LD format into openLCA, as the openLCA LCIA methods pack.
- Click "Finish" to initiate the data import process. The duration of the import may vary depending on the size and complexity of the data.
Importing GeoJSON files
In openLCA 2, we introduced a new feature that allows you to import GeoJSON files, so you can incorporate geographic information for existing locations in the database. The feature compares attributes like name, UUID, or code of the locations in the database with the features specified in the corresponding GeoJSON file. This helps to find and assign the appropriate location. For example, you can use this method to import the GeoJSON file of ecoinvent locations available at Geography ecoinvent using this method.
Within the database, GeoJSON data is stored in a compressed binary format. This approach reduces storage requirements and ensures fast loading of the data.
To import GeoJSON files, follow these steps:
- Select "Geometries from GeoJSON" in the import wizard under "Other".
- Choose the folder where the GeoJSON file is located.
- Select the specific GeoJSON file you wish to import.
Note: If the GeoJSON file is in a zipped format within the selected folder, extract or unzip it before proceeding, as the import wizard can only add uncompressed GeoJSON files. The GeoJSON file may not be visible in the folder view, but it will be visible in the import wizard once the folder is selected.
Combining databases
In openLCA, it is possible to merge multiple databases into a single one. The databases available in openLCA Nexus are carefully mapped to ensure that all elements within each database are accurately recognized and applied. This mapping prevents the creation of duplicate flows during import and guarantees the correct functioning of impact assessment methods.
To combine databases, follow these steps:
- Begin by restoring/importing the first database. It is recommended to import the largest database first to minimize compilation time.
- Activate the imported database by double-clicking on it.
- Now, you can proceed to import the remaining databases by right-clicking on the active database, choose "Import" then "Other...".
- Select "Import entire database", click on "Next" and eventually choose the database to import from databases that are already present in openLCA or from an exported zolca file (see picture below). Click on "Finish" to combine the databases.
- The software will automatically combine the databases. The duration of this process may vary depending on the size of the databases involved. You can refer to this instructional video on combining ecoinvent 3.1 databases for visual guidance.
You can decide to combine the active database with another database already present in openLCA or an exported database