Floris

What's Changed
* Add test for v3_to_v4 input file converters by paulf81 in https://github.com/NREL/floris/pull/880
* Peak shaving turbine operation model by misi9170 in https://github.com/NREL/floris/pull/888
* [BUGFIX] `NoneWakeTurbulence` returns zero (added) turbulence by misi9170 in https://github.com/NREL/floris/pull/894
* [BUGFIX] Include turbulence_intensities in turbine_previewer.py by misi9170 in https://github.com/NREL/floris/pull/900
* Ignore includes in v3->v4 conversions by paulf81 in https://github.com/NREL/floris/pull/904
* Expanded capabilities for heterogeneity by paulf81 in https://github.com/NREL/floris/pull/902
* Randomized layout optimization by paulf81 in https://github.com/NREL/floris/pull/697
* Add z/3d to HeterogeneousMap by paulf81 in https://github.com/NREL/floris/pull/915
* Fix typo in error message by jaredthomas68 in https://github.com/NREL/floris/pull/922
* FLORIS v4.1 by misi9170 in https://github.com/NREL/floris/pull/921

New Contributors
* jaredthomas68 made their first contribution in https://github.com/NREL/floris/pull/922

**Full Changelog**: https://github.com/NREL/floris/compare/v4.0.1...v4.1

Bugfixes since the release of FLORIS [v4.0](https://github.com/NREL/floris/releases/tag/v4.0)

What's Changed
* [BUGFIX] Add enable_active_wake_mixing field to v3 to v4 documentation and conversion by misi9170 in https://github.com/NREL/floris/pull/878
* [BUGFIX] Update CubatureGrid for 4-dimensional data structures by rafmudaf in https://github.com/NREL/floris/pull/881
* [BUGFIX] Incorrect indexing to hub heights in `Farm.coordinates()` by misi9170 in https://github.com/NREL/floris/pull/890
* FLORIS v4.0.1 by misi9170 in https://github.com/NREL/floris/pull/891


**Full Changelog**: https://github.com/NREL/floris/compare/v4.0...v4.0.1

FLORIS v4 brings significant additional flexibility to FLORIS while streamlining the underlying solving code.

For higher-level description of major changes, see 870.

What's Changed
* Convert core data structures and tools to use 4D arrays by rafmudaf in https://github.com/NREL/floris/pull/764
* Replace Cp with power in turbine definition and throughout FLORIS by misi9170 in https://github.com/NREL/floris/pull/765
* Update to more flexible turbine operation model definitions by misi9170 in https://github.com/NREL/floris/pull/770
* Update reference wind turbines in the default turbine library by misi9170 in https://github.com/NREL/floris/pull/771
* Adds classes to structure wind energy data for FLORIS by paulf81 in https://github.com/NREL/floris/pull/775
* Remove small variations in above rated power by paulf81 in https://github.com/NREL/floris/pull/784
* Convert turbulence intensity from single value to n_findex length array by paulf81 in https://github.com/NREL/floris/pull/782
* [BUGFIX] Bad import in convert_turbine_v3_to_v4.py by misi9170 in https://github.com/NREL/floris/pull/795
* Add de-rating op model by paulf81 in https://github.com/NREL/floris/pull/783
* Validate and test wind direction and wind speed by paulf81 in https://github.com/NREL/floris/pull/793
* Add support to shut off turbines by paulf81 in https://github.com/NREL/floris/pull/799
* Update yaw and layout optimization tools for 4D by bayc in https://github.com/NREL/floris/pull/790
* [BUGFIX] Correct condition when yaw_angles passed to TurboPark model by misi9170 in https://github.com/NREL/floris/pull/808
* Change from Apache to BSD 3-clause license by paulf81 in https://github.com/NREL/floris/pull/810
* [BUGFIX] Remove secondary effects from TurboPark model by misi9170 in https://github.com/NREL/floris/pull/813
* Clarify turbine definition terms by misi9170 in https://github.com/NREL/floris/pull/815
* Support multidimensional turbine definitions in all wake models by misi9170 in https://github.com/NREL/floris/pull/812
* Update multidim turbine files to use absolute turbine power by bayc in https://github.com/NREL/floris/pull/818
* Remove unused code from floris.tools and add tool reg tests by bayc in https://github.com/NREL/floris/pull/819
* Move FlorisInterface .reinitialize() / .calculate_wake() to .set() / .run() by rafmudaf in https://github.com/NREL/floris/pull/823
* Raise informative errors if v3 input files passed in by misi9170 in https://github.com/NREL/floris/pull/829
* Collect all layout visualization tools in FLORIS by paulf81 in https://github.com/NREL/floris/pull/805
* [Bugfix] Cast yaw angles to np.ndarray on set by paulf81 in https://github.com/NREL/floris/pull/828
* Update uncertainty interface to 4d, new API by paulf81 in https://github.com/NREL/floris/pull/821
* Drive layout optimizations using WindData objects by paulf81 in https://github.com/NREL/floris/pull/822
* Require TI must be length n_findex in core code by paulf81 in https://github.com/NREL/floris/pull/831
* Add TI as input for calculate plane functions by rafmudaf in https://github.com/NREL/floris/pull/837
* Rename floris.simulation, floris.tools to floris.core, floris by rafmudaf in https://github.com/NREL/floris/pull/830
* Add utilities for floris models by paulf81 in https://github.com/NREL/floris/pull/840
* Allow to fix yaw to nominal wind direction by paulf81 in https://github.com/NREL/floris/pull/850
* Add CSV reader for WindRose by paulf81 in https://github.com/NREL/floris/pull/848
* Save WindData onto FlorisModel and simplify post-`run()` calls by misi9170 in https://github.com/NREL/floris/pull/849
* Change `power_thrust_model` key to `operation_model` at the user level by misi9170 in https://github.com/NREL/floris/pull/859
* [BUGFIX] hardcoded reset to first turbine type in set_operation_model by misi9170 in https://github.com/NREL/floris/pull/856
* Enabling layout optimization for value by ejsimley in https://github.com/NREL/floris/pull/862
* [BUGFIX] set_operation_model ordering with layout by misi9170 in https://github.com/NREL/floris/pull/867
* Refactor examples by paulf81 in https://github.com/NREL/floris/pull/843
* Make set_operation method public by misi9170 in https://github.com/NREL/floris/pull/869
* Fixing datatype of value in WindData objects by ejsimley in https://github.com/NREL/floris/pull/872
* Add try/except to wind rose loader by paulf81 in https://github.com/NREL/floris/pull/874
* Clean up TODOs prior to v4 release by misi9170 in https://github.com/NREL/floris/pull/876
* Build out v4 documentation by misi9170 in https://github.com/NREL/floris/pull/860
* Add merge/reduce FLORIS objects by paulf81 in https://github.com/NREL/floris/pull/866
* Remove setpoints and wind condition specifics from calculate_XX_plane methods by misi9170 in https://github.com/NREL/floris/pull/868
* Update Empirical Gaussian default deflection_rate by misi9170 in https://github.com/NREL/floris/pull/875
* Improvements to WindRose resampling by misi9170 in https://github.com/NREL/floris/pull/857
* Add approximate FLORIS model by paulf81 in https://github.com/NREL/floris/pull/877
* FLORIS v4 by misi9170 in https://github.com/NREL/floris/pull/870


**Full Changelog**: https://github.com/NREL/floris/compare/v3.6...v4.0

Final release of FLORIS v3 before releasing FLORIS v4 to the main branch. From this point onward, FLORIS v3 will be minimally maintained and support will switch to FLORIS v4.

What's Changed
* Add documentation for the release process by rafmudaf in https://github.com/NREL/floris/pull/727
* Catch documentation and examples errors by rafmudaf in https://github.com/NREL/floris/pull/736
* Fix errors in notebooks for online documentation by rctredgold in https://github.com/NREL/floris/pull/721
* Support relative paths in YAML configuration files by RHammond2 in https://github.com/NREL/floris/pull/739
* Use compatible-release specifier for dependency versions by paulf81 in https://github.com/NREL/floris/pull/748
* Fix path dependency in `convert_to_path` test by RHammond2 in https://github.com/NREL/floris/pull/749
* Improve attrs usage in simulation package by rafmudaf in https://github.com/NREL/floris/pull/750
* Bug fix: Enable mulit-dimensional turbines for turbine interactions by RHammond2 in https://github.com/NREL/floris/pull/754
* Fix the turbine.power function unit test by paulf81 in https://github.com/NREL/floris/pull/755
* Grid-class tidying by rafmudaf in https://github.com/NREL/floris/pull/751
* Fix issue with mutable default attributes by paulf81 in https://github.com/NREL/floris/pull/759
* Add utility to build turbine yaml from absolute power, thrust curves by misi9170 in https://github.com/NREL/floris/pull/729
* Clean up and align Turbine and TurbineMultiDim class architectures by rafmudaf in https://github.com/NREL/floris/pull/762
* Add capability to sample and plot velocity profiles by vallbog in https://github.com/NREL/floris/pull/699
* Add support for multiple turbine types in calculate_horizontal_plane_with_turbines() by scottryn in https://github.com/NREL/floris/pull/781
* [BUGFIX] Correct condition when yaw_angles passed to TurboPark model (version 3) by misi9170 in https://github.com/NREL/floris/pull/811
* [BUGFIX] Coordinates getter on Farm class by misi9170 in https://github.com/NREL/floris/pull/846
* Documentation improvements and fixes by rafmudaf in https://github.com/NREL/floris/pull/853
* FLORIS v3.6 by misi9170 in https://github.com/NREL/floris/pull/871

New Contributors
* rctredgold made their first contribution in https://github.com/NREL/floris/pull/721
* vallbog made their first contribution in https://github.com/NREL/floris/pull/699
* scottryn made their first contribution in https://github.com/NREL/floris/pull/781

**Full Changelog**: https://github.com/NREL/floris/compare/v3.5...v3.6

What's Changed
* Bug fix: erroneous rotation in turbine locations in horizontal flowfield plots by Bartdoekemeijer in https://github.com/NREL/floris/pull/663
* Feature: Add concurrent library to ParallelComputingInterface by Bartdoekemeijer in https://github.com/NREL/floris/pull/667
* Bug fix: Finalize Farm attributes by rafmudaf in https://github.com/NREL/floris/pull/665
* Performance Improvements and Code Simplification by RHammond2 in https://github.com/NREL/floris/pull/494
* Infrastructure updates by rafmudaf in https://github.com/NREL/floris/pull/677
* Bug fix: Add variable wind shear to GCH calculations by fg320 in https://github.com/NREL/floris/pull/679
* Enable heterogeneous inflows in yaw optimization routines by misi9170 in https://github.com/NREL/floris/pull/678
* Documentation fixes by rafmudaf in https://github.com/NREL/floris/pull/696
* Add geometric yaw code for rough yaw optimization (in layout optimization) by misi9170 in https://github.com/NREL/floris/pull/681
* Add example of larger floating farm with comparison to fixed-bottom. by misi9170 in https://github.com/NREL/floris/pull/695
* Address pandas 2.1.0 FutureWarning on wind rose plot by pablo-benito in https://github.com/NREL/floris/pull/710
* [Bugfix]: Update geometric yaw optimizer layout when called during layout optimization by misi9170 in https://github.com/NREL/floris/pull/706
* Allow switching on and off contour plot numerical labels at top level by misi9170 in https://github.com/NREL/floris/pull/719
* Feature: Add multidimensional Cp/Ct turbine definition support by bayc in https://github.com/NREL/floris/pull/711
* Update default parameters for the Empirical Gaussian model by misi9170 in https://github.com/NREL/floris/pull/723
* FLORIS v3.5 by rafmudaf in https://github.com/NREL/floris/pull/726

New Contributors
* fg320 made their first contribution in https://github.com/NREL/floris/pull/679

**Full Changelog**: https://github.com/NREL/floris/compare/v3.4.1...v3.5

What's Changed
* Bug fix: Finalize Farm attributes by rafmudaf in https://github.com/NREL/floris/pull/665

This pull request fixes an issue where data was out of sync in `FlorisInterface.get_turbine_ais()`; see 664 and 685.