atlite

Light-weight version of Aarhus RE Atlas for converting weather data to power systems data.
https://github.com/pypsa/atlite

Category: Energy Systems
Sub Category: Renewable Energy Integration

Keywords

csp dynamic-line-rating energy energy-system energy-systems era5 gis heat-pump potentials pv python reanalysis renewable-energy renewable-timeseries solar wind

Keywords from Contributors

energy-system-model power-systems pypsa energy-model optimisation pyomo linopy energy-transition renewables powerflow

Last synced: about 13 hours ago
JSON representation

Repository metadata

atlite: A Lightweight Python Package for Calculating Renewable Power Potentials and Time Series

• Host: GitHub
• URL: https://github.com/pypsa/atlite
• Owner: PyPSA
• License: mit
• Created: 2016-11-03T23:59:25.000Z (over 8 years ago)
• Default Branch: master
• Last Pushed: 2025-04-17T07:54:15.000Z (10 days ago)
• Last Synced: 2025-04-22T07:19:31.573Z (5 days ago)
• Topics: csp, dynamic-line-rating, energy, energy-system, energy-systems, era5, gis, heat-pump, potentials, pv, python, reanalysis, renewable-energy, renewable-timeseries, solar, wind
• Language: Python
• Homepage: https://atlite.readthedocs.io
• Size: 16.8 MB
• Stars: 308
• Watchers: 13
• Forks: 104
• Open Issues: 45
• Releases: 15
• Metadata Files:
  • Readme: README.rst
  • Contributing: CONTRIBUTING.md
  • License: LICENSE
  • Citation: CITATION.cff
  • Authors: AUTHORS.rst

README.rst

            .. SPDX-FileCopyrightText: Contributors to atlite 

  .. SPDX-License-Identifier: CC-BY-4.0

======
atlite
======

|PyPI version| |Conda version| |Documentation Status| |ci| |codecov| |standard-readme compliant| |MIT-image| |reuse| |black| |pre-commit.ci| |joss| |discord| |stackoverflow|

atlite is a `free software`_, `xarray`_-based Python library for
converting weather data (like wind speeds, solar influx) into energy systems data.
It is designed to be lightweight, keeping computing resource requirements (CPU, RAM) usage low.
It is therefore well suited to be used with big weather datasets.

.. atlite is designed to be modular, so that it can work with any weather
.. datasets. It currently has modules for the following datasets:

.. * `NCEP Climate Forecast System `_ hourly
..   historical reanalysis weather data available on a 0.2 x 0.2 degree global grid
.. * `ECMWF ERA5
..   `_ hourly
..   historical reanalysis weather data on an approximately 0.25 x 0.25 deg global
..   grid
.. * `EURO-CORDEX Climate Change Projection `_
..   three-hourly up until 2100, available on a 0.11 x 0.11 degree grid for Europe
.. * `CMSAF SARAH-2
..   `_
..   half-hourly historical surface radiation on a 0.05 x 0.05 deg grid available
..   for Europe and Africa (automatically interpolated to a 0.2 deg grid and
..   combined with ERA5 temperature).


atlite can process the following weather data fields and can convert them into following power-system relevant time series for any subsets of a full weather database.

.. image:: doc/workflow_chart.png

.. * Temperature
.. * Downward short-wave radiation
.. * Upward short-wave radiation
.. * Wind
.. * Runoff
.. * Surface roughness
.. * Height maps
.. * Soil temperature
.. * Dewpoint temperature


.. * Wind power generation for a given turbine type
.. * Solar PV power generation for a given panel type
.. * Solar thermal collector heat output
.. * Hydroelectric inflow (simplified)
.. * Heating demand (based on the degree-day approximation)


atlite was initially developed by the `Renewable Energy Group
`_
at `FIAS `_ to carry out simulations
for the `CoNDyNet project `_, financed by the
`German Federal Ministry for Education and Research (BMBF)
`_ as part of the `Stromnetze
Research Initiative
`_.


Installation
============

To install you need a working installation running Python 3.6 or above
and we strongly recommend using either miniconda or anaconda for package
management.

To install the current stable version:

with ``conda`` from `conda-forge`_

.. code:: shell

       conda install -c conda-forge atlite

with ``pip`` from `pypi`_

.. code:: shell

       pip install atlite

to install the most recent upstream version from GitHub

.. code:: shell

       pip install git+https://github.com/pypsa/atlite.git


Documentation
===============
.. * Install atlite from conda-forge or pypi.
.. * Download one of the weather datasets listed above (ERA5 is downloaded
..   automatically on-demand after the ECMWF
..   `cdsapi` client is
..   properly installed)
.. * Create a cutout, i.e. a geographical rectangle and a selection of
..   times, e.g. all hours in 2011 and 2012, to narrow down the scope -
..   see `examples/create_cutout.py `_
.. * Select a sparse matrix of the geographical points inside the cutout
..   you want to aggregate for your time series, and pass it to the
..   appropriate converter function - see `examples/ `_


Please check the `documentation `_.


Support & Contributing
======================
* In case of code-related **questions**, please post on `stack overflow `_.
* For non-programming related and more general questions please refer to the `pypsa mailing list `_.
* To **discuss** with other PyPSA and atlite users, organise projects, share news, and get in touch with the community you can use the `discord server `_.
* For **bugs and feature requests**, please use the `issue tracker `_.
* We strongly welcome anyone interested in providing **contributions** to this project. If you have any ideas, suggestions or encounter problems, feel invited to file issues or make pull requests on the `Github repository `_.

Authors and Copyright
---------------------

Copyright (C) Contributors to atlite 

See the `AUTHORS`_ for details.

Licence
=======

|MIT-image|

This work is licensed under multiple licences:

-  All original source code is licensed under `MIT`_
-  Auxiliary code from SPHINX is licensed under `BSD-2-Clause`_.
-  The documentation is licensed under `CC-BY-4.0`_.
-  Configuration and data files are mostly licensed under `CC0-1.0`_.

See the individual files for license details.

.. _free software: http://www.gnu.org/philosophy/free-sw.en.html
.. _xarray: http://xarray.pydata.org/en/stable/

.. _conda-forge: https://anaconda.org/conda-forge/atlite
.. _pypi: https://pypi.org/project/atlite/%3E
.. _GitHub: https://github.com/pypsa/atlite

.. _documentation on getting started: https://atlite.readthedocs.io/en/latest/getting-started.html

.. _AUTHORS: AUTHORS.rst

.. _MIT: LICENSES/MIT.txt
.. _BSD-2-Clause: LICENSES/BSD-2-Clause.txt
.. _CC-BY-4.0: LICENSES/CC-BY-4.0.txt
.. _CC0-1.0: LICENSES/CC0-1.0.txt

.. |PyPI version| image:: https://img.shields.io/pypi/v/atlite.svg
   :target: https://pypi.python.org/pypi/atlite
.. |Conda version| image:: https://img.shields.io/conda/vn/conda-forge/atlite.svg
   :target: https://anaconda.org/conda-forge/atlite
.. |Documentation Status| image:: https://readthedocs.org/projects/atlite/badge/?version=master
   :target: https://atlite.readthedocs.io/en/master/?badge=master
.. |standard-readme compliant| image:: https://img.shields.io/badge/readme%20style-standard-brightgreen.svg?style=flat
   :target: https://github.com/RichardLitt/standard-readme
.. |MIT-image| image:: https://img.shields.io/pypi/l/atlite.svg
   :target: LICENSES/MIT.txt
.. |codecov| image:: https://codecov.io/gh/PyPSA/atlite/branch/master/graph/badge.svg?token=TEJ16CMIHJ
   :target: https://codecov.io/gh/PyPSA/atlite
.. |ci| image:: https://github.com/PyPSA/atlite/actions/workflows/test.yaml/badge.svg
   :target: https://github.com/PyPSA/atlite/actions/workflows/test.yaml
.. |reuse| image:: https://api.reuse.software/badge/github.com/pypsa/atlite
   :target: https://api.reuse.software/info/github.com/pypsa/atlite
.. |black| image:: https://img.shields.io/badge/code%20style-black-000000.svg
   :target: https://github.com/psf/black
   :alt: Code style: black
.. |pre-commit.ci| image:: https://results.pre-commit.ci/badge/github/PyPSA/atlite/master.svg
   :target: https://results.pre-commit.ci/latest/github/PyPSA/atlite/master
   :alt: pre-commit.ci status
.. |joss| image:: https://joss.theoj.org/papers/10.21105/joss.03294/status.svg
   :target: https://doi.org/10.21105/joss.03294
.. |discord| image:: https://img.shields.io/discord/911692131440148490?logo=discord
   :target: https://discord.gg/AnuJBk23FU
.. |stackoverflow| image:: https://img.shields.io/stackexchange/stackoverflow/t/pypsa
   :target: https://stackoverflow.com/questions/tagged/pypsa
   :alt: Stackoverflow

        

Citation (CITATION.cff)

# SPDX-FileCopyrightText: Contributors to atlite <https://github.com/pypsa/atlite>
#
# SPDX-License-Identifier: CC0-1.0

cff-version: 1.2.0
message: "If you use this package, please cite our corresponding paper in JOSS (The Journal of Open Source Software)."
title: "atlite: A Lightweight Python Package for Calculating Renewable Power Potentials and Time Series"
journal: The Journal of Open Source Software
doi: "10.21105/joss.03294"
repository: "https://github.com/PyPSA/atlite"
version: "0.2.5"
date-released: "2021-06-24"
license: "MIT"
authors:
  - family-names: "Hofmann"
    given-names: "Fabian"
    orcid: "https://orcid.org/0000-0002-6604-5450"
  - family-names: "Hampp"
    given-names: "Johannes"
    orcid: "https://orcid.org/0000-0002-1776-116X"
  - family-names: "Neumann"
    given-names: "Fabian"
    orcid: "https://orcid.org/0000-0001-8551-1480"
  - family-names: "Brown"
    given-names: "Tom"
    orcid: "https://orcid.org/0000-0001-5898-1911"
  - family-names: "Hörsch"
    given-names: "Jonas"
    orcid: "https://orcid.org/0000-0001-9438-767X"

---

Owner metadata

• Name: PyPSA
• Login: PyPSA
• Email:
• Kind: organization
• Description: Python for Power System Analysis
• Website: www.pypsa.org
• Location:
• Twitter:
• Company:
• Icon url: https://avatars.githubusercontent.com/u/32890768?v=4
• Repositories: 29
• Last ynced at: 2024-03-26T13:25:46.062Z
• Profile URL: https://github.com/PyPSA

---

GitHub Events

Total

• Create event: 17
• Release event: 1
• Issues event: 15
• Watch event: 34
• Delete event: 14
• Issue comment event: 61
• Push event: 49
• Pull request review comment event: 47
• Pull request review event: 57
• Pull request event: 68
• Fork event: 15

Last Year

• Create event: 17
• Release event: 1
• Issues event: 15
• Watch event: 34
• Delete event: 14
• Issue comment event: 61
• Push event: 49
• Pull request review comment event: 47
• Pull request review event: 57
• Pull request event: 68
• Fork event: 15

---

Committers metadata

Last synced: 4 days ago

Name	Email	Commits
Jonas Hörsch	h****h@f****e	159
Fabian	f****f@g****e	146
pre-commit-ci[bot]	6****]	84
euronion	4****n	44
Fabian Neumann	f****n@o****e	32
Lukas Trippe	l****p@p****e	26
Parisra	1****a	22
Tom Brown	t****m@n****g	20
LukasFrankenQ	l****n@g****m	14
Markus Schlott	s****t@u****e	11
Max Parzen	m****n@e****k	10
Enrique Lizarraga-Garcia-WALT	e****a@m****m	10
energyls	l****m@o****e	7
davide-f	f****s@g****m	7
David Schlachtberger	s****r@f****e	6
Seth	s****n@g****m	6
calvintr	c****s@a****m	6
Zoltán Marić	5****c	5
Tasqu	t****u@v****i	5
martavp	m****z@g****m	4
Youssef Miftah	m****o@o****r	3
hailiangliu89	h****9	3
Philipp Glaum	p****m@r****e	2
dependabot[bot]	4****]	2
lumbric	l****c@g****m	1
Bryn Pickering	b****g@u****h	1
fabulous	f****s@G****x	1
RichardScottOZ	7****Z	1
Ove Haugvaldstad	o****v@o****m	1
Matthias Zech	m****h@g****m	1
and 7 more...

Committer domains:

• fias.uni-frankfurt.de: 2
• godulas-imac-5.fritz.box: 1
• usys.ethz.ch: 1
• rwth-aachen.de: 1
• outlook.fr: 1
• vtt.fi: 1
• aol.com: 1
• oth-regensburg.de: 1
• mckinsey.com: 1
• ed.ac.uk: 1
• users.fias.science: 1
• nworbmot.org: 1
• pm.me: 1
• outlook.de: 1
• gmx.de: 1

---

Issue and Pull Request metadata

Last synced: 1 day ago

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

---

---

---

Package metadata

• Total packages: 3
• Total downloads:
  • pypi: 2,337 last-month
• Total dependent packages: 0 (may contain duplicates)
• Total dependent repositories: 18 (may contain duplicates)
• Total versions: 51
• Total maintainers: 3

---

Dependencies

Score: 17.242955050674837