Enhance documentation and fix links

Author: SabineHaas

doc/model_description.rst

@@ -2,6 +2,16 @@
 Model description
 ~~~~~~~~~~~~~~~~~~~~~~
 
+Wind power plants
+=================
+
+The windpowerlib provides three classes for modelling wind power as wind turbines (:py:class:`~.wind_turbine.WindTurbine`),
+wind farms (:py:class:`~.wind_farm.WindFarm`) and wind turbine clusters (:py:class:`~.wind_farm.WindFarm`).
+
+Descisptions can also be found in the sections
+:ref:`wind_turbine_label`, :ref:`wind_farm_label` and :ref:`wind_turbine_cluster_label`.
+
+
 Height correction and conversion of weather data
 ================================================
 
@@ -33,28 +43,33 @@ For the first option wind efficiency curves are provided which determine the
 average reduction of wind speeds within a wind farm induced by wake losses depending on the wind speed. These curves
 were taken from the dena-Netzstudie II and the dissertation of Kaspar Knorr
 (for references see :py:func:`~.get_wind_efficiency_curve`).
+The following graph shows all provided wind efficiency curves. The mean wind efficiency curves were calculated in
+the dena-Netzstudie II and by Kaspar Knorr by averaging wind efficiency curves of 12 wind farm distributed over Germany (dena) or
+respectively of over 2000 wind farms in Germany (Knorr). Curves with the appendix 'extreme'
+are wind efficiency curves of single wind farms that are extremely deviating from the respective
+mean wind efficiency curve.
 
 todo: add graph of provided curves
 
 The second option of considering wake losses is applying them to power curves by reducing the power values
 by a constant or a wind speed depending wind farm efficiency (see :py:func:`~.wake_losses_to_power_curve`).
 Applying the wind farm efficiency (curve) to power curves instead of to feed-in time series has the advantage that the
-power curves can further be aggregated to achieve turbine cluster power curves (see WindTurbineCluster in :ref:`classes_label` section).
+power curves can further be aggregated to achieve turbine cluster power curves (see :py:class:`~.wind_turbine_cluster.WindTurbineCluster`).
 
 Smoothing of power curves
 =========================
 
 To account for the spatial distribution of wind speeds within an area the windpowerlib provides a
-function for power curve uses the approach of Nørgaard and Holttinen (for references see :py:func:`~.smooth_power_curve`).
+function for power curve smoothing and uses the approach of Nørgaard and Holttinen (for references see :py:func:`~.smooth_power_curve`).
 
 
 The modelchains
 ===============
 
 The modelchains are implemented to ensure an easy start into the Windpowerlib. They work
-like models that combine all functions provided in the library. The :ref:`modelchain_module_label` is a model
+like models that combine all functions provided in the library. Via parameteres desired functions
+of the windpowerlib can be selected. For parameters not being specified default parameters are used.
+The :ref:`modelchain_module_label` is a model
 to determine the output of a wind turbine while the :ref:`tc_modelchain_module_label` is a model to determine
 the output of a wind farm or wind turbine cluster.
 The usage of both modelchains is shown in the :ref:`example_section_label` section.
-
-

doc/modules.rst

@@ -4,7 +4,6 @@
 API
 #############
 
-.. _classes_label:
 
 Classes
 =========
@@ -56,12 +55,13 @@ Functions for calculating wind speed at hub height.
    wind_speed.logarithmic_profile
    wind_speed.hellman
 
+.. _wind_turbine_label:
 
 Wind turbine data
 ====================
 
 Functions and methods to obtain the nominal power as well as 
-power curve or power coefficient curve needed by the :py:class:`~wind_turbine.WindTurbine` class.
+power curve or power coefficient curve needed by the :py:class:`~.wind_turbine.WindTurbine` class.
 
 
 .. autosummary::
@@ -71,12 +71,13 @@ power curve or power coefficient curve needed by the :py:class:`~wind_turbine.Wi
    wind_turbine.get_turbine_types
    wind_turbine.read_turbine_data
 
+.. _wind_farm_label:
 
 Wind farm calculations
 ======================
 
 Functions and methods to calculate the mean hub height, installed power as well
-as the aggregated power curve of a :py:class:`~wind_farm.WindFarm` object.
+as the aggregated power curve of a :py:class:`~.wind_farm.WindFarm` object.
 
 
 .. autosummary::
@@ -86,14 +87,15 @@ as the aggregated power curve of a :py:class:`~wind_farm.WindFarm` object.
    wind_farm.WindFarm.get_installed_power
    wind_farm.WindFarm.assign_power_curve
 
+.. _wind_turbine_cluster_label:
 
 Wind turbine cluster calculations
 =================================
 
 Functions and methods to calculate the mean hub height, installed power as well
-as the aggregated power curve of a :py:class:`~wind_turbine_cluster.WindTurbineCluster` object.
+as the aggregated power curve of a :py:class:`~.wind_turbine_cluster.WindTurbineCluster` object.
 This is realized in a new module as the functions differ from the functions in
-the :py:class:`~wind_farm.WindFarm` class.
+the :py:class:`~.wind_farm.WindFarm` class.
 
 .. autosummary::
    :toctree: temp/