Metadata-Version: 2.1
Name: midas-weather
Version: 2.0.2
Summary: A Midas module for weather datasets.
Author-email: Stephan Balduin <stephan.balduin@offis.de>
Project-URL: Documentation, https://midas-mosaik.gitlab.io/midas
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: midas-mosaik~=2.0.0
Requires-Dist: mosaik_api
Requires-Dist: matplotlib
Requires-Dist: numpy
Requires-Dist: pandas
Requires-Dist: tables
Requires-Dist: wget

# Midas Weather

## Description

This package contains a midas module providing a simulator for weather data.

Although this package is intendet to be used with midas, it can be use it in any mosaik simulation scenario.

## Installation

This package will usually be installed automatically together with `midas-mosaik` if you opt-in for the `base` extra.
It is available on pypi, you can install it manually with 

```bash
pip install midas-weather
```

## Usage

The complete documentation is available at https://midas-mosaik.gitlab.io/midas.

### Inside of midas

To use the weather data inside of midas, add `weather` to your modules

```yaml
my_scenario:
  modules:
    - weather
    - ...
```

and configure it with

```yaml
  weather_params:
    my_weather_scope:
      weather_mapping:
        WeatherCurrent:
          - interpolate: true
            randomize: true
```

If a store module is enabled, the weather module will automatically send all outputs to the store.


### Any mosaik scenario

If you don't use midas, you can add the `weather` manually to your mosaik scenario file.
First, the entry in the `sim_config`:

```python
sim_config = {
    "WeatherData": {"python": "midas_weather.simulator:WeatherDataSimulator"},
    # ...
}
```

Next, you need to define `start_date` and `step_size`.
The `start_date` is to be provided as ISO datestring and can anything between 2009 and 2022:

```python
start_date = "2021-06-08 14:00:00+0000"
```

The `step_size` can be anything between 1 and 3600. 
Higher values might be possible, but this is untested.

Now, the simulator can be started:

```python
weather_sim = world.start("WeatherData", step_size=900, start_date=start_date)
```

Next, a weather data model can be started:

```python
weather_model = weather_sim.WeatherCurrent(interpolate=True, randomize=True)

```

Finally, the model needs to be connected to other models:

```python
world.connect(weather_model, other_entity, "t_air_deg_celsius", "wind_v_m_per_s")
```

## License

This software is released under the GNU Lesser General Public License (LGPL). 
See the license file for more information about the details.
