Expanded capabilities for heterogeneity

[paulf81]

Expanded capabilities for heterogeneity

The over-arching goals of this pull request are to expand heterogeneity's capabilities in FLORIS while maintaining backward compatibility with 4.0, and to do so in a non-messy way. Main features to be added:

• Heterogeneity scheduled against wind speed in addition to wind direction
• Further built-in checking of the heterogeneous_inflow_config_by_wd dict as it gets more complicated, with clear errors\
• Built in plotting of speedup maps (this is in addition to plotting cross-planes with wakes), this will follow the pattern of FLORISv4 / FLASCv2 that pure FLORIS operations belong in FLORIS and so certain plotting capabilities will move back from FLASC
• General consolidation of heterogeneity functions into one place
• Adds to heterogeneity examples
• Add heterogeneity documentation

To do add the new features, we include a new class HeterogeneousMap, which is declared using parameters matched to the keywords heterogeneous_inflow_config_by_wd (plus wind_speeds) and does all the relevant checking so this doesn't need to be done by WindData objects. It also provides member functions for getting a findex-based heterogeneous_inflow_config which can be passed to FlorisModel.set() and will include plotting functions.

To avoid changing the API, the HeterogenousMap class is used within wind_data.py in such a way that either the former heterogeneous_inflow_config_by_wd parameter can be passed in, or a similar dictionary can be unpacked into a heterogenous_map parameter, or HeterogenousMap object can be passed in directly.
We may over time favor moving toward heterogenous_map only, however this is not urgent.

The plan of this pull request however is to update the examples (and documentation) to make direct use HeterogeneousMap as this is the clearer and more general syntax.

Additionally in this pull request:

• A fix for a bug previously missed when an int was passed in place of a float to TimeSeries wind_directions, wind_speeds or turbulence_intensities
• Tests for the new HeterogeneousMap class
• Additional tests for WindData classes
• Simplifies the function to plot a heterogenous cutplane by having it call existing functions
• Sets the interpolant function used within flow_field to be a seperate static function so that the HetergenousMap can use exactly the same interpolation method when visualizing the flow field.
• Fixed an issue that if called to visualize a FlorisModel with a het_map attached with multiple findices, the set_for_viz did not limit the speedup map to 1 findex

Finally, one test of WindData was removed since it was calling a lower-level function which is now handled in HeterogenousMap, this should not impact examples or practical useage.

Impacted areas of the software

wind_data.py

[paulf81]

@misi9170 , this is ready for your review!

[misi9170]

Overall, this looks good. The main comment I have is about whether the wind_speeds and wind_directions arguments should be the same length (so, meshgridded and flattened?)