Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 1 addition & 0 deletions docs/node/usage/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -32,3 +32,4 @@ For detailed documentation, please see: 'villas node'
- [`villas test`](villas-test.md)
- [`villas zmq-keygen`](villas-zmq-keygen.md)
- [`villas conf2json`](villas-conf2json.md)
- [`villas chronics`](villas-chronics.md)
33 changes: 33 additions & 0 deletions docs/node/usage/villas-chronics.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,33 @@
---
sidebar_position: 3
---

# villas chronics

The `villas chronics` command is a tool that can be used to process CSV files containing load and generator data to create chronics files for input in power grid simulations using [Grid2op](https://grid2op.readthedocs.io/en/stable/user/chronics.html).
It reads normalized active and reactive power values from `Load` and `SGen` CSV files, maps them to buses given through a grid configuration json file and outputs formatted CSV files (optionally compressed in bz2 format).

# Usage
In command line, you run: `villas-chronics config.json`

``` url="generated/node/usage/villas-signal.txt" title="villas-chronics --help"
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
``` url="generated/node/usage/villas-signal.txt" title="villas-chronics --help"
``` url="generated/node/usage/villas-chronics.txt" title="villas-chronics --help"

Please note that this codeblock gets completely overwritten by the scripts in https://github.com/VILLASframework/documentation/tree/master/tools

Usage: villas-chronics config.json
config.json can be as shown below:

{
"loads_dir": "/workspaces/node-main/input_files",
"sgens_dir": "/workspaces/node-main/input_files",
"grid": "/workspaces/node-main/input_files/grid_file.json",
"output": "/workspaces/node-main/output_files",
"compress": true
}
```

## Docker
```
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
```
```shell

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I would also prefer to simply show the villas chronics command here. Without all the Docker boilerplate..

docker run --rm --entrypoint villas-chronics \
-v "$PWD:/workspaces/node-main" \
-w /workspaces/node-main \
registry.git.rwth-aachen.de/acs/public/villas/node:executable-timeseries-chronics-x86_64 \
-d info /workspaces/node-main/input_files/chronics.json
```
Loading