.. _services_engineering_forest:

Engineering Forest Service
==========================

The engineering forest or displacement height model calculates effects from nearby forests.
It can be used in Scalers, Statgen calculations or Park calculations.
Via scripting you have access to engineering forest models and can add models ``EngForestService.AddEngForest(name)``
and modify existing models with the ``GetEngForests`` and ``setEngForest``.
An additional feature not directly available in windPRO is to perform displacement height calculations directly via
``CalculateDisplacementHeights``.
Properties of the object representing this tool can be found here :ref:`TApiEFSetupItems <TApiEFSetupItems>`.

The example below shows how to setup an engineering forest model using an online forest height map.
An example is shown how so get the displacement heights by sector.
Afterwards the engineering forest model used in: the setup of a Scaler (not used afterwards), a statistical wind resource
calculation using WAsP, and a Park calcualtion with four turbines.

.. literalinclude:: ../../python/examples/fromDocs/engineering_forest_service.py