Merge pull request #5 from GreenDelta/Monthly-update-April

Minor updates

src/advanced_top/regionalized_new.md

@@ -0,0 +1,114 @@
+# Regionalized LCA
+
+<div style='text-align: justify;'>
+
+With openLCA you can perform regionalized impact assessment, accounting for specific conditions and characteristics of the location where the processes occur. With parameters, you can define regional characteristics affecting the imcts. Regional characteristics and information about geographic locations are contained in GeoJSON files that can be imported into openLCA
+
+## How to perform regionalized LCA-step by step 
+
+_**Note:**_ regionalized calculation is an advanced form of impact calculation. It is more resource consuming that a normal impact calculation and it is needed to be handled carefully. We advise to allocate enough memory for the calculations, to perform it using a regionalized method (that uses locations as entities), and to check that the locations of processes are the intended ones along the whole supply chain.
+
+At the moment, we offer two methods that are regionalized using locations as entities: **EF 3.1 (adapted)** available in openLCA method package 2.4.0 and **LC-Impact** available in Nexus as standalone (compatible with the same databases as our method pack). For LC-Impact we provide also regionalization setups in json format, where the flow-binding has already been set. However, in this chapter you can learn how to calculate yourself characterization factors for specific locations, which works both for  methods already regionalized and method that are not yet updated, but which provide geographic information for their impact factors.
+
+### Check locations in openLCA
+
+A regionalised LCA needs to understand locations. In openLCA 2, available locations in a database are shown in the navigation tab under Database  &#8594; Background data &#8594; Locations.
+
+![](../media/regionalized_presence_locations.png)  
+_Available locations in a database_
+
+Opening one, you will see geographic data, including latitude, longitude and country code (e.g. ES for Spain), and the covered area defined by GeoJSON. It is also possible to modify the coordinates by using the text editor that can be opened by clicking on the pencil icon in the "Geographic data" section.
+
+![](../media/regionalized_general_information_spain.png)  
+_General geographic data - Example: Spain_
+
+Locations can be also imported in the active database, for instance from a GIS software, as GeoJSON files File &#8594; Import &#8594; other &#8594; geometries from GeoJSON.
+
+![](../media/regionalized_import_locations.png)  
+_Import of locations into active database_
+
+Alternatively, locations can be also drawn by users in [geojson.io](https://geojson.io/#map=2/20.0/0.0)  as polygons, lines or points. 
+
+![](../media/regionalized_geojson.png)  
+_geojson.io example_
+
+The coordinates text can then be just pasted in the text editor in openLCA, after the creation of a new location (right click on location folder &#8594; new location &#8594; add name and country code &#8594; open the text editor in the geographic data 
+("pencil" icon) &#8594; paste coordinate text from geojson.io).
+
+![](../media/regionalized_text_editor.png)  
+_Use of coordinates text from geojson.io example in the openLCA text editor_
+
+### Importing regional characteristics as GeoJSON file
+
+Data for regional characteristics are contained in GeoJSON files, which can be imported in openLCA. To regionalize an impact category, first go to "impact categories" folder and open an existing category (or create a new one). Then go to the tab "regionalized calculation" for the opened category. Here you need to import regional characteristics (e.g. population density, watershed area, characterization factors…) by clicking on "open" and selecting GeoJSON files available in your laptop (e.g. previously exported from a GIS software). Parameters are extracted during the GeoJSON file import and are available under the section "GeoJSON Parameters".
+
+![](../media/regionalized_calculation.png)  
+_Regionalized calculation_
+
+Each imported parameter can be visualized in a map by selecting the parameter and clicking on the "world" icon in the GeoJSON Parameters section.
+
+![](../media/regionalized_parameters.png)  
+_Visualization of parameters_
+
+### Binding regional characteristics (GeoJSON files) to flows
+
+Flows for which you want to calculate geo-spatial based CFs need to bound to the regional characteristics contained in GeoJSON files, so that the CFs can vary based on the selected location for exchanges and processes. In the "flow bindings" section under "regionalized calculation" in the open impact category, add the flows that you want to regionalize (use the "+" icon") and parametrize the "formula" field using the parameters extracted during the regional characteristics import and available under "GeoJSON parameters". In regionalized assessment, the parameter value derived from the GeoJSON file is used for the formula evaluation. Instead, if you apply non-regionalized LCIA or no location is available for exchanges and processes, the default CF value will be used in the calculations.
+
+![](../media/regionalized_flows.png)  
+_Example of flow binding and parameterization_
+
+Currently, openLCA cannot store the GeoJSON parameters and flow bindings, but you can save and export your setup by clicking on "save". You can import this configuration again at any time by clicking on "open" and selecting the exported setup.
+
+![](../media/regionalized_saving_setup.png)  
+_Saving geojson parameters and flow bindings_
+
+### Calculate CFs for selected locations
+
+The last step to set-up the regionalized LCIA method, is to link process locations and LCIA methods spatial units. Therefore, the intersection between GeoJSON file features and process geometries (stored in "Locations") is calculated by the software, thus resulting in dedicated CFs for locations selected by the user. By clicking on the "calculate" icon in the "flow bindings" section, the user defines the locations for which CFs are to be calculated for the flows added in the "flow bindings" section. 
+
+![](../media/regionalized_defining_location.png)
+_Defining the location for which the characterization factors are calculated_
+
+The resulting CFs for the selected locations and flows are available in the tab "characterization factors" for the open impact category. A flow for each selected location and the same flow without a specific location are created and assigned with a CF depending on the location, or with the default CF value for the case of the flow without a specific location.
+
+![](../media/regionalized_tab_cf.png)  
+_Example results of the tab "Characterization factors"_
+
+### Add the regionalized impact category to an impact assessment method
+
+When running LCIA, you need to select an impact assessment method. Therefore, the regionalized impact category/ies need to be added to the method that will be used to calculate the product system impact. To create a new regionalized method, right-click on the folder "impact assessment methods" and select "new LCIA method". Then you can add the previously created impact category in the section "impact categories" in the first tab "general information".
+
+![](../media/regionalized_impact_category.png)  
+_Adding an impact category to the tab "General information"_
+
+### Assign locations to processes and exchanges
+
+To perform regionalized LCIA, make sure to assign a location to your processes and/or exchanges. You can do this by going to the "geography" section in the "general information" tab of a process and selecting your desired location. 
+
+![](../media/regionalized_locations_processes.png)  
+_Assigning locations to processes_
+
+Location can be assigned to exchanges in processes by adding them to the "location" field for each flow in inputs and outputs. 
+
+![](../media/regionalized_locations_exchanges.png)  
+_Assining locations to exchanges_
+
+### Run regionalized LCIA of a product system
+
+To run regionalized LCIA for a product system, select a regionalized impact assessment method and check the box "regionalized calculation". Click on "Finish" to start the calculations.
+
+![](../media/regionalized_start_calculation.png)  
+_Calcualtion of a regionalized LCIA_
+
+Regionalized results can be analysed using different tabs, such as "impact analysis" and "locations".
+
+![](../media/regionalized_results.png)  
+![](../media/regionalized_results_2.png)  
+_Example results of a regionalized LCIA_
+
+</div>
+
+
+
+
+

src/cheat/usage.md

@@ -2,15 +2,15 @@
 
 <div style='text-align: justify;'>
 
-The "Usage" function allows the user to find where the selected "Flow", "Process" etc. is used. For this, right-click on a database element:
+The "Usage" function allows you to find where the selected "Flow", "Process" etc. is utilized within the system. For this, right-click on a database element:
 
 ![](../media/usage.png)
 
 After clicking on "Usage", the following window will show where the selected process is used:
 
 ![](../media/usage_results.png)
 
-This option allows you to know where a process is used, that it’s useful for example if you want to delete a connected process/flow. 
+This function it’s helpful for example if you want to delete a connected process/flow. 
 
 **_Note:_** Moreover, the "Used in processes" section in every product or waste flow ([General information tab](../flows/flow_tabs_contents.md)) shows you a more detailed "Usage" information.
 

src/contact.md

@@ -9,9 +9,9 @@ For manual-related inquiries, you can reach us at <a href="mailto:manual-feedbac
 ![](./media/greendelta.png)
 
 GreenDelta GmbH\
-Kaiserdamm 13\
-14057 Berlin, Germany\
-Tel. +49 30 62 924 - 319\
+Alt-Moabit 130\
+10557 Berlin, Germany\
+Tel. +49 30 4849 6030\
 Fax +49 30 48 496 - 991\
 <a href="mailto:[email protected]">[email protected]</a>\
 [www.greendelta.com](http://www.greendelta.com)

src/installation/download_installation.md

@@ -51,4 +51,6 @@ _Setup screen for installation in Windows_
 
 Follow the installation steps to the end and you can begin working with openLCA.
 
+_**Note:**_ If you encounter any issue with Windows Defender preventing you on installing openLCA, please have a look here (https://support.bemopro.com/hc/en-us/articles/11450999280531-Microsoft-Defender-SmartScreen-blocking-program-installation).
+
 </div>

src/parameters/parameters.md

@@ -36,14 +36,14 @@ _Global parameter - general information_
 ![](../media/parameters_tools.png)
 ![](../media/editing_uncertainty_in_the_global_parameter_table_2.png)
 ![](../media/editing_uncertainty_in_the_global_parameter_table.png)
-_View and edit Parameters under Database → Content_
+<br>_View and edit Parameters under Database &#8594; Content_
 
 To create an **Input and Dependent parameter**:
 
 1. Open the "Parameters" tab of an open process.
 2. Select the "+" at the top right-hand corner of the input/dependent parameters section.
 3. Assign a name, value, uncertainty (for an input parameter) and description.
-4. In case of a dependent parameters, a formula can be used linking it to the parameters it is dependent on. To write a correct formula, you can check the accepted constants, operators and functions in this [chapter](../advanced_top/formulas_in_openlca.md).
+4. In case of a dependent parameter, a formula can be used to link it to the parameters it is dependent on. To write a correct formula, you can check the accepted constants, operators and functions in this [chapter](../advanced_top/formulas_in_openlca.md).
 
 **_Note:_** An input/dependent parameter can be converted into a global parameter by right clicking on it and selecting "convert to global parameter" (**_new!_**).
 

src/projects/report.md

@@ -2,7 +2,7 @@
 
 In the report tab you will find the calculated results in the template you chose beforehand. It is generated as an html file with interactive elements based on Java. **The following is directly extracted from a report (_Java elements can not be displayed in this manual_):**
 
-_**Note**_: If you report is not displayed correctly, make sure you have WebView2 (for Windows) or WebKit (for Linux) installed on your device.
+_**Note**_: If you report is not displayed correctly, make sure you have WebView2 (for Windows) or WebKit (for Linux) installed on your device. Also make sure that the "Use Edge Browser" box in Preferences > Configuration is checked (see details in the File/Preferences/Configuration section of ["Running openLCA for the first time"](../running_olca_for_first_time.md)).
 
 
 <html lang="en"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8">

src/running_olca_for_first_time.md

@@ -48,6 +48,8 @@ The following options are available under **File**:
 	_**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.
 

src/updates.md

@@ -2,6 +2,10 @@
 
 In this section you can check what the major manual updates were about and when they were released.
 
+## 25.04.2024
+
+- Minor updates
+
 ## 19.03.2024
 
 - Added ["Exporting product systems"](./prod_sys/exporting.md) section.