LandBOSSE

The Land-based Balance-of-System Systems Engineering model is a systems engineering tool that estimates the balance-of-system costs associated with installing utility scale wind plants (10, 1.5 MW turbines or larger).
https://github.com/nlrwindsystems/landbosse

Category: Renewable Energy
Sub Category: Wind Energy

Keywords from Contributors

wind openmdao systems-engineering wisdem wind-energy wind-turbine

Last synced: about 8 hours ago
JSON representation

Repository metadata

New LandBOSSE Model (Developed in 2018-2019)

README.md

LandBOSSE

PyPI version
Apache 2.0
image
Jupyter Book

Welcome to LandBOSSE!

The Land-based Balance-of-System Systems Engineering (LandBOSSE) model is a systems engineering tool that estimates the balance-of-system (BOS) costs associated with installing utility scale wind plants (10, 1.5 MW turbines or larger). It can execute on macOS and Windows. At this time, for both platforms, it is a command line tool that needs to be accessed from the command line.

The methods used to develop this model (specifically, LandBOSSE Version 2.1.0) are described in greater detail the following report:

Eberle, Annika, Owen Roberts, Alicia Key, Parangat Bhaskar, and Katherine Dykes.
2019. NREL’s Balance-of-System Cost Model for Land-Based Wind. Golden, CO:
National Renewable Energy Laboratory. NREL/TP-6A20-72201.
https://www.nrel.gov/docs/fy19osti/72201.pdf.

Installation

For any installation, users should use a virtual environment. We recommend Miniconda or Anaconda,
but any supporting PyPI or source installations are possible. Here, we'll work with conda for
compatibility with other NREL tools.

In the below, you can replace the name "landbosse" with any name you choose, and the Python version
can be any that you prefer as long as it's supported by LandBOSSE.

conda create -n landbosse python=3.13 -y

PyPI

pip install NREL-landbosse

Source

  1. Navigate to your preferred installation location

  2. Clone the repo (or fork and clone your fork, if preferred).

    git clone https://github.com/NLRWindSystems/LandBOSSE.git
    
  3. Enter the directory and install the local version

    cd LandBOSSE
    pip install .
    

    Optional: pip install -e . for editable installations if you plan to modify the code itself.

User Guides

First time running teh model

At its most basic, the following setup is required, though the provided input data in project_inpute_template
can be used to test out the model and view results before diving into configuring custom scenarios.

  1. Create an "input" and "output" folder for LandBOSSE to access. If you are using a source
    installation, then ensure the folders are not located inside the local copy of the repository.
  2. Create a project_list.xlsx like LandBOSSE/project_list.xlsx and a subfolder called
    project_data inside of inputs.
  3. Each project in project_list.xlsx should have a corresponding Excel file in project_data
    similar to the examples in LandBOSSE/project_input_template/project_data.

Running the model

Once the initial steps (above) are followed, we can run the model:

  1. Activate your virtual environment: `conda activate landbosse
  2. Navigate to the top-level LandBOSSE folder
  3. Run the model: python main.py -i input-folder-path -o output-folder-path (be sure to replace
    "input-folder-path" and "output-folder-path" with your respective input and output folders).

All together

conda activate landbosse
cd /path/to/LandBOSSE
python main.py -i /path/to/inputs -o /path/to/outputs
conda deactivate
  1. View your results in the output folder.

Integrating LandBOSSE into your code

While LandBOSSE was originally designed as a CLI tool powered by Excel workbooks, an API also exists
to run the model within another application.

Further documentation coming soon


Owner metadata


GitHub Events

Total
Last Year

Committers metadata

Last synced: 3 days ago

Total Commits: 532
Total Committers: 10
Avg Commits per committer: 53.2
Development Distribution Score (DDS): 0.451

Commits in past year: 7
Committers in past year: 1
Avg Commits per committer in past year: 7.0
Development Distribution Score (DDS) in past year: 0.0

Name Email Commits
Alicia Key a****y@n****v 292
Annika Eberle a****e@n****v 104
parangat94 p****4@g****m 53
Garrett Barter g****r@n****v 37
Paul Crook p****k@n****v 26
Rob Hammond 1****2 7
Aaron Barker b****9@g****m 7
Katherine Dykes k****s@n****v 4
ptrbortolotti p****i@g****m 1
WIN\jumu j****u@d****k 1

Committer domains:


Issue and Pull Request metadata

Last synced: 6 days ago

Total issues: 0
Total pull requests: 3
Average time to close issues: N/A
Average time to close pull requests: 23 minutes
Total issue authors: 0
Total pull request authors: 1
Average comments per issue: 0
Average comments per pull request: 0.0
Merged pull request: 3
Bot issues: 0
Bot pull requests: 0

Past year issues: 0
Past year pull requests: 3
Past year average time to close issues: N/A
Past year average time to close pull requests: 23 minutes
Past year issue authors: 0
Past year pull request authors: 1
Past year average comments per issue: 0
Past year average comments per pull request: 0.0
Past year merged pull request: 3
Past year bot issues: 0
Past year bot pull requests: 0

More stats: https://issues.ecosyste.ms/repositories/lookup?url=https://github.com/nlrwindsystems/landbosse

Top Issue Authors

Top Pull Request Authors

  • RHammond2 (3)

Top Issue Labels

Top Pull Request Labels

  • enhancement (2)
  • bug (1)

Package metadata

pypi.org: nrel-landbosse

Wind-Plant Integrated System Design & Engineering Model

  • Homepage: https://github.com/NLRWIndSystems/LandBOSSE
  • Documentation: https://nlrwindsystems.readthedocs.io
  • Licenses: Apache-2.0
  • Latest release: 2.6.3 (published 6 days ago)
  • Last Synced: 2026-05-10T21:04:21.387Z (3 days ago)
  • Versions: 3
  • Dependent Packages: 0
  • Dependent Repositories: 0
  • Downloads: 148 Last month
  • Rankings:
    • Dependent packages count: 8.506%
    • Average: 28.292%
    • Dependent repos count: 48.078%
  • Maintainers (1)

Dependencies

.github/workflows/python-publish-test.yml actions
  • actions/checkout v4 composite
  • actions/setup-python v5 composite
  • pypa/gh-action-pypi-publish release/v1 composite
.github/workflows/gh_pages.yml actions
  • actions/checkout v6 composite
  • actions/deploy-pages v4 composite
  • actions/setup-python v6 composite
  • actions/upload-pages-artifact v4 composite
.github/workflows/python-publish.yml actions
  • actions/checkout v4 composite
  • actions/setup-python v5 composite
  • pypa/gh-action-pypi-publish release/v1 composite
.github/workflows/ci.yml actions
  • actions/checkout v4 composite
  • conda-incubator/setup-miniconda v3 composite
pyproject.toml pypi
  • numpy *
  • openpyxl *
  • pandas *
  • scipy *
  • xlsxwriter *
setup.py pypi
environment.yml conda
  • et-xmlfile
  • numpy
  • openmdao
  • openpyxl
  • pandas
  • pip
  • pytest
  • python
  • scipy
  • setuptools
  • xlsxwriter

Score: 10.995410853053441