.. _calculations_park:

Park Calculation Service
========================

CalcParkService gives access to the PARK module.
This service is more complex than the other calcualtion services.

It contains the two function, ``CalcParkService.GetParkCalc`` for getting a park objects and
``CalcParkService.SetParkCalc`` for passing it back to windPRO.

``CalcParkService.GetTApiWtgId()`` gets objects that are needed to connects wind turbine generator objects with the
PARK calculation (similar to ``factory.TApiWtgId()``). The connection is done by adding the Handle of the WTG objects.
A list of these TApiWtgId objects needs to be combined into ``factory.TApiObjectHandles()`` and added to
``CalcParkService.NewWtgs`` or ``CalcParkService.ExistWtgs``.

There are multiple different PARK calculation types.
You can change them with the property ``ParkCalcType``.
A PARK calulation in Scripting always has all properties for all calculations.
For finding out what properties are needed to be changed you can setup your calculation in the GUI as it is intended and then see what properties have changed.

There is access to the time varying calculation where TI is used to dynamically set the wake decay constants.
``CalcParkService.GetWdcTiSetup`` and ``CalcParkService.SetWdcTiSetup`` for getting and setting those properties
respectively.

Properties of the calculation object can be found here :ref:`TApiCalcPark <TApiCalcPark>`.

Find below an example how to use PARK calculations:

.. literalinclude:: ../../../python/examples/fromDocs/calculations/park_calculation.py

A second example is provided using scripting to repeat PARK calculations to find the marginal AEP for each turbine.
This is done by repeating the PARK calculation removing one turbine at a time.

.. literalinclude:: ../../../python/examples/fromDocs/calculations/park_calculation_marginal_AEP.py

Find below an example of a PARK calculation using precalculated resource files.

.. literalinclude:: ../../../python/examples/fromDocs/calculations/park_calculation_resource.py