reVX.setbacks.regulations.WindSetbackRegulations

class WindSetbackRegulations(hub_height, rotor_diameter, regulations_fpath=None, multiplier=None)

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: Contains labels for the type of setback that each row represents. This should be a “feature_type” label that can be found in the SETBACK_SPECS dictionary (e.g. "structures", "roads", "water", etc.), unless you have created your own setback calculator using setbacks_calculator(), in which case this label can match the feature_type input you used for that function call.

  • Feature Subtype: Contains labels for feature subtypes. The feature subtypes are only used for down-selecting the local regulations that should be applied for a particular feature, so often you can leave this blank or set it to None. If you do specify this value, it should be a “feature_subtypes_to_exclude” label that can be found in the SETBACK_SPECS dictionary, unless you have created your own setback calculator using setbacks_calculator(), in which case this label can match the feature_subtypes_to_exclude input you used for that function call.

  • Value Type: Specifies wether the value is a multiplier or static height. See below for more info.

  • Value: Numeric value of the setback or multiplier.

  • FIPS: Specifies a unique 5-digit code for each county (this can be an integer - no leading zeros required). This is used to match the county regulations to the county’s spatial extent.

  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