Skip to main content

pymin pytested doi

docs/source/_static/logo_dynsight.png

Overview

dynsight is an open Python platform built to support a wide range of tasks commonly encountered in the analysis of complex dynamical systems. The software contains and combines modules that allows resolving and handling trajectory data, computing single-particle descriptors obtaining time-series data that are easier to analyze, performing time-series data clustering, and extracting relevant information out of them. dynsight contains also various auxiliary tools useful to data analysis, including, e.g., modules (vision and track) for resolving individual-object trajectories for many-body systems - e.g., experimental ones - for which these are not readily available, denoising algorithms, and tools for assessing maximum information extraction from data.

The documentation is available at: dynsight.readthedocs.io

If you use dynsight, please to cite the associated scientific paper:

S. Martino, M. Becchi, A. Tarzia, D. Rapetti, C. Lionello & G. M. Pavan
“dynsight: an open Python platform for simulation and experimental trajectory data analysis”
J. Chem. Phys. (2026), DOI: 10.1063/5.0309974

Installation

To get dynsight, you can install it with pip:

$ pip install dynsight

Optional Dependancies

Old versions dynsight used cpctools for SOAP calculations, if you are using Python 3.10 and below, you can use cpctools to access SOAPify and hd5er using

$ pip install cpctools

If you want to use the dynsight.vision and dynsight.track modules you will need to install a series of packages. This can be done with with pip:

$ pip install ultralytics PyYAML

How to get started

We suggest you give a read to the dynsight.trajectory module documentation, which offers a compact and easy way of using most of the dynsight tools. Also, the documentation offers some copiable Recipes and Examples for the most common analyses.

How to contribute

If you make changes or improvements to the codebase, please open a pull request on our GitHub repository. This allows us to review, discuss, and integrate contributions in a transparent and collaborative manner. Make sure to include a clear description of the changes and link any related issues if applicable.

Developer Setup

  1. Install just.

  2. In a new virtual environment run:

    $ just dev
  3. Run code checks:

    $ just check

Tutorials and examples

We provide and continuously update a set of tutorials to help new users to get started with dynsight. They are available at the following link: https://dynsight.readthedocs.io/en/latest/tutorials_menu.html.

There are also examples throughout the documentation and available in the examples/ directory of this repository.

Acknowledgements

dynsight is developed and mantained by the G. M. Pavan group at Politecnico di Torino, https://www.gmpavanlab.polito.it/. Many group members continuously provide, with their daily work, useful feedback that we gratefully acknowledge.

Metadata

Release files for dynsight 2026.9.3

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for dynsight 2026.9.3
File Size Uploaded
dynsight-2026.9.3.tar.gz 83.3 MB Details

Built distribution (wheel)

Table of built distributions (wheels) for dynsight 2026.9.3
File Interpreter ABI Platform
dynsight-2026.9.3-py3-none-any.whl Python 3 none any Details

Total release size: 83.4 MB

Release files / dynsight-2026.9.3.tar.gz

Download URL dynsight-2026.9.3.tar.gz
Size 83.3 MB
Tags Source
SHA-256 checksum
How to use checksums
bf9c4ff6724e0b83d5eb574ba4d6ac6be7ff33ca20b8ae0d3273bd8d662686b6
BLAKE2b-256 checksum
How to use checksums
b437fb716aeb431d346ed07cd4577506b40553e122b151ef4f4228fa554bd2b1
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.10.21

Release files / dynsight-2026.9.3-py3-none-any.whl

Download URL dynsight-2026.9.3-py3-none-any.whl
Size 119.8 kB
Tags Python 3
SHA-256 checksum
How to use checksums
5782e23d2ad29a3dd5195fe3513af05fa94bf6394dbdeb23df6f31a03b30cc0e
BLAKE2b-256 checksum
How to use checksums
c32450fbe1c7d272b95439a4261ba2e403195cb3a77570f3d4bb55b7f3afde83
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.10.21
Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page