HOPP

HOPP: гибридная платформа оптимизации и производительности

В рамках исследования гибридных энергетических систем NREL это программное обеспечение оценивает оптимальные проекты для развертывания гибридных энергетических установок коммунального масштаба, особенно с учетом ветра, солнца и хранения энергии.

Требования к программному обеспечению

• Только Python версии 3.10 и 3.11 (PySAM 4.2 несовместим с версией 3.12)

Установка из репозиториев пакетов

1. HOPP доступен в виде пакета PyPi:

   pip install HOPP

Установка из исходного кода

1. Используя Git, перейдите в локальный целевой каталог и клонируйте репозиторий:

   git clone https://github.com/NREL/HOPP.git

2. Перейдите в HOPP

    cd HOPP

3. Создайте новую виртуальную среду и перейдите в нее. Используя Conda и назвав его «hopp»:

   conda create --name hopp python=3.11 -y
   conda activate hopp

4. Установите HOPP и его зависимости:

   conda install -y -c conda-forge coin-or-cbc=2.10.8 glpk

   Обратите внимание, что если вы используете Windows, вам придется вручную установить Cbc: https://github.com/coin-or/Cbc.

   • Если вы хотите просто использовать HOPP:

     pip install .  

   • Если вы хотите поработать с примерами:

     pip install " .[examples] "

   • Если вам также нужны зависимости разработки для запуска тестов и создания документации:

     pip install -e " .[develop] "

5. Для функций, загружающих данные ресурсов, требуется ключ API NREL. Получите ключ от:

   https://developer.nrel.gov/signup/

6. Чтобы настроить NREL_API_KEY и NREL_API_EMAIL необходимые для загрузки ресурсов, вы можете создать переменные среды с именами NREL_API_KEY и NREL_API_EMAIL . В противном случае вы можете сохранить ключ в новом файле с именем «.env» в корневом каталоге этого проекта.

   Создайте файл «.env», содержащий одну строку:

   NREL_API_KEY=key
   [email protected]

7. Проверьте настройку, выполнив тесты:

   pytest tests/hopp

8. Чтобы настроить NREL_API_KEY для загрузки ресурсов, сначала обратитесь к разделам 6 и 7 выше. Но для метода файла .env файл должен находиться в рабочем каталоге вашего проекта Python, например, в каталоге, из которого вы запускаете python .

Начиная

В примерах содержатся блокноты Jupyter и примеры файлов YAML для распространенных сценариев использования в HOPP. Они активно поддерживаются и обновляются, чтобы продемонстрировать возможности HOPP. Полную информацию о параметрах моделирования и других функциях см. в документации.

Содействие

Заинтересованы в улучшении HOPP? Пожалуйста, смотрите раздел «Вклад» для получения дополнительной информации.