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 5 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-17T15:15:21.000Z (8 days ago)
Last Synced: 2026-07-18T19:06:53.131Z (7 days ago)
Topics: aggregation, clustering, energy-system, optimization, python, time-series, timeseries, typical-periods
Language: Python
Homepage: https://tsam.readthedocs.io/
Size: 195 MB
Stars: 178
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: 26
Pull request event: 59
Fork event: 4
Issues event: 17
Watch event: 22
Issue comment event: 56
Push event: 190
Pull request review comment event: 17
Pull request review event: 24
Create event: 68

Last Year

Delete event: 26
Pull request event: 54
Fork event: 1
Issues event: 13
Watch event: 6
Issue comment event: 46
Push event: 185
Pull request review comment event: 17
Pull request review event: 20
Create event: 65

Committers metadata

Last synced: 3 days ago

Total Commits: 603
Total Committers: 30
Avg Commits per committer: 20.1
Development Distribution Score (DDS): 0.753

Commits in past year: 279
Committers in past year: 11
Avg Commits per committer in past year: 25.364
Development Distribution Score (DDS) in past year: 0.466

Name	Email	Commits
FBumann	1****n	149
l-kotzur	l**r@f**e	139
maximilian-hoffmann	m**n@f**e	98
renovate[bot]	2****]	63
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
fzj-iek3-vsa-release-bot[bot]	2****]	4
Robert Schwarz	r**t@d**l	3
dependabot[bot]	4****]	3
github-actions[bot]	4****]	3
Amedeo Paolo Ceruti	g**z@m**e	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
ar-fu	a**s@r**e	1
Dilara Gulcin Caglayan	d**n@f**e	1
noah80	n****0	1
rodo	r**d@d**m	1

Committer domains:

Issue and Pull Request metadata

Last synced: 3 days ago

Total issues: 53
Total pull requests: 138
Average time to close issues: 5 months
Average time to close pull requests: 15 days
Total issue authors: 22
Total pull request authors: 26
Average comments per issue: 2.15
Average comments per pull request: 1.04
Merged pull request: 96
Bot issues: 1
Bot pull requests: 28

Past year issues: 15
Past year pull requests: 66
Past year average time to close issues: 27 days
Past year average time to close pull requests: 5 days
Past year issue authors: 6
Past year pull request authors: 9
Past year average comments per issue: 1.53
Past year average comments per pull request: 0.91
Past year merged pull request: 42
Past year bot issues: 1
Past year bot pull requests: 28

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

Top Issue Authors

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

Top Pull Request Authors

FBumann (29)
l-kotzur (28)
renovate[bot] (24)
julian-belina (11)
maximilian-hoffmann (7)
OfficialCodexplosive (7)
larsschellhas (3)
jo-omoyele (3)
phil-fzj (3)
ddceruti (3)
fzj-iek3-vsa-release-bot[bot] (2)
fneum (2)
ar-fu (2)
samuelduchesne (2)
OriolRaventos (1)

Top Issue Labels

bug (4)
enhancement (3)

Top Pull Request Labels

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

Package metadata

Total packages: 4
Total downloads:
- pypi: 84,226 last-month
Total dependent packages: 7 (may contain duplicates)
Total dependent repositories: 29 (may contain duplicates)
Total versions: 92
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.2 (published 4 days ago)
Last Synced: 2026-07-22T21:24:09.671Z (3 days ago)
Versions: 40
Dependent Packages: 6
Dependent Repositories: 29
Downloads: 84,226 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 2 months ago)
Last Synced: 2026-07-20T20:01:45.247Z (5 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.2+incompatible (published 4 days ago)
Last Synced: 2026-07-22T21:24:11.206Z (3 days ago)
Versions: 26
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 over 4 years ago)
Last Synced: 2026-04-02T15:47:50.344Z (4 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: 20.075661783202634

ecosyste.ms

Data

Tools

Indexes

Applications

Experiments

Open Sustainable Technology