Skip to content

Commit

Permalink
Move things for release v0.2
Browse files Browse the repository at this point in the history
  • Loading branch information
lucduron committed Oct 13, 2017
1 parent 051e3e9 commit 3a35618
Show file tree
Hide file tree
Showing 67 changed files with 35 additions and 13 deletions.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
30 changes: 17 additions & 13 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,49 +5,53 @@ Python Telemac Tools
* [Developer documentation](https://cnr-engineering.github.io/PyTelTools) ([repository with static files](https://github.com/CNR-Engineering/CNR-Engineering.github.io))

## Installation and requirements
It relies on Python3 and requires packages which are listed in [requirements.txt](https://github.com/CNR-Engineering/PyTelTools/blob/master/requirements.txt).
PyTelTools relies on Python3 and requires packages which are listed in [requirements.txt](https://github.com/CNR-Engineering/PyTelTools/blob/master/requirements.txt).

Packages installation can be done with pip:
### Installation via pip
Packages installation can be done with **pip**:
```bash
$ pip install -r requirements.txt
# user install
$ pip install -e git://github.com/CNR-Engineering/PyTelTools.git#egg=PyTelTools --user
# default install (needs to be root)
# pip install -e git://github.com/CNR-Engineering/PyTelTools.git#egg=PyTelTools
```

### Virtualenv
The use of isolated Python environments is possible through virtualenv:
### Installation in a virtual environnement
The use of isolated Python environments is possible through **virtualenv**:
```bash
$ virtualenv venv --python=python3
$ source venv/bin/activate
(venv) $ pip install -r requirements.txt --upgrade
(venv) $ pip install -e git://github.com/CNR-Engineering/PyTelTools.git#egg=PyTelTools
```

## Usage

### Open interface
```bash
$ python main_interface.py
$ python outil_carto.py
$ python PyTelTools/main_interface.py
$ python PyTelTools/outil_carto.py
```

### Use command line for workflow
**Load** a workflow project file in the **GUI** (in mono tab):
```bash
$ python workflow/interface.py -i path_to_workflow_project_file.txt
$ python PyTelTools/workflow/interface.py -i path_to_workflow_project_file.txt
```

**Load** and **run** a workflow project from the **command line**:
```bash
$ python workflow/mono_gui.py -i path_to_workflow_project_file.txt
$ python workflow/multi_gui.py -i path_to_workflow_project_file.txt
$ python PyTelTools/workflow/mono_gui.py -i path_to_workflow_project_file.txt
$ python PyTelTools/workflow/multi_gui.py -i path_to_workflow_project_file.txt
```

The argument `-h` provides a **help** message for the corresponding script and specify its **usage**.
Output **verbosity** can be increased (debug mode) with `-v` argument.

## Configure
Modify `conf/settings.py` to change default parameters.
Modify `PyTelTools/conf/settings.py` to change default parameters.

For example to change default Serafin language (for variable detection)
and to change increase verbosity write this in `conf/settings.py`:
and to change increase verbosity write this in `PyTelTools/conf/settings.py`:
```python
from conf.settings_sample import *

Expand Down
18 changes: 18 additions & 0 deletions setup.py
Original file line number Diff line number Diff line change
@@ -0,0 +1,18 @@
#!/usr/bin/env python

from setuptools import setup


with open('requirements.txt') as f:
requirements = f.read().splitlines()

setup(
name='PyTelTools',
version='0.2',
author='Luc Duron',
author_email='[email protected]',
py_modules=['PyTelTools'],
install_requires=requirements,
description='Python library for Telemac post-processing tasks',
url='https://github.com/CNR-Engineering/PyTelTools',
)

0 comments on commit 3a35618

Please sign in to comment.