pywasp.wasp.predict_bwc(bwc, topo_map, output_locs, conf=None, nsecs=None, interp_method='given', input_mesoclimate=None, output_mesoclimate=None, mesoclimate_interp_method='nearest', return_site_factors=False, add_met=True, cfd_volume=None, bin_width=1.0, ngbins=500)[source]

Predict a binned wind climate from a binned wind climate using a topography map for given output locations


This function is experimental and its signature may change.

  • bwc (xarray.Dataset) – PyWAsP xr.Dataset containing wind climate to be generalized

  • topo_map (TopographyMap) – TopographyMap of the region to model

  • output_locs (xarray.Dataset) – Output locations in one of the windkit spatial structures (point, stacked_point, cuboid)

  • conf (Config, optional) – PyWAsP configuration object

  • nsecs (int, optional) – Number of sector for which the terrain is analyzed. By default, the same number of sectors as the provided bwc

  • generalization_method ({"geostrophic", "idealized"}) – By default “geostrophic”, i.e use a binned geostrophic wind climate as intermediate format, if “idealized” use a generalized wind climate (gwc) as intermediate, i.e. the geostrophic wind climate is transformed using the classic method described in the European wind atlas.

  • interp_method ({"given", "nearest"}) – Interpolation method for site effects, by default ‘given’.

  • input_mesoclimate (xarray.Dataset, optional) – Mesoclimate for the input locations. If None uses pw.wasp.get_climate() to obtain an mesoclimate from reanalysis.

  • output_mesoclimate (xarray.Dataset, optional) – Mesoclimate for the output locations. If None uses pw.wasp.get_climate() to obtain an mesoclimate from reanalysis.

  • mesoclimate_interp_method (str, optional) – Interpolation method for mesoclimate, by default ‘nearest’

  • return_site_factors (bool, optional) – If True, return site factors along with the wind climate data

  • add_met (bool, optional) – If True, add meteorological fields to the wind climate data

  • cfd_volume (xarray.Dataset or list of xarray.Datasets, default None) – WAsP CFD volume xarray dataset that is used for obtaining site effects. By default None, meaning the site effects are calculated using the linear BZ model using get_site_effects.

  • adapt_gwc (bool, True) – Adapt the standard heights and roughnesses in the gwc to match those of the input and output site_effects. Only active when generalization_method is “idealized”.

  • ngbins (int, optional) – Number of bins for the wind speed distribution, by default 500


out_bwc (xarray.Dataset) – PyWAsP binned wind climate for the locations provided in output_site_effects


This function takes binned wind climates and predicts binned wind climates at other locations by first generalizing the input binned wind climate from local site effects (input_site_effects) using the WAsP methodology and then dowscaling at other locations with provided local site effects (output_site_effects).

The resulting wind climate will have the same number of sectors as the input binned wind climate, except when nsecs is specified with a different number of sectors than in the bwc. The number of wind speed bins in the output wind climate is determined automatically and the number is increased automatically if the wind speeds in the histogram exceed that maximum number of bins. The bin width in the output histogram is constant and control by the bin_width argument.