{"id":13723252,"url":"https://github.com/NREL/HOPP","last_synced_at":"2025-05-07T16:32:33.006Z","repository":{"id":37517178,"uuid":"219555227","full_name":"NREL/HOPP","owner":"NREL","description":null,"archived":false,"fork":false,"pushed_at":"2025-05-01T15:18:02.000Z","size":626757,"stargazers_count":26,"open_issues_count":66,"forks_count":55,"subscribers_count":9,"default_branch":"main","last_synced_at":"2025-05-02T16:55:51.456Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://hopp.readthedocs.io/","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"bsd-3-clause","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/NREL.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"docs/CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2019-11-04T17:13:57.000Z","updated_at":"2025-05-01T15:15:38.000Z","dependencies_parsed_at":"2024-06-12T20:42:05.335Z","dependency_job_id":"820df1ba-785f-408e-b196-1e1b20c7e58b","html_url":"https://github.com/NREL/HOPP","commit_stats":{"total_commits":1458,"total_committers":34,"mean_commits":42.88235294117647,"dds":0.7818930041152263,"last_synced_commit":"099f8a3379b45a1f9e08cfd0da80902a9b91e78f"},"previous_names":[],"tags_count":14,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/NREL%2FHOPP","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/NREL%2FHOPP/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/NREL%2FHOPP/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/NREL%2FHOPP/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/NREL","download_url":"https://codeload.github.com/NREL/HOPP/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":252223485,"owners_count":21714270,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-08-03T01:01:37.813Z","updated_at":"2025-05-07T16:32:27.991Z","avatar_url":"https://github.com/NREL.png","language":"Python","funding_links":[],"categories":["Energy Systems","Energy Models (Frameworks and libraries)"],"sub_categories":["Renewable Energy Integration"],"readme":"# Hybrid Optimization and Performance Platform\n\n![CI Tests](https://github.com/NREL/HOPP/actions/workflows/ci.yml/badge.svg)\n\nAs part of NREL's [Hybrid Energy Systems Research](https://www.nrel.gov/wind/hybrid-energy-systems-research.html), this\nsoftware assesses optimal designs for the deployment of utility-scale hybrid energy plants, particularly considering wind,\nsolar and storage.\n\n## Software requirements\n- Python version 3.8, 3.9, 3.10 64-bit\n- Other versions may still work, but have not been extensively tested at this time\n\n## Installing from Package Repositories\n1. HOPP is available as a PyPi package:\n\n    ```\n    pip install HOPP\n    ```\n\n## Installing from Source\n1. Using Git, navigate to a local target directory and clone repository:\n    ```\n    git clone https://github.com/NREL/HOPP.git\n    ```\n\n2. Navigate to `HOPP`\n    ```\n    cd HOPP\n    ```\n\n3. Create a new virtual environment and change to it. Using Conda and naming it 'hopp':\n    ```\n    conda create --name hopp python=3.8 -y\n    conda activate hopp\n    ```\n\n4. Install dependencies:\n    ```\n    conda install -c conda-forge coin-or-cbc=2.10.8 -y\n    conda install -c conda-forge glpk -y\n    pip install -r requirements.txt\n    ```\n    \n    Note if you are on Windows, you will have to manually install Cbc: https://github.com/coin-or/Cbc\n\n    If you also want development dependencies for running tests and building docs:\n\n    ```\n    pip install -r requirements-dev.txt\n    ```\n\n5. Install HOPP:\n    ```\n    pip install -e .\n    ```\n\n6. The functions which download resource data require an NREL API key. Obtain a key from:\n    \n    [https://developer.nrel.gov/signup/](https://developer.nrel.gov/signup/)\n    \n\n7. To set up the `NREL_API_KEY` and `NREL_API_EMAIL` required for resource downloads, you can create Environment Variables called `NREL_API_KEY` and `NREL_API_EMAIL`. Otherwise, you can keep the key in a new file called \".env\" in the root directory of this project. \n\n    Create a file \".env\" that contains the single line:\n    ```\n    NREL_API_KEY=key\n    NREL_API_EMAIL=your.name@email.com\n    ```\n\n8. Verify setup by running tests:\n    ```\n    pytest tests/hopp\n    ```\n\n\n2. To set up `NREL_API_KEY` for resource downloads, first refer to section 7 and 8 above. But for the `.env` file method,\n   the file should go in the working directory of your Python project, e.g. directory from where you run `python`.\n\n## Getting Started\n\nThe [Examples](./examples/) contain Jupyter notebooks and sample YAML files for common usage scenarios in HOPP. These are actively maintained and updated to demonstrate HOPP's capabilities. For full details on simulation options and other features, see the [documentation](https://hopp.readthedocs.io/en/latest/).\n\n## Contributing\n\nInterested in improving HOPP? Please see the [Contributing](./CONTRIBUTING.md) section for more information.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FNREL%2FHOPP","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FNREL%2FHOPP","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FNREL%2FHOPP/lists"}