Skip to content

Commit f8b39ef

Browse files
rename README (#66)
* rename readme
1 parent e289251 commit f8b39ef

File tree

1 file changed

+119
-0
lines changed

1 file changed

+119
-0
lines changed

README.md

Lines changed: 119 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,119 @@
1+
========
2+
fluidfoam
3+
========
4+
5+
|release| |docs| |Github-action| |coverage|
6+
7+
.. |release| image:: https://img.shields.io/pypi/v/fluidfoam.svg
8+
:target: https://pypi.python.org/pypi/fluidfoam/
9+
:alt: Latest version
10+
11+
.. |docs| image:: https://readthedocs.org/projects/fluidfoam/badge/?version=latest
12+
:target: http://fluidfoam.readthedocs.org
13+
:alt: Documentation status
14+
15+
.. |Github-action| image:: https://github.com/fluiddyn/fluidfoam/actions/workflows/build_and_test.yml/badge.svg
16+
:target: https://github.com/fluiddyn/fluidfoam/actions
17+
:alt: CI status
18+
19+
.. |coverage| image:: https://codecov.io/gh/fluiddyn/fluidfoam/branch/master/graph/badge.svg
20+
:target: https://codecov.io/gh/fluiddyn/fluidfoam/branch/master/
21+
:alt: Code coverage
22+
23+
The fluidfoam package provides Python classes useful to perform some plot with OpenFoam data.
24+
25+
What is this repository for?
26+
----------------------------
27+
28+
* Openfoam Tools
29+
* Version : 0.2.9
30+
* Supported OpenFoam Versions : 2.4.0, 4.1 to 9, v1712plus to latest
31+
* Supported Python Versions : >= 3.8
32+
33+
Documentation and Examples
34+
--------------------------
35+
36+
`http://fluidfoam.readthedocs.org
37+
<http://fluidfoam.readthedocs.org>`_
38+
39+
Deployment instructions
40+
-----------------------
41+
42+
The simplest way to install fluidfoam is by using pip::
43+
44+
pip install fluidfoam --user
45+
46+
You can get the source code from `github
47+
<https://github.com/fluiddyn/fluidfoam>`_ or from `the Python Package Index
48+
<https://pypi.python.org/pypi/fluidfoam/>`_.
49+
50+
The development mode is often useful. From the root directory, run::
51+
52+
python setup.py develop --user
53+
54+
55+
Committing instructions (in development mode)
56+
---------------------------------------------
57+
58+
A good starting point is to follow this `forking tutorial <https://guides.github.com/activities/forking/>`_.
59+
60+
To clone your fork of fluidfoam repository::
61+
62+
git clone https://github.com/your_username/fluidfoam
63+
64+
To get the status of the repository::
65+
66+
git status
67+
68+
In case of new/modified file(s)::
69+
70+
git add new_file
71+
72+
To commit a revision on the local repository::
73+
74+
git commit -m "comment on the revision"
75+
76+
To push the revision on your github fluidfoam repository::
77+
78+
git push
79+
80+
To propose your changes into the main fluidfoam project, follow again the `forking tutorial <https://guides.github.com/activities/forking/>`_.
81+
82+
Example Usage
83+
-------------
84+
85+
* https://sedfoam.github.io
86+
87+
Core Developers
88+
---------------
89+
90+
* Cyrille.Bonamy@univ-grenoble-alpes.fr
91+
92+
Other Contributors
93+
------------------
94+
95+
* Julien.Chauchat@univ-grenoble-alpes.fr
96+
* amathieu@udel.edu
97+
* Remi.Chassagne@univ-grenoble-alpes.fr
98+
* Quentin.Clemencot@univ-grenoble-alpes.fr
99+
* Matthias.Renaud@univ-grenoble-alpes.fr
100+
* Alban.Gilletta.De.Saint.Joseph@france-energies-marines.org
101+
* Gabriel Goncalves
102+
103+
Emeritus Core Developers
104+
------------------------
105+
106+
* Pierre.Augier@legi.cnrs.fr
107+
108+
Emeritus Developers
109+
------------------------
110+
111+
* Guillaume.Maurice@univ-grenoble-alpes.fr
112+
* Tim.Nagel@legi.cnrs.fr
113+
114+
License
115+
-------
116+
117+
fluidfoam is distributed under the GNU General Public License v3 (GPLv3 or newer).
118+
119+
.. _GPLv3: https://www.gnu.org/licenses/gpl-3.0.en.html

0 commit comments

Comments
 (0)