Metadata-Version: 2.1
Name: python-grace
Version: 0.0.4
Summary: An unofficial Python wrapper for the GRACE system.
Home-page: https://github.com/tueda/python-grace
License: MIT
Keywords: particle physics,automatic calculation
Author: Takahiro Ueda
Author-email: tueda@st.seikei.ac.jp
Requires-Python: >=3.6.1,<4.0.0
Classifier: Development Status :: 2 - Pre-Alpha
Classifier: Intended Audience :: Science/Research
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Topic :: Scientific/Engineering :: Physics
Requires-Dist: appdirs (>=1.4.4,<2.0.0)
Requires-Dist: click (>=7.1.2,<8.0.0)
Requires-Dist: importlib-metadata (>=3.6.0,<4.0.0); python_version < "3.8"
Requires-Dist: patch (>=1.16,<2.0)
Project-URL: Repository, https://github.com/tueda/python-grace
Description-Content-Type: text/markdown

python-grace
============

[![Test](https://github.com/tueda/python-grace/workflows/Test/badge.svg?branch=master)](https://github.com/tueda/python-grace/actions?query=branch:master)
[![PyPI version](https://badge.fury.io/py/python-grace.svg)](https://pypi.org/project/python-grace/)

An unofficial Python wrapper for [the GRACE system](https://minami-home.kek.jp/)
(the public version for tree-level computations).

*This is a pre-alpha version.*


Requirements
------------

- Python >= 3.6.1
- pip >= 19.0
- C compiler
- Fortran compiler
- Make utility
- X Window system (optional, for `gracefig` and `grcdraw`)
- Motif Toolkit or its clone (optional, for `gracefig`)


Installation
------------

Use `pip`:
```sh
pip install python-grace
```
which installs the `grace` command.
(You may need to adjust `$PATH`.
You can always use `python -m grace`, instead.)

To select the compilers, specify them as environment variables when `pip` runs:
```sh
CC=gcc-9 FC=gfortran-9 pip install python-grace
```

You can use [`pipx`](https://pipxproject.github.io/pipx/) instead of `pip`
if you prefer to install this software in an isolated and/or temporary environment.


Example
-------

```sh
mkdir my_process
cd my_process
grace template sm/eewwa
grace grc
grace grcfort
make all
./gauge
./integ
./spring
```


License
-------

The code in this repository is covered under
[the MIT license](https://github.com/tueda/python-grace/blob/master/LICENSE).
(Note that, however, the source code of the GRACE system is *not* MIT licensed.
Indeed, this repository itself does not contain any part of GRACE.
When you install this software, the source code distribution of GRACE will
automatically be downloaded from the original site.)

