Mopo AmBIENCE2ABM Demo

Rasku, Topi

doi:10.5281/zenodo.14282855

Published December 5, 2024 | Version v3

Workflow Open

Mopo AmBIENCE2ABM Demo

Rasku, Topi¹

1. VTT Technical Research Centre of Finland Ltd

# Mopo AmBIENCe2ABM demo

A demonstration Spine Toolbox workflow feeding SpineOpt from AmBIENCe and Hotmaps data.

Please note that downloading ERA5 weather data for long timespans using this demo can take hours!

## Key contents

1. `.spinetoolbox/` contains the Spine Toolbox project of the data processing workflow.

2. `data/` contains the Spine Datastores of the workflow.

3. `source/` contains the source code and data used by the processing.

## Requirements

In order for this workflow to run on your machine, you need to have the following installed:

1. [Git](https://git-scm.com/)

2. [Miniconda](https://docs.conda.io/en/latest/miniconda.html) for Python and environment management.

3. [Julia](https://julialang.org/) for running ArchetypeBuildingModel.jl.

## Installation

The `install.bat` script should automatically install and configure the dependencies

bundled into this workflow.

However, it requires that `conda` and `julia` are in your `PATH`.

The included AmBIENCe2ABM dataset doesn't come bundled with the large EU-wide

heated floor area raster datasets to save disk space.

Instead, they need to be cloned/downloaded and reprojected as instructed

in the `source/AmBIENCe2ABM/README.md`.

### Manual installation and updates

If you want to update the versions of `atlite` or `spine-toolbox`,

you probably need to recreate the `mopo_ambience_demo` conda environment manually.

Fortunately, these are the only packages there,

so creating the environment follows these steps:

1. Create a `mopo_ambience_demo` conda environment with `python=3.11`

2. Navigate to the root folder of your Spine-Toolbox.

3. `pip install atlite -r requirements.txt`

You can then re-freeze the environment with `pip freeze > requirements.txt`.

However, due to potential package conflicts, you'll probably need to iterate

`pip install -r requirements.txt` a few times before re-freezing.

## Usage

After installing the stuff required to run the Spine Toolbox workflow,

you should be able to start Spine Toolbox with the command:

```

python -m spinetoolbox .

```

From there, the different aspects of the workflow can be inspected,

and the whole workflow run.

## License

Note that included software repositories are subject to different licenses.

However, for the rest Creative Commons Attribution 4.0 International applies.

## References

Please refer to `source/AmBIENCe2ABM/README.md`.

## Acknowledgements

This work was supported by EU project Mopo (2023-2026),

which has received funding from European Climate,

Infrastructure and Environment Executive Agency under the European Union’s

HORIZON Research and Innovation Actions under grant agreement N°101095998.

Files