Commit last-minute

hydroshoot/doc/overview.rst

@@ -0,0 +1,53 @@
+========
+Overview
+========
+
+
+What is HydroShoot about?
+=========================
+HydrShoot is a functional-structural plant model that simulates the interactions between shoot's hydraulic structure,
+gas-exchange and energy-budget, at the organ level.
+
+..  |fig1| image:: figs/intro_canopy.png
+    :width: 300
+..  |fig2| image:: figs/intro_irradiance.png
+    :width: 300
+..  |fig3| image:: figs/intro_hydraulic.png
+    :width: 300
+..  |fig4| image:: figs/intro_net_photosynthesis.png
+    :width: 300
+..  |fig5| image:: figs/intro_transpiration.png
+    :width: 300
+..  |fig6| image:: figs/intro_temperature.png
+    :width: 300
+
+
+.. table::
+    :align: center
+
+    +--------+--------+
+    | |fig1| | |fig2| |
+    +--------+--------+
+    | |fig3| | |fig4| |
+    +--------+--------+
+    | |fig5| | |fig6| |
+    +--------+--------+
+
+
+
+
+**Plant shoot is static** to HydroShoot. That is the model does not simulate plant growth nor its development.
+Its usage would therefore be only sound only if shoot's structure can be assumed constant across a given span of time
+(let's say a week or so for grapevine).
+
+
+Why would you be interested in it?
+==================================
+HydroShoot may be useful for example if you would like to explore:
+
+- how leaf net carbon assimilation rate (:math:`A_n`), transpiration rate (:math:`E`), temperature (:math:`T`) and
+  bulk water potential (:math:`\Psi_{leaf}`) interact across the canopy
+- how soil water status impacts :math:`A_n`, :math:`E`, :math:`T`, and :math:`\Psi_{leaf}`
+- how the structure of the shoot impacts :math:`A_n`, :math:`E`, :math:`T`, and :math:`\Psi_{leaf}`
+- how soil water potential (:math:`\Psi_{soil}`) propagates across plant's shoot
+