tsam

A Python package which uses different machine learning algorithms for the aggregation of time series.
https://github.com/fzj-iek3-vsa/tsam

Category: Energy Systems
Sub Category: Energy System Modeling Frameworks

Keywords

aggregation clustering energy-system optimization python time-series timeseries typical-periods

Keywords from Contributors

energy-system-modeling renewable-energy geospatial-analysis climate-change energy-systems optimisation renewables modelling-framework linopy pypsa

Last synced: about 3 hours ago
JSON representation

Repository metadata

Time series aggregation module (tsam). Determines typical operation periods or decreases the temporal resolution. Accelerates model or experiment runs.

Host: GitHub
URL: https://github.com/fzj-iek3-vsa/tsam
Owner: FZJ-IEK3-VSA
License: mit
Created: 2017-05-15T08:36:11.000Z (about 9 years ago)
Default Branch: develop
Last Pushed: 2026-07-01T20:06:36.000Z (4 days ago)
Last Synced: 2026-07-01T20:16:55.209Z (4 days ago)
Topics: aggregation, clustering, energy-system, optimization, python, time-series, timeseries, typical-periods
Language: Python
Homepage: https://tsam.readthedocs.io/
Size: 194 MB
Stars: 177
Watchers: 7
Forks: 40
Open Issues: 29
Releases: 33
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE.txt

Owner metadata

Name: Forschungszentrum Jülich - Jülich Systems Analysis
Login: FZJ-IEK3-VSA
Email:
Kind: organization
Description: Institute of Climate and Energy Systems (ICE)
Website: https://www.fz-juelich.de/iek/iek-3/EN/Home/home_node.html
Location: Forschungszentrum Jülich
Twitter:
Company:
Icon url: https://avatars.githubusercontent.com/u/28654423?v=4
Repositories: 16
Last ynced at: 2024-12-23T04:12:17.721Z
Profile URL: https://github.com/FZJ-IEK3-VSA

GitHub Events

Total

Release event: 1
Delete event: 24
Pull request event: 59
Fork event: 4
Issues event: 17
Watch event: 22
Issue comment event: 56
Push event: 182
Pull request review comment event: 17
Pull request review event: 24
Create event: 65

Last Year

Delete event: 24
Pull request event: 54
Fork event: 1
Issues event: 13
Watch event: 7
Issue comment event: 46
Push event: 177
Pull request review comment event: 17
Pull request review event: 20
Create event: 62

Committers metadata

Last synced: 3 days ago

Total Commits: 593
Total Committers: 30
Avg Commits per committer: 19.767
Development Distribution Score (DDS): 0.749

Commits in past year: 269
Committers in past year: 10
Avg Commits per committer in past year: 26.9
Development Distribution Score (DDS) in past year: 0.446

Name	Email	Commits
FBumann	1****n	149
l-kotzur	l**r@f**e	138
maximilian-hoffmann	m**n@f**e	98
renovate[bot]	2****]	55
Julian Belina	5****a	39
Leander Kotzur	l**r@r**e	26
j.belina	j**a@f**e	18
j.schoenau	j**u@f**e	10
jo-omoyele	j**e@g**m	10
Julian Schönau	6****e	7
Cord Kaldemeyer	c**r@f**e	4
Fabian Neumann	f**n@o**e	4
Samuel Letellier-Duchesne	s**e@m**m	4
Amedeo Paolo Ceruti	g**z@m**e	3
Robert Schwarz	r**t@d**l	3
dependabot[bot]	4****]	3
fzj-iek3-vsa-release-bot[bot]	2****]	3
github-actions[bot]	4****]	3
Lars Schellhas	l**s@o**m	2
Philipp Dunkel	8****j	2
andreas smolenko	a**o@f**e	2
simnh	s**t@u**e	2
Amedeo Ceruti	a**i@t**e	1
Francesco Witte	g**b@w**h	1
Sai Asish Y	s**5@g**m	1
Vincent Gao	g**0@g**m	1
Dilara Gulcin Caglayan	d**n@f**e	1
ar-fu	a**s@r**e	1
noah80	n****0	1
rodo	r**d@d**m	1

Committer domains:

Issue and Pull Request metadata

Last synced: 4 days ago

Total issues: 47
Total pull requests: 105
Average time to close issues: 5 months
Average time to close pull requests: 17 days
Total issue authors: 22
Total pull request authors: 25
Average comments per issue: 2.04
Average comments per pull request: 1.15
Merged pull request: 72
Bot issues: 1
Bot pull requests: 16

Past year issues: 9
Past year pull requests: 33
Past year average time to close issues: 30 days
Past year average time to close pull requests: 3 days
Past year issue authors: 6
Past year pull request authors: 8
Past year average comments per issue: 0.56
Past year average comments per pull request: 1.12
Past year merged pull request: 18
Past year bot issues: 1
Past year bot pull requests: 16

More stats: https://issues.ecosyste.ms/repositories/lookup?url=https://github.com/fzj-iek3-vsa/tsam

Top Issue Authors

julian-belina (7)
ckaldemeyer (7)
l-kotzur (6)
l-welder (4)
phil-fzj (3)
adbuerger (2)
FBumann (2)
sbruche (2)
curiousleo (1)
jacob-mannhardt (1)
alicia-le (1)
mfleschutz (1)
renovate[bot] (1)
fneum (1)
SilkeJo (1)

Top Pull Request Authors

l-kotzur (27)
renovate[bot] (14)
julian-belina (10)
FBumann (10)
maximilian-hoffmann (7)
OfficialCodexplosive (7)
larsschellhas (3)
jo-omoyele (3)
phil-fzj (3)
ddceruti (3)
samuelduchesne (2)
ar-fu (2)
fneum (2)
dcaglayan (1)
fzj-iek3-vsa-release-bot[bot] (1)

Top Issue Labels

bug (4)
enhancement (1)

Top Pull Request Labels

dependencies (15)
bug (2)
autorelease: pending (1)
github-actions (1)

Package metadata

Total packages: 4
Total downloads:
- pypi: 74,574 last-month
Total dependent packages: 7 (may contain duplicates)
Total dependent repositories: 29 (may contain duplicates)
Total versions: 90
Total maintainers: 5

pypi.org: tsam

Time series aggregation module (tsam) to create typical periods

Homepage:
Documentation: https://tsam.readthedocs.io/
Licenses: MIT License
Latest release: 3.4.1 (published about 1 month ago)
Last Synced: 2026-07-02T13:58:21.396Z (3 days ago)
Versions: 39
Dependent Packages: 6
Dependent Repositories: 29
Downloads: 74,574 Last month
Rankings:
- Dependent packages count: 1.596%
- Dependent repos count: 2.716%
- Average: 4.737%
- Downloads: 6.188%
- Stargazers count: 6.257%
- Forks count: 6.928%
Maintainers (5)
- l.kotzur
- machaitch1993
- t-gross
- j.belina
- j-weinand

proxy.golang.org: github.com/FZJ-IEK3-VSA/tsam

Homepage:
Documentation: https://pkg.go.dev/github.com/FZJ-IEK3-VSA/tsam#section-documentation
Licenses: mit
Latest release: v3.4.1+incompatible (published about 1 month ago)
Last Synced: 2026-07-02T13:58:21.882Z (3 days ago)
Versions: 25
Dependent Packages: 0
Dependent Repositories: 0
Rankings:
- Dependent packages count: 6.999%
- Average: 8.173%
- Dependent repos count: 9.346%

proxy.golang.org: github.com/fzj-iek3-vsa/tsam

Homepage:
Documentation: https://pkg.go.dev/github.com/fzj-iek3-vsa/tsam#section-documentation
Licenses: mit
Latest release: v3.4.1+incompatible (published about 1 month ago)
Last Synced: 2026-07-02T13:58:21.831Z (3 days ago)
Versions: 25
Dependent Packages: 0
Dependent Repositories: 0
Rankings:
- Dependent packages count: 6.999%
- Average: 8.173%
- Dependent repos count: 9.346%

conda-forge.org: tsam

Homepage: https://github.com/FZJ-IEK3-VSA/tsam
Licenses: MIT
Latest release: 2.0.1 (published about 4 years ago)
Last Synced: 2026-04-02T15:47:50.344Z (3 months ago)
Versions: 1
Dependent Packages: 1
Dependent Repositories: 0
Rankings:
- Dependent packages count: 28.82%
- Stargazers count: 29.339%
- Forks count: 29.863%
- Average: 30.512%
- Dependent repos count: 34.025%

Dependencies

requirements.txt pypi

networkx *
numpy >=1.11.0
pandas >=0.18.1
pyomo >=5.3
scikit-learn >=0.0
tqdm *

.github/workflows/pytest.yml actions

actions/checkout v2 composite
actions/setup-python v2 composite

requirements_dev.txt pypi

pytest * development
sphinx * development
sphinx-autobuild * development
sphinx_book_theme * development
twine * development

setup.py pypi

Score: 19.949170388817304

ecosyste.ms

Data

Tools

Indexes

Applications

Experiments

Open Sustainable Technology