Skip to main content

parameters

WindType Objects​

class WindType(Enum)

The types of wind to use in calculations

AverageWindSpeed​

Amun will use wind speed reanalysis data in the location and calibrate it so that the long-term average wind speed matched the user's projection.

AuroraWindAtlas​

Aurora's high-resolution wind speed atlas based on Aurora's data from existing wind farms. Check the region details for availability.

CalibratedGeneration​

Hourly simulated production series in the same reference year as Aurora's power market model uploaded by the user. The only adjustment made by Amun to this data will come from price-based economic curtailment.

Era5​

ERA5 reanalysis dataset. Check the region details for availability.

Generation​

At least one year of hourly metered or modelled production uploaded by the user. Amun will use this data create bespoke power curve that captures the relationship between reanalysis wind speed and observed generation.

Merra2​

MERRA-2 reanalysis dataset. Check the region details for availability.

NEWA​

NEWA reanalysis dataset. Check the region details for availability.

P50Scaling​

Represents the site's long-term P50 production potential as a load factor. Amun will calibrate underlying reanalysis wind speeds to match the long-term P50 load factor.

P50YieldScaling​

Represents the site's long-term production P50 potential as generation (GWh/year). Amun will calibrate underlying reanalysis wind speeds to match the long-term P50 production.

PowerDensity​

Power Density is a quantitative measure of wind energy available at a location. Amun will calibrate underlying reanalysis wind speeds to match the average power density.

UploadedWind​

Upload at least one year of hourly modelled or metered wind speed data to calibrate your wind speed profile. Amun will use this data to derive a statistical relationship between uploaded data and the reanalysis wind speed for the same location and time period uploaded.

UploadedGeneration​

At least one year of hourly modelled or measured generation data. This will be used to derive an empirical site-specific power curve which captures the relationship between reanalysis data and observed generation

Weibull​

Weibull parameters represent the long-term wind speed distribution at the site. Amun will calibrate underlying reanalysis wind speeds distribution to match shape.

SpeedAtHeight Objects​

class SpeedAtHeight()

The wind speeds at a given height,

Arguments:

  • height float - The measurement height (m) of the wind speeds.
  • speeds List[float] - A list of wind speeds in m/s.

LoadFactorBaseParameters Objects​

class LoadFactorBaseParameters()

Parameters for all wind types.

Notes:

Not all regions/locations support Multi-Turbine Power Curve Smoothing.

Arguments:

  • turbineModelId (int): The Id of the Turbine to use in the calculation as returned from .AmunSession.get_turbines.
  • latitude (float): The latitude of the point (-90 to 90).
  • longitude (float): The latitude of the point (-180 to 180).
  • startTimeUTC (str): The time in UTC that the calcution should start from. This must be in the form '2016-07-28T00:00:00.000Z' .
  • regionCode (str): The code for the region used to set region specific parameters.
  • hubHeight (float): Given in meters (m).
  • obstacleHeight (float): Given in meters (m).
  • numberOfTurbines (int): The number of turbines in the site.
  • usePowerCurveSmoothing (bool, optional): Should Default Multi-Turbine Power Curve Smoothing be used in the calculation if true then a region specific scale factor is used. If None then no smoothing is applied Defaults to None.
  • smoothingCoefficient (float): The value to use for smoothing. This will override any region specific values. This has no effect unless usePowerCurveSmoothing is true.
  • lossesWake (float, default 0): The percentage to apply for wake loss. (0 <= lossesWake < 1)
  • lossesAvailability (float, default 0): Percentage for external losses. (0 <= lossesAvailability < 1)
  • lossesElectrical (float, default 0): Percentage for external losses. (0 <= lossesElectrical < 1)
  • lossesTurbinePerformance (float, default 0): Percentage for external losses. (0 <= lossesTurbinePerformance < 1)
  • lossesEnvironmental (float, default 0): Percentage for external losses. (0 <= lossesEnvironmental < 1)
  • lossesOtherCurtailment (float, default 0): Percentage for external losses. (0 <= lossesOtherCurtailment < 1)

FlowParameters Objects​

class FlowParameters()

Base class for a flow. Internal Use only.

Arguments:

  • windType WindType - All flows must define a unique windtype as defined by the Amun http API.

AverageWindSpeedParameters Objects​

class AverageWindSpeedParameters(FlowParameters)

The parameters required for a AverageWindSpeed calculation.

Arguments:

  • averageWindSpeed float - The average wind speed of your site to use as calibration (m/s)
  • measurementHeight float - The height at which the measurements were taken (m)

BuiltInWindParameters Objects​

class BuiltInWindParameters(FlowParameters)

The parameters used for built in wind calculations.

Notes:

Not all locations support all wind types and not all locations support Regional Reanalysis Correction.

Arguments:

  • windType WindType - AuroraWindAtlas, Era5, Merra2, or NEWA
  • useReanalysisCorrection bool, optional - Should Regional Reanalysis Correction be enabled. If true then a location specific reanalysisScaleCorrectionDelta is used. Defaults to False.
  • reanalysisScaleCorrectionDelta float, optional - Override the location specific reanalysisScaleCorrectionDelta. This has no effect if reanalysisScaleCorrectionDelta is false. Defaults to None.

P50ScalingParameters Objects​

class P50ScalingParameters(FlowParameters)

The parameters required for a P50Scaling calculation.

Arguments:

  • p50GrossProduction float, 0 < p50GrossProduction < 1 - the P50 load factor which represents the long-term production potential of this site, typically from an energy assessment report, will be used to calibrate the underlying reanalysis wind speed, such that the long-term production potential used in Amun-based valuations are the same.

P50YieldScalingParameters Objects​

class P50YieldScalingParameters(FlowParameters)

The parameters required for a P50YieldScaling calculation.

Arguments:

  • annualProductionInGWHours float, 0 < annualProductionInGWHours < 1000000 - the production expected by the site in a year in Gigawatt Hours.

PowerDensityParameters Objects​

class PowerDensityParameters(FlowParameters)

The parameters required for a PowerDensity calculation.

Arguments:

  • averagePowerDensity float - The average power density of your site to use as calibration (W/m2)
  • measurementHeight float - The height at which the measurements were taken (m)

UploadedWindParameters Objects​

class UploadedWindParameters(FlowParameters)

The parameters required to run a custom (uploaded) load factor calculation. If highHeight is specified it must be the same length as the lowHeight and be measured at a greater height. The speeds upload should be hourly measurements starting at uploadedWindStartTime and span at least 1 year.

Arguments:

  • uploadedWindStartTime str - The time in UTC that the wind speeds upload start from. This must be in the form '2016-07-28T00:00:00.000Z' .
  • lowHeight SpeedAtHeight - The height and speed for the low height wind speed to upload.
  • highHeight SpeedAtHeight, optional - The height and speed for the high height wind speed to upload. Defaults to None.

WeibullParameters Objects​

class WeibullParameters(FlowParameters)

The parameters required for a Weibull calculation.

Arguments:

  • weibullShape float - The long term shape parameter from your wind report
  • weibullScale float - The long term scale parameter from your wind report
  • measurementHeight float - The height at which the measurements were taken (m)

UploadedGenerationParameters Objects​

class UploadedGenerationParameters(FlowParameters)

The Parameters required for UploadedGeneration calculation.

API Version

Arguments:

  • uploadGenerationStartTime str - The time in UTC that the uploaded generation starts from. This must be in the form '2016-07-28T00:00:00.000Z' .
  • uploadedGeneration List[float] - A list of hourly generation values in MW.
  • installedCapacity int - The installed capacity of the site in MW.
  • granularityInMins int, optional - The granularity of the uploaded generation in minutes. Defaults to 60.