Metadata-Version: 2.1
Name: FLORIS
Version: 2.3.0
Summary: A controls-oriented engineering wake model.
Home-page: https://github.com/NREL/FLORIS
Author: NREL National Wind Technology Center
Author-email: rafael.mudafort@nrel.gov
License: Apache-2.0
Description: 
        FLORIS Wake Modeling Utility
        ----------------------------
        
        **Further documentation is available at http://floris.readthedocs.io/.**
        
        For technical questions regarding FLORIS usage please first search for or post
        your questions to
        `stackoverflow <https://stackoverflow.com/questions/tagged/floris>`_ using
        the **floris** tag. Alternatively, email the NREL FLORIS team at
        `NREL.Floris@nrel.gov <mailto:floris@nrel.gov>`.
        
        .. image:: https://github.com/nrel/floris/workflows/Automated%20tests%20%26%20code%20coverage/badge.svg
          :target: https://github.com/nrel/floris/actions
        .. image:: https://codecov.io/gh/nrel/floris/branch/develop/graph/badge.svg
          :target: https://codecov.io/gh/nrel/floris
        .. image:: https://img.shields.io/badge/code%20style-black-000000.svg
            :target: https://github.com/psf/black
        
        Background and Objectives
        =========================
        This FLORIS framework is designed to provide a computationally efficient,
        controls-oriented modeling tool of the steady-state wake characteristics in
        a wind farm. The wake models implemented in this version of FLORIS are:
        
        - Jensen model for velocity deficit
        - Jimenez model for wake deflection
        - Gauss model for wake deflection and velocity deficit
        - Multi zone model for wake deflection and velocity deficit
        - Curl  model for wake deflection and velocity deficit
        - TurbOPark model for wake velocity deficit
        
        More information on all of these models can be found in the
        `theory <https://floris.readthedocs.io/en/develop/source/theory.html>`_
        section of the online documentation.
        
        A couple of publications with practical information on using floris as a
        modeling and simulation tool for controls research are
        
        1. Annoni, J., Fleming, P., Scholbrock, A., Roadman, J., Dana, S., Adcock, C.,
           Porté-Agel, F, Raach, S., Haizmann, F., and Schlipf, D.: `Analysis of
           control-oriented wake modeling tools using lidar field results <https://www.wind-energ-sci.net/3/819/2018/>`__,
           in: Wind Energy Science, vol. 3, pp. 819-831, Copernicus Publications,
           2018.
        
        Citation
        ========
        
        .. image:: https://zenodo.org/badge/178914781.svg
          :target: https://zenodo.org/badge/latestdoi/178914781
        
        If FLORIS played a role in your research, please cite it. This software can be
        cited as:
        
           FLORIS. Version 2.3.0 (2021). Available at https://github.com/NREL/floris.
        
        For LaTeX users:
        
        .. code-block:: latex
        
            @misc{FLORIS_2021,
            author = {NREL},
            title = {{FLORIS. Version 2.3.0},
            year = {2021},
            publisher = {GitHub},
            journal = {GitHub repository},
            url = {https://github.com/NREL/floris}
            }
        
        .. _installation:
        
        Installation
        ============
        For full installation instructions, see
        https://floris.readthedocs.io/en/latest/source/installation.html.
        
        Users who want to run FLORIS without downloading the full source code
        can install with `pip` or `conda`, as shown below.
        
        .. code-block:: bash
        
            # Using pip...
            pip install floris         # Latest version
            pip install floris==1.1.0  # Specified version number
        
            # Using conda...
            conda install floris        # Latest version
            conda install floris=1.1.0  # Specified version number
        
        
        To download the source code and use the local code, download the project
        and add it to your Python path:
        
        .. code-block:: bash
        
            # Download the source code.
            git clone https://github.com/NREL/floris.git
        
            # Install into your Python environment
            pip install -e floris
        
        
        Finally, users who will be contributing code to the project should align
        their environment with the linting and formatting tools used by the
        FLORIS development team. This is enabled in the `setup.py` script and
        can be activated with these commands:
        
        .. code-block:: bash
        
            git clone https://github.com/NREL/floris.git -b develop
            cd floris
            pip install -e '.[develop]'
            pre-commit install
        
        
        After any form of installation, the environment should be tested.
        Within a Python shell or a Python script, this code should
        display information:
        
        .. code-block:: python
        
            import floris
            print( help( floris ) )
            print( dir( floris ) )
            print( help( floris.simulation ) )
        
        License
        =======
        
        Copyright 2021 NREL
        
        Licensed under the Apache License, Version 2.0 (the "License");
        you may not use this file except in compliance with the License.
        You may obtain a copy of the License at
        
           http://www.apache.org/licenses/LICENSE-2.0
        
        Unless required by applicable law or agreed to in writing, software
        distributed under the License is distributed on an "AS IS" BASIS,
        WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
        See the License for the specific language governing permissions and
        limitations under the License.
        
Platform: UNKNOWN
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: Implementation :: CPython
Classifier: Programming Language :: Python :: Implementation :: PyPy
Requires-Python: >=3.6.0
Description-Content-Type: text/markdown
Provides-Extra: wind_tool_kit
Provides-Extra: docs
Provides-Extra: develop
