FAME-Io

The open Framework for distributed Agent-based Models of Energy systems.
https://gitlab.com/fame-framework/fame-io

Category: Energy Systems
Sub Category: Energy System Modeling Frameworks

Keywords

FAME

Keywords from Contributors

agent-based-modeling electricity market modelling energy transition

Last synced: about 15 hours ago
JSON representation

Repository metadata

Python package for input file creation for FAME models and digestion of FAME outputs. [Documentation](https://fame-framework.gitlab.io/fame-io/)

• Host: gitlab.com
• URL: https://gitlab.com/fame-framework/fame-io
• Owner: fame-framework
• License: apache-2.0
• Created: 2020-03-23T10:08:14.739Z (almost 6 years ago)
• Default Branch: dev
• Last Synced: 2025-12-21T23:16:18.606Z (about 2 months ago)
• Topics: FAME
• Stars: 4
• Forks: 6
• Open Issues: 28
• Releases: 0

https://gitlab.com/fame-framework/fame-io/blob/dev/

          
# FAME-Io

## *Prepare input and digest output from simulation models*

[![License](https://img.shields.io/pypi/l/fameio.svg)](https://badge.fury.io/py/fameio)
[![Cite](https://img.shields.io/badge/DOI-10.21105%2Fjoss.04958-blue)](https://doi.org/10.21105/joss.04958)
[![Pipeline](https://gitlab.com/fame-framework/fame-io/badges/main/pipeline.svg)](https://gitlab.com/fame-framework/fame-io/commits/main)
[![Code Coverage](https://gitlab.com/fame-framework/fame-io/badges/main/coverage.svg)](https://gitlab.com/fame-framework/fame-io/-/jobs)
![Last Commit](https://img.shields.io/gitlab/last-commit/fame-framework%2Ffame-io)

FAME-Io compiles input for FAME models and extracts model output to human-readable files. Model data is handled in the efficient protobuf format.

[FAME](https://gitlab.com/fame-framework/wiki/-/wikis/home) is the open **F**ramework for distributed **A**gent-based **M**odels of **E**nergy systems.
Check out the full [FAME-Io documentation](https://fame-framework.gitlab.io/fame-io).

## What is FAME-Io?

FAME-Io is the input-output toolkit for FAME-based simulation models.
The relationship to other components can be seen below.



FAME-Io combines model data and user's agent configurations to create a simulation input file for computations with FAME-Core.
Once these computations have finished, FAME-Io converts the simulation output file and returns its contents in a readable format.

Thus, with FAME-Io you can:

* Compile input binaries for simulation models built with FAME,
* Extract output binaries to human-readable formats like CSV and JSON,
* Edit large CSV files to enhance compilation speed.

## Who is FAME-Io for?

FAME-Io is a vital file-conversion component for FAME-based workflows. If your model is not built with [FAME](https://gitlab.com/fame-framework/wiki/-/wikis/home), you will probably not profit from FAME-Io.

## Applications

FAME-Io is used with any model that is based on FAME.
An example of its application is the electricity market model [AMIRIS](https://helmholtz.software/software/amiris).

## Installation

FAME-Io requires Python 3.10 or higher.
We recommend installing `fameio` using PyPI: `pip install fameio`

## Usage

FAME-Io offers three command-line scripts:

* [makeFameRunConfig](https://fame-framework.gitlab.io/fame-io/usage/make.html): creates a protobuf file for FAME applications using YAML definition files and CSV files,
* [convertFameResults](https://fame-framework.gitlab.io/fame-io/usage/convert.html): takes an output file in protobuf format of FAME-based applications and converts it into files in CSV / JSON format,
* [reformatTimeSeries](https://fame-framework.gitlab.io/fame-io/usage/reformat.html): takes CSV time series files and reformats them into FAME time format to speed up the first command.

## Community

FAME-Io is mainly developed by the German Aerospace Center, Institute of Networked Energy Systems.
We provide support via the dedicated email address [fame@dlr.de](mailto:fame@dlr.de).

**We welcome all contributions**: bug reports, feature requests, documentation enhancements, and code.

For substantial enhancements, we recommend that you contact us via [fame@dlr.de](mailto:fame@dlr.de) for working together on the code in common projects or towards common publications and thus further develop FAME-Io.

Please see our [Contribution Guidelines](https://fame-framework.gitlab.io/fame-io/contribute/contribute.html) and [Code of Conduct](https://fame-framework.gitlab.io/fame-io/contribute/conduct.html).

## Citing FAME-Io

If you use FAME-Io in academic work, please cite: [DOI 10.21105/joss.04958](https://doi.org/10.21105/joss.04958)

```
@article{fameio2023joss,
  author  = {Felix Nitsch and Christoph Schimeczek and Ulrich Frey and Benjamin Fuchs},
  title   = {FAME-Io: Configuration tools for complex agent-based simulations},
  journal = {Journal of Open Source Software},
  year    = {2023},
  doi     = {doi: https://doi.org/10.21105/joss.04958}
}
```

In other contexts, please include a link to our [Gitlab repository](https://gitlab.com/fame-framework/fame-io).

## Acknowledgements

The development of FAME-Io was funded by the German Aerospace Center (DLR).
We express our gratitude to all [contributors](CONTRIBUTING.md#list-of-contributors).

        

---

Committers metadata

Last synced: about 17 hours ago

Name	Email	Commits
Christoph Schimeczek	C****k@d****e	565
Felix Nitsch	f****h@d****e	260
Christoph Schimeczek	c****k@d****e	60
dlr_fn	8****w	16
nits_fe	n****e	14
Aurelien Regat-Barrel	a****b@c****t	12
frey_ul	u****y@d****e	5
Willeke	l****e@d****e	4
schi_co	s****o@T****e	3
Frey	U****y@d****e	2
Andrea Cattaneo	2****a@u****m	1
Felix Nitsch	5****n@u****m	1
Felix Nitsch	f****h@g****t	1
Florian Maurer	m****r@f****e	1
Johannes Kochems	j****s@d****e	1

Committer domains:

• dlr.de: 7
• users.noreply.gitlab.com: 2
• fh-aachen.de: 1
• gmx.at: 1
• tt-000335.intra.dlr.de: 1
• cyberkarma.net: 1

---

Issue and Pull Request metadata

Last synced: 3 days ago

---

Package metadata

• Total packages: 1
• Total downloads:
  • pypi: 480 last-month
• Total dependent packages: 2
• Total dependent repositories: 3
• Total versions: 36
• Total maintainers: 1

---

Dependencies

Score: 12.35999472780243