Metadata-Version: 2.4
Name: gkvfig
Version: 0.1.1
Summary: A Python package for generating PDF of GKV standard ASCII output
Author-email: Shinya Maeyama <maeyama.shinya@nifs.ac.jp>
License: MIT License
Requires-Python: >=3.7
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: numpy>=1.24
Requires-Dist: matplotlib>=3.8
Requires-Dist: pandas>=2.2
Requires-Dist: reportlab>=4.0
Requires-Dist: pypdf>=4.3
Dynamic: license-file

# gkvfig - Generating PDF of GKV standard output
---

**gkvfig** is a Python package that generates a summary figure PDF of GKV standard ASCII output.
(Previous `fig_stdout` tool using shell/awk/gnuplot/latex is converted to Python.)


## Installation

To install from PyPI:
```bash
pip install gkvfig
```
Or install the latest development version from GitHub:
```bash
pip install git+https://github.com/GKV-developers/gkvfig.git
```


## Usage

#### **(i) Basic usage: As a command line tool**
```sh
python -m gkvfig -d DIR
```
The argument `DIR` is the path of GKV output directory. The namelist file `DIR/gkvp.namelist.001`, log file `DIR/log/gkvp.000000.0.log.001`, and hst directory `DIR/hst/` should exist.
You get a summary PDF file `CWD/figpdf_yyyymmdd_hhmmss/fig_stdout.pdf`.

#### **(ii) As a Python function**

```python
from gkvfig import gkvfig

gkvfig(gkv_stdout_dir="YOUR GKV OUTPUT DIR")
```
You get a summary PDF file `CWD/figpdf_yyyymmdd_hhmmss/fig_stdout.pdf`, always in the current working directory `CWD`.


## Dependencies

gkvfig requires the following Python packages:
- `numpy`, `matplotlib`, `pandas`, `reportlab`, `pypdf`

## License

This project is licensed under the MIT License. See the [`LICENSE`](LICENSE) file for details.

## Author

Developed by Shinya Maeyama (maeyama.shinya@nifs.ac.jp)
