-
Notifications
You must be signed in to change notification settings - Fork 7
/
README.rst
149 lines (87 loc) · 4.5 KB
/
README.rst
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
======================
OpenAlea Documentation
======================
.. image:: https://readthedocs.org/projects/openalea/badge/?version=latest
:target: https://openalea.readthedocs.io/en/latest/?badge=latest
:alt: Documentation Status
Institutes (Sponsors)
---------------------
OpenAlea is developed, maintainted and mainly funded by three institutes: CIRAD, INRIA, and INRAE.
License
-------
OpenAlea is licensed under the CeCILL-C free software license agreement.
Official documentation
----------------------
https://readthedocs.org/projects/openalea.readthedocs.io
Description
===========
OpenAlea is an open source project primarily aimed at the plant research community. It is a distributed collaborative effort to develop Python libraries and tools that address the needs of current and future works in Plant Architecture modeling. OpenAlea includes modules to analyze, visualize, and model the functioning and growth of plant architecture.
This repository contains all the documentation published in the `official documentation of OpenAlea <https://readthedocs.org/projects/openalea.readthedocs.io/en/latest>`_.
Information about OpenAlea can also be found in the wiki: https://github.com/openalea/openalea.rtfd.io/wiki
Installation
============
Install Miniforge 3
===================
The simplest way to install OpenAlea and all its dependencies is to use Miniforge 3:
`Install Miniforge 3 <https://github.com/conda-forge/miniforge>`_
Create OpenAlea environment:
=============================
Once you have installed Miniforge, you will have access to Miniforge Prompt (Windows) or from a terminal (Mac/Linux).
**Open Miniforge Prompt (Windows) or a terminal (Mac/Linux) and type:**
.. code-block:: bash
mamba create -n openalea -c openalea3 openalea.plantgl openalea.lpy openalea.visualea openalea.mtg notebook -y
.. code-block:: bash
mamba activate openalea
You should now be in your "openalea" environment! Well Done!
Usage
=====
Tutorials to use the different features of OpenAlea can be found in the `documentation <https://openalea.readthedocs.io/en/latest/tutorials/index.html>`_.
Contribution
============
You can contribute to the OpenAlea project by participating in the `Git Workflow <http://virtualplants.github.io/contribute/devel/git-workflow.html>`_, or by opening an issue or a pull request to address a problem or a fix.
Troubleshooting
===============
Installation Issues
-------------------
Dependency Errors
~~~~~~~~~~~~~~~~~
**Description**: Installation fails with dependency errors.
**Solution**: Ensure that you are using the latest version of Miniforge and that your environment is clean before installing OpenAlea. You can remove an existing environment with:
.. code-block:: bash
mamba env remove -n openalea
Then, try creating the environment again.
Command Not Found
~~~~~~~~~~~~~~~~~
**Description**: "mamba" command not found.
**Solution**: Make sure Miniforge is correctly installed and added to your system's PATH. You might need to restart your terminal or Miniforge Prompt.
Module Import Issues
--------------------
Modules Not Found in Jupyter Notebook
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
**Description**: OpenAlea modules not found when importing in a Jupyter notebook.
**Solution**: Ensure that you have activated the OpenAlea environment before starting the Jupyter notebook. You can activate the environment with:
.. code-block:: bash
mamba activate openalea
If the issue persists, try installing the Jupyter notebook within the OpenAlea environment:
.. code-block:: bash
mamba install notebook
Updating OpenAlea
-----------------
How to Update OpenAlea
~~~~~~~~~~~~~~~~~~~~~~
To update OpenAlea and its dependencies, activate your OpenAlea environment and run:
.. code-block:: bash
mamba update -c openalea3 openalea.plantgl openalea.lpy openalea.visualea openalea.mtg
Contribution
------------
How to Contribute to OpenAlea
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
You can contribute by participating in the `Git Workflow <http://virtualplants.github.io/contribute/devel/git-workflow.html>`_, or by opening an issue or a pull request on the OpenAlea GitHub repository.
Additional Resources
--------------------
Tutorials and Examples
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
More tutorials and examples can be found in the `official documentation <https://openalea.readthedocs.io/en/latest/tutorials/index.html>`_.
Contact
=======
For further assistance, you can reach out to the development team creating an `issue on github <https://github.com/openalea/openalea/issues>`_.