The IAM_tools - a Python package of tools to deal with IAM data.
Project description
IAM_tools
The IAM_tools is command line utility to query data from AMPERE Scenario database. Input data are comma separated value [csv] file.
For testing purpose there is small test file following IAM structure: tests/iam_test.csv
Installation
IAM_tools can be installed directly from gitlab repository:
pip install iam_tools --upgrade
Usage
The IAM_tools can be used to filter, query and export data from IAM.
The command line tool is filter_IAM
The filter use regexp
when selecting values from columns.
The columns to filter are: mode, region, scenario, variable.
The utility can be used to show unique values of this columns.
Selection can be exported to csv, mat and h5 output file.
If the output arg is omitted the result will be printed to console.
Examples
Run help:
filter_IAM -h
IAM_tools is designed to work with the AMPERE project model output. To follow the examples described below, you can use the small subsample (with modified numbers) used for testing. You can downlowd this file here.
Viewing unique entries for a specific index
Print all unique models:
filter_IAM iam_input.csv -unique model
Print to console unique regions of rows where model is GCAM:
filter_IAM iam_input.csv -model "GCAM" -unique region
Selecting rows based on the index
Print to console all rows where variables starts with "Capacity|Electricity|":
filter_IAM iam_input.csv -variable "^Capacity\|Electricity\|.*"
Note, that the vertical bar '|' has a special meaning in regex (as the or symbol). Thus to match the literal character '|' you have to escape it with a backslash ('\').
Export all rows where variable column start with Secondary Energy|Electricity| to my_output.mat [cell array] file:
filter_IAM iam_input.csv -variable "^Secondary Energy\|Electricity\|.*" -output my_output.mat
Export all rows where scenario column contains 450- and -OPT to my_output.csv file:
filter_IAM iam_input.csv -scenario "450-.*.-OPT" -output my_output.csv
Print to console all rows where models are either GCAM or REMIND:
filter_IAM iam_input.csv -model "GCAM|REMIND"
Export all rows where variable column start with Emissions|CO2 to my_output.csv file:
filter_IAM iam_input.csv -variable "^Emissions\|CO2.*" -output my_output.csv
Contributing
If you find a bug or have suggestions for improvement please use the Issue Tracker for communication. Development follows a gitlab centric workflow, thus if you want to contribute fork the repository and file a merge request when you are finished.
Authors
- Radek Lonka
- Konstantin Stadler
License
BSD 3-Clause License
Copyright (c) 2018, Industrial Ecology Digital Lab at NTNU
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.