reVX.setbacks.regulations.WindSetbackRegulations

class WindSetbackRegulations(hub_height, rotor_diameter, regulations_fpath=None, multiplier=None)[source]

Bases: SetbackRegulations

Wind setback regulation setback values.

Parameters:
  • hub_height (float | int) – Turbine hub height (m), used along with rotor diameter to compute blade tip height which is used to determine setback distance.

  • rotor_diameter (float | int) – Turbine rotor diameter (m), used along with hub height to compute blade tip height which is used to determine setback distance.

  • regulations_fpath (str | None, optional) – Path to regulations .csv or .gpkg file. At a minimum, this file must contain the following columns: Feature Type, which contains labels for the type of setback that each row represents, Feature Subtype, which contains labels for feature subtypes, Value Type, which specifies wether the value is a multiplier or static height, Value, which specifies the numeric value of the setback or multiplier, and FIPS, which specifies a unique 5-digit code for each county (this can be an integer - no leading zeros required). Valid options for the Value Type are (case-insensitive; dashes, underscores, and spaces are interchangeable):

    • “Max-tip Height Multiplier”

    • “Rotor-Diameter Multiplier”

    • “Hub-height Multiplier”

    • “Meters”

    If this input is None, a generic setback of max_tip_height * multiplier is used. By default None.

  • multiplier (int | float | str | None, optional) – A setback multiplier to use if regulations are not supplied. This multiplier will be applied to the base_setback_dist to calculate the setback. If supplied along with regulations_fpath, this input will be used to apply a setback to all counties not listed in the regulations file. If this input is a string, it must be a key in MULTIPLIERS. By default None.

Methods

Attributes

MULTIPLIERS

Named generic multipliers.

REQUIRED_COLUMNS

base_setback_dist

The base setback distance, in meters.

df

Regulations table.

generic

Regulation value used for global regulations.

generic_exists

Flag indicating wether generic regulations exist.

hub_height

Turbine hub height in meters

locals_exist

Flag indicating wether local regulations exist.

multiplier

Generic setback multiplier.

rotor_diameter

Turbine rotor diameter in meters

MULTIPLIERS = {'high': 3, 'moderate': 1.1}

Named generic multipliers.

property hub_height

Turbine hub height in meters

Returns:

float

property rotor_diameter

Turbine rotor diameter in meters

Returns:

float

property base_setback_dist

The base setback distance, in meters.

Type:

float

property df

Regulations table.

Type:

geopandas.GeoDataFrame | None

property generic

Regulation value used for global regulations.

Type:

float | None

property generic_exists

Flag indicating wether generic regulations exist.

Type:

bool

property locals_exist

Flag indicating wether local regulations exist.

Type:

bool

property multiplier

Generic setback multiplier.

Type:

int | float