General simulation data file format.

These details have not been verified by PyPI

Project links

Development Status
- 5 - Production/Stable
Intended Audience
- Developers
- Science/Research
License
- OSI Approved :: BSD License
Operating System
- MacOS :: MacOS X
- POSIX
Topic
- Scientific/Engineering :: Physics

Project description

GSD

The GSD file format is the native file format for HOOMD-blue. GSD files store trajectories of the HOOMD-blue system state in a binary file with efficient random access to frames. GSD allows all particle and topology properties to vary from one frame to the next. Use the GSD Python API to specify the initial condition for a HOOMD-blue simulation or analyze trajectory output with a script. Read a GSD trajectory with a visualization tool to explore the behavior of the simulation.

Resources

GSD documentation: Tutorials, Python API, C API, usage information, and format specification.
Installation Guide: Instructions for installing and compiling GSD.
HOOMD-blue: Simulation engine that reads and writes GSD files.
GSD discussion board: Ask the GSD community for help.
freud: A powerful set of tools for analyzing trajectories.
OVITO: The Open Visualization Tool works with GSD files.
gsd-vmd plugin: VMD plugin to support GSD files.

HOOMD examples

Create a hoomd gsd file.

>>> s = gsd.hoomd.Frame()
>>> s.particles.N = 4
>>> s.particles.types = ['A', 'B']
>>> s.particles.typeid = [0,0,1,1]
>>> s.particles.position = [[0,0,0],[1,1,1], [-1,-1,-1], [1,-1,-1]]
>>> s.configuration.box = [3, 3, 3, 0, 0, 0]
>>> traj = gsd.hoomd.open(name='test.gsd', mode='w')
>>> traj.append(s)

Append frames to a gsd file:

>>> def create_frame(i):
...     s = gsd.hoomd.Frame();
...     s.configuration.step = i;
...     s.particles.N = 4+i;
...     s.particles.position = numpy.random.random(size=(4+i,3))
...     return s;
>>> with gsd.hoomd.open('test.gsd', 'a') as t:
...     t.extend( (create_frame(i) for i in range(10)) )
...     print(len(t))
11

Randomly index frames:

>>> with gsd.hoomd.open('test.gsd', 'r') as t:
...     frame = t[5]
...     print(frame.configuration.step)
4
...     print(frame.particles.N)
8
...     print(frame.particles.position)
[[ 0.56993282  0.42243481  0.5502916 ]
 [ 0.36892486  0.38167036  0.27310368]
 [ 0.04739023  0.13603486  0.196539  ]
 [ 0.120232    0.91591144  0.99463677]
 [ 0.79806316  0.16991436  0.15228257]
 [ 0.13724308  0.14253527  0.02505   ]
 [ 0.39287439  0.82519054  0.01613089]
 [ 0.23150323  0.95167434  0.7715748 ]]

Slice frames:

>>> with gsd.hoomd.open('test.gsd', 'r') as t:
...     for s in t[5:-2]:
...         print(s.configuration.step, end=' ')
4 5 6 7

File layer examples

with gsd.fl.open(name='file.gsd', mode='w') as f:
    f.write_chunk(name='position', data=numpy.array([[1,2,3],[4,5,6]], dtype=numpy.float32));
    f.write_chunk(name='angle', data=numpy.array([0, 1], dtype=numpy.float32));
    f.write_chunk(name='box', data=numpy.array([10, 10, 10], dtype=numpy.float32));
    f.end_frame()

with gsd.fl.open(name='file.gsd', mode='r') as f:
    for i in range(1,f.nframes):
        position = f.read_chunk(frame=i, name='position');
        do_something(position);

Project details

These details have not been verified by PyPI

Project links

Development Status
- 5 - Production/Stable
Intended Audience
- Developers
- Science/Research
License
- OSI Approved :: BSD License
Operating System
- MacOS :: MacOS X
- POSIX
Topic
- Scientific/Engineering :: Physics

Release history Release notifications | RSS feed

3.4.2

Nov 13, 2024

3.4.1

Oct 21, 2024

This version

3.4.0

Oct 18, 2024

3.3.2

Sep 6, 2024

3.3.1

Aug 19, 2024

3.3.0

May 29, 2024

3.2.1

Jan 22, 2024

3.2.0

Sep 27, 2023

3.1.1

Aug 3, 2023

3.1.0

Jul 28, 2023

3.0.1

Jun 21, 2023

3.0.0

Jun 16, 2023

2.9.0

May 19, 2023

2.8.1

Apr 13, 2023

2.8.0

Feb 24, 2023

2.7.0

Nov 30, 2022

2.6.1

Nov 4, 2022

2.6.0

Aug 19, 2022

2.5.3

Jun 23, 2022

2.5.2

Apr 15, 2022

2.5.1

Nov 17, 2021

2.5.0

Oct 13, 2021

2.4.2

Apr 14, 2021

2.4.1

Mar 11, 2021

2.4.0

Nov 11, 2020

2.3.0

Oct 30, 2020

2.2.0

Aug 5, 2020

2.1.2

Jun 26, 2020

2.1.1

Apr 20, 2020

2.1.0

Feb 27, 2020

2.0.0

Feb 3, 2020

1.10.0

Nov 26, 2019

1.9.3

Oct 4, 2019

1.9.2

Oct 1, 2019

1.9.1

Sep 23, 2019

1.9.0

Sep 18, 2019

1.8.1

Aug 19, 2019

1.7.0

Apr 30, 2019

1.6.2

Apr 17, 2019

1.6.1

Mar 5, 2019

1.6.0

Dec 20, 2018

1.5.5

Nov 28, 2018

1.5.4

Oct 4, 2018

1.5.2

Apr 4, 2018

1.5.1

Feb 26, 2018

1.5.0

Jan 19, 2018

1.4.0

Dec 5, 2017

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

gsd-3.4.0.tar.gz (185.3 kB view details)

Uploaded Oct 18, 2024 Source

Built Distributions

gsd-3.4.0-cp313-cp313-win_amd64.whl (257.0 kB view details)

Uploaded Oct 18, 2024 CPython 3.13 Windows x86-64

gsd-3.4.0-cp313-cp313-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (664.9 kB view details)

Uploaded Oct 18, 2024 CPython 3.13 manylinux: glibc 2.17+ x86-64

gsd-3.4.0-cp313-cp313-macosx_11_0_arm64.whl (259.3 kB view details)

Uploaded Oct 18, 2024 CPython 3.13 macOS 11.0+ ARM64

gsd-3.4.0-cp313-cp313-macosx_10_13_x86_64.whl (263.1 kB view details)

Uploaded Oct 18, 2024 CPython 3.13 macOS 10.13+ x86-64

gsd-3.4.0-cp312-cp312-win_amd64.whl (257.7 kB view details)

Uploaded Oct 18, 2024 CPython 3.12 Windows x86-64

gsd-3.4.0-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (669.4 kB view details)

Uploaded Oct 18, 2024 CPython 3.12 manylinux: glibc 2.17+ x86-64

gsd-3.4.0-cp312-cp312-macosx_11_0_arm64.whl (260.6 kB view details)

Uploaded Oct 18, 2024 CPython 3.12 macOS 11.0+ ARM64

gsd-3.4.0-cp312-cp312-macosx_10_13_x86_64.whl (264.5 kB view details)

Uploaded Oct 18, 2024 CPython 3.12 macOS 10.13+ x86-64

gsd-3.4.0-cp311-cp311-win_amd64.whl (259.9 kB view details)

Uploaded Oct 18, 2024 CPython 3.11 Windows x86-64

gsd-3.4.0-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (667.0 kB view details)

Uploaded Oct 18, 2024 CPython 3.11 manylinux: glibc 2.17+ x86-64

gsd-3.4.0-cp311-cp311-macosx_11_0_arm64.whl (261.2 kB view details)

Uploaded Oct 18, 2024 CPython 3.11 macOS 11.0+ ARM64

gsd-3.4.0-cp311-cp311-macosx_10_9_x86_64.whl (265.9 kB view details)

Uploaded Oct 18, 2024 CPython 3.11 macOS 10.9+ x86-64

gsd-3.4.0-cp310-cp310-win_amd64.whl (259.8 kB view details)

Uploaded Oct 18, 2024 CPython 3.10 Windows x86-64

gsd-3.4.0-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (644.9 kB view details)

Uploaded Oct 18, 2024 CPython 3.10 manylinux: glibc 2.17+ x86-64

gsd-3.4.0-cp310-cp310-macosx_11_0_arm64.whl (261.1 kB view details)

Uploaded Oct 18, 2024 CPython 3.10 macOS 11.0+ ARM64

gsd-3.4.0-cp310-cp310-macosx_10_9_x86_64.whl (265.6 kB view details)

Uploaded Oct 18, 2024 CPython 3.10 macOS 10.9+ x86-64

File details

Details for the file gsd-3.4.0.tar.gz.

File metadata

Download URL: gsd-3.4.0.tar.gz
Upload date: Oct 18, 2024
Size: 185.3 kB
Tags: Source
Uploaded using Trusted Publishing? No
Uploaded via: twine/5.1.1 CPython/3.12.7

File hashes

Hashes for gsd-3.4.0.tar.gz
Algorithm	Hash digest
SHA256	`96d9c765f1cf9f96ef96e8daef0583f89cc3d005f583fb9a5d43876aa4c8c67d`
MD5	`99a5fd34ab17edbde3997e3c60f32efd`
BLAKE2b-256	`2fbc43a98d3e3358b94faeb3e19c5f2ade5fb39ea8cc4a6e431b887d8f838ea2`

Algorithm	Hash digest
SHA256	`3409ec80787f2aff30254b66aaa505a90b7c89492c88870e909bd54a2b40d086`
MD5	`272420e0c3bbf98fcbf47f39b68c48e1`
BLAKE2b-256	`23197cc86dd24f2dd248132fb9474511ce26df40877f55c7fde7c782ab99ef1e`

Algorithm	Hash digest
SHA256	`9f68df11884d6863841d8f605419a21cb4c0d753ec87645bae1a2b5e1da3f885`
MD5	`88c6917518b943aa214f7220593731c8`
BLAKE2b-256	`1284362cd54ffe855c16ea17b1b83723479348b071632225730b273821ed9e80`

Algorithm	Hash digest
SHA256	`8bbaa4e660bee124a5de00ea6c5e1a1c718920c10a89efda466d046aa6e1568d`
MD5	`94e778a2db3dcdc889e849d85381e73c`
BLAKE2b-256	`99d9c8939cafd6db63b83dd097a033429a35210c20ce649ed43c043620349f99`

Algorithm	Hash digest
SHA256	`9c4ac029e5270f5265dc8faae1cd66952716290440a8b5dc3fd00916e7b41010`
MD5	`d26392e50e0ed047628f1874e334f14e`
BLAKE2b-256	`5d80f3d23d05f71cf44b5a2c8519a8b4eb0952c64eb089134dd943b0aab5435a`

Algorithm	Hash digest
SHA256	`52b972cf18a10ad61018f80888809fdcbc5ca86efc00c86099de326ad90acd1d`
MD5	`41779adf89a9f9a95425d9474954e177`
BLAKE2b-256	`2b73b571cd053ffdd32b1577adb0bcfc472a8d2e478fc0f364ddfe3dc9c17653`

Algorithm	Hash digest
SHA256	`ee4d17decdb803b6d7f1cfe419696966636e5c58680db3e85b137ac357feee12`
MD5	`032a7d606640efb09b50952b54f77307`
BLAKE2b-256	`f29c9691c49bb7d756209d94befc9cc45094e2b420f7cff198dddcf7b19d4ee2`

Algorithm	Hash digest
SHA256	`6aea2acbcbeda15f4f44a977bb1bef334cf8a82915227bed2923e40babefe057`
MD5	`0bcf7504a2cc63d9debea96d0dcadd73`
BLAKE2b-256	`dd62c821e7430318fcbaa901f13c7fd2b9d12a4d789ab13078c8ecc4342ea54e`

Algorithm	Hash digest
SHA256	`03971d0dc121a1b2845984f246dd5c3ab95cad40786fe2f6c89159583d547300`
MD5	`325c191cda68ea27b43921f3f7372ff3`
BLAKE2b-256	`1d5a173fa1ac4c2b9fbe158fef602c368baa2d360660aec03384fca1724d8ebe`

Algorithm	Hash digest
SHA256	`8af327337316420f7f11472635e2bb0ff902db4758cf142e10edf5fb57f35afb`
MD5	`3b3f4b84de2f324d51af938134810742`
BLAKE2b-256	`2e460a07a53c58259306be2b5a60b1999d29ae6038306504b713360c8f4fc670`

Algorithm	Hash digest
SHA256	`9f429ed483ac76d30af74ebdaf0a46e607f53bb74f5f5801161306992477efdc`
MD5	`cfb740fb6d4e54e8ab8cf629215d5994`
BLAKE2b-256	`312a2f29f00bc6deb1fb7e13e6fd4d926739b114782afbfd51feaab646782e27`

Algorithm	Hash digest
SHA256	`e519ace9e5d835730f0a32e22fb225c3810db4aef056e1fc3f6a0b00b6b95a5d`
MD5	`450cd1f9be3bb639a47bc36974612c2d`
BLAKE2b-256	`56a72ea0a9feda66020c678ccdc3af2ffebf96e3412a7ec58058a7e13893e764`

Algorithm	Hash digest
SHA256	`3ba145c43ebbcea4dee3c3903eb9945794af97abda5a64ec223cb66d38ca85d1`
MD5	`c2c0e642f1726cc71ecda57d63f087ae`
BLAKE2b-256	`428583131415f4830cf446a38868d1dac5ff5004bca27643bd41fc17c1333bb4`

Algorithm	Hash digest
SHA256	`2063bda1849ea86a5fb142a13079d2881a1d16c56b05f43b3114bd7b72355b53`
MD5	`ae32ff129f5a5a0433b0ec66889ab084`
BLAKE2b-256	`7c7a1741b13a5974dbc6796271c1f085dbb61474877bebf58a59400257f0cfc7`

Algorithm	Hash digest
SHA256	`3412e6aa6359dcf5a31e7aa379d524362c91a048bb9494f4c656105d95fa30dd`
MD5	`fad972aae135823905f7dabe84f92fa2`
BLAKE2b-256	`a104c974893fa116a071571202f61c858d2f9f8faf201254a5e3407bc74151f8`

Algorithm	Hash digest
SHA256	`11fb612e8aa4706e747aa0a610f4c515e422f6911e349386b02e0220aaecfd3f`
MD5	`86d39c8d1480e7d4ee14489bfa2bf079`
BLAKE2b-256	`e994ba73a14b3e869175752c5dcfcbe39dff643f921520fbda3c157979af293e`

Algorithm	Hash digest
SHA256	`051c444f92a31fc566488a9800bcd7eaf5a9c5cb6defa4aabc1778acbad33c6d`
MD5	`7402894f51b6cdc30dc7c909dd584832`
BLAKE2b-256	`4e4bf23b6fac0d7363b599bf4478b3372061d35e949234a4d99a372a7c07f5c6`

gsd 3.4.0

Navigation

Verified details

Maintainers

Unverified details

Project links

Meta

Classifiers

Project description

GSD

Resources

HOOMD examples

File layer examples

Project details

Verified details

Maintainers

Unverified details

Project links

Meta

Classifiers

Release history Release notifications | RSS feed

Download files

Source Distribution

Built Distributions

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes