https://github.com/open-risk/leontief
Leontief is a C++ package to work with economic Input-Output models
https://github.com/open-risk/leontief
economic-data eigen exiobase figaro input-output-analysis leontief-input-output-model sustainable-finance
Last synced: 4 months ago
JSON representation
Leontief is a C++ package to work with economic Input-Output models
- Host: GitHub
- URL: https://github.com/open-risk/leontief
- Owner: open-risk
- License: gpl-3.0
- Created: 2024-04-25T11:53:33.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2025-05-22T10:36:49.000Z (5 months ago)
- Last Synced: 2025-06-29T06:06:01.792Z (4 months ago)
- Topics: economic-data, eigen, exiobase, figaro, input-output-analysis, leontief-input-output-model, sustainable-finance
- Language: C++
- Homepage: https://www.openriskmanagement.com/documentation/leontief/
- Size: 271 KB
- Stars: 2
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: Changelog.md
- License: LICENSE
Awesome Lists containing this project
- awesome-sustainable-finance - Leontief - Leontief is a C++ package to work with economic Input-Output models (Carbon Footprint (EEIO or LCA models))
README
# Leontief
Leontief is a C++/Python toolkit to facilitate working with economic Input-Output models.
## Overall Functionality Objectives
The overall design principle behind Leontief is to strike a balance between usability and performance when working with and/or developing algorithms and tools related to economic input-output systems. A key such design decision is to use a user-friendly C++ library for vector, matrix, tensor manipulations that offers a higher-level API similar e.g., to that of Matlab.
Leontief helps with a number of typical tasks in Environmentally Extended Input-Output modeling:
* Pre-processing Input-Output tables using command line tools and ingesting IO matrices into a C++ environment for further calculations.
* Solving typical EEIO problems using a library of tested algorithms.
* Investigating ad-hoc research questions by writing new high-level code in the form scripts. In particular emphasize graph-oriented tools and calculations
The current focus of development is around utilizing the FIGARO dataset but all open databases will be integrated in due course.
## Installation / Workflow
* Clone the repository into your own work environment.
* The command line scripts included in the leontief/scripts directory should be working immediately on a standard linux distribution (or Windows WSL).
### Dependencies
A major part of Leontief is a specialized EEIO C++ library that leverages other lower level C++ libraries. To augment or rebuild the library from source you will need to have first a working C++ toolchain that can compile modern C++.
Conan is recommended as a means to pull in dependencies but is not absolutely required. The current dependency list includes:
* The **eigen** library providing vector,matrix,tensor containers and linear algebra algorithms
* The **poco** library providing general purpose facilities
* The **catch2** library for testing
For compiling the C++ code, Leontief uses **cmake**.
### Testing
There is a suit of catch2 based tests that help verify that everything is installed and running properly.
### Conan Installation
* pip install conan
* conan install . --output-folder=cmake-build-debug --build=missing -s build_type=Debug
### Data Organization
#### Downloading Scripts
Create a leontief/data subdirectory. Download, move and extract publicly available IO databases into the data directory.
Current download scripts are in the directory leontief/scripts
* [exiobase](scripts/download_exiobase.sh)
* [figaro](scripts/download_figaro.sh)
* [oecd-icio](scripts/download_oecd-icio.sh)
```text
bash scripts/download_oecd-ici.sh
```
#### Pre-processing
The focus of Leontief is on high performance *numerical calculations* involving large matrices. It does not offer dataframe type functionality for searching or filtering data, this is more economically achieved using Python. Yet some preprocessing is required. The following scripts offer needed functionality:
* Strip the matrix files (e.g., bash strip_exiobase.sh) from label data (we will not need those for numerical C++ calculations).
* TBC
#### IO Systems
TODO
#### SUT Systems
TODO
#### EEIO Functionality
## Further Resources
* Working with CLI tools to process large matrices is elaborated further on the eLearning platform [Open Risk Academy](https://www.openriskacademy.com/course/view.php?id=76)