Skip to content
Snippets Groups Projects
Commit 23cd57f2 authored by Mayr, Hannes's avatar Mayr, Hannes
Browse files

Acknowledgement chapter and how to install plotID on a distribution that ships...

Acknowledgement chapter and how to install plotID on a distribution that ships older than python 3.10.
parent 914b8f5b
Branches
Tags
3 merge requests!52Create v0.2.2,!51Fix documentation build,!50Many additions to the documentation
About plotID
==================================
plotID is developed at the Institut Fluidsystemtechnik within nfdi4ing at the Technische Universität Darmstadt.
Acknowledgements
---------------
The authors would like to thank the Federal Government and the Heads of Government of the Länder, as well as the Joint Science Conference (GWK), for their funding and support within the framework of the NFDI4Ing consortium. Funded by the German Research Foundation (DFG) - project number 442146713.
\ No newline at end of file
...@@ -8,7 +8,7 @@ The plotID package depends on other software for its full funcionality. Since pl ...@@ -8,7 +8,7 @@ The plotID package depends on other software for its full funcionality. Since pl
- `qrcode <https://github.com/lincolnloop/python-qrcode>`_: Creates QR codes from input data. qrcode is used to create the QR code which is printed on the plot in the end. - `qrcode <https://github.com/lincolnloop/python-qrcode>`_: Creates QR codes from input data. qrcode is used to create the QR code which is printed on the plot in the end.
- `numpy <https://numpy.org/doc/stable/>`_: Package for scientific computing. Right now it is only used to generate sample data in the examples. Since it is a dependency of matplotlib, it has to be installed anyway. - `numpy <https://numpy.org/doc/stable/>`_: Package for scientific computing. Right now it is only used to generate sample data in the examples. Since it is a dependency of matplotlib, it has to be installed anyway.
Optional depedencies that are not necessary to run plotID but more to contribute to the code are the following: Optional dependencies that are not necessary to run plotID but more to contribute to the code are the following:
- `coverage <https://coverage.readthedocs.io/en/6.5.0/#>`_: Program to measure the code coverage. It is used in the development of plotID to monitor the coverage of the code when the unit tests are run. - `coverage <https://coverage.readthedocs.io/en/6.5.0/#>`_: Program to measure the code coverage. It is used in the development of plotID to monitor the coverage of the code when the unit tests are run.
- `sphinx <https://www.sphinx-doc.org/en/master/>`_: Program to build documentation. For example, this documentatio is generated with the help of sphinx. - `sphinx <https://www.sphinx-doc.org/en/master/>`_: Program to build documentation. For example, this documentatio is generated with the help of sphinx.
......
...@@ -10,9 +10,11 @@ Welcome to plotID's documentation! ...@@ -10,9 +10,11 @@ Welcome to plotID's documentation!
:maxdepth: 2 :maxdepth: 2
:caption: Contents: :caption: Contents:
README <readme_link.rst> Overview <readme_link.rst>
Structure and architecture <structure.rst> Installation <installation.rst>
Dependencies <dependencies.rst> Dependencies <dependencies.rst>
Structure and architecture <structure.rst>
About <about.rst>
Indices and tables Indices and tables
......
Installation of plotID
==================================
For installation instructions, first have a look at the general :doc:`readme_link` or the `README.md <https://git.rwth-aachen.de/plotid/plotid_python/-/blob/main/README.md>`_ file. More detailed information about the installation process can then be found here.
Wrong python version
--------------------
To install and run plotID a python version ≥ 3.10 is required. If your linux distribution is shipped with a python version < 3.10, you still can install a newer python version. Intalling python 3.10 on Debian or Ubuntu would look like this
.. code:: bash
sudo apt install python3.10 python3.10-venv
You can then create a virtual environment "venv" to run plotID inside it
.. code:: bash
python3.10 -m venv venv
Now activate the venv
.. code:: bash
source venv/bin/activate
The virtual environment now runs with python 3.10 and plotID can be installed the usual way as described in :doc:`Overview`.
\ No newline at end of file
...@@ -12,30 +12,6 @@ plotid.create\_id module ...@@ -12,30 +12,6 @@ plotid.create\_id module
:undoc-members: :undoc-members:
:show-inheritance: :show-inheritance:
plotid.example module
---------------------
.. automodule:: plotid.example
:members:
:undoc-members:
:show-inheritance:
plotid.filecompare module
-------------------------
.. automodule:: plotid.filecompare
:members:
:undoc-members:
:show-inheritance:
plotid.hdf5\_external\_link module
----------------------------------
.. automodule:: plotid.hdf5_external_link
:members:
:undoc-members:
:show-inheritance:
plotid.plotoptions module plotid.plotoptions module
------------------------- -------------------------
......
Readme File Overview
========
README file
----------- -----------
.. include:: ../../README.md .. include:: ../../README.md
......
0% Loading or .
You are about to add 0 people to the discussion. Proceed with caution.
Please register or to comment