Skip to main content

Description

OMT (Open Modeling Tool) is used to numerically solve and visualize N-body problem with huge number of particles. Primary application is galactic evolution.

Prerequisites

It requires following packages to work:

pip install marshmallow marshmallow_jsonschema matplotlib pandas pyyaml argparse astropy py_expression_eval amuse-framework

You also need to install pyfalcon module which makes integration possible.

You might also need:

pip install flake8 isort mypy black types-pyyaml

Usage

Program has three modes: creation, integration and analysis. The semantical difference between them is as follows:

  • [data -> Snapshot] Creation mode creates snapshot from data. This data might be particles specified by their position, velocity and mass or the whole files with particle parameters inside them.

  • [Snapshot -> Snapshot] Integration mode alters existing snapshot. It takes some existing snapshot and performs some operation on it, then takes result and performs operation again and again until some specified condition is not met.

  • [Snapshot -> data] Analysis mode creates data from snapshot. It takes some snapshot and extracts some data (position, velocities, potentials, energies, etc.) then saves it to some form of file (image or log file).

Creation

This module is responsible for initialization of snapshots. You can create configuration YAML file which describes list of objects in the snapshot (single objects and *.csv files are supported for now).

The output is single FITS file which has two HDUs: empty primary one (it is required by FITS standard) and binary table with positions, velocities and masses of each particle in the system. It also stores timestamp T = 0 in the header.

You can start it with

python main.py create /path/to/config/file.yaml

Integration

This module is responsible for actual integration of the model from previous module. It operates similarly: you create configuration file with all the data necessary. Next step is to launch

python main.py integrate /path/to/config/file.yaml

It will print some info into console and gradually produce output FITS file. Each HDU of this file would contain timestamp in the TIME header and table with fields [x, y, z, vx, vy, vz, m]. Be aware that depending on number of particles it can take quite a lot of disk space.

Analysis

This module is responsible for the visualization of file with snapshots (for example, one from previous module). As always, you should create configuration file. The biggest part of it is description of matplotlib’s plots layout. Launch command:

python main.py analize /path/to/config/file.yaml

If done right it should produce a lot of pictures (the same amount as number of timestamps in the input file) similar to this one:

docs/source/images/image.png

This program is under heavy development so some things (or all of them) might work not as expected or not work at all.

Release files for omtool 0.2.0

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

Source distribution (sdist)

Source distribution for omtool 0.2.0
File Size Uploaded
omtool-0.2.0.tar.gz 24.6 kB Details

Built distribution (wheel)

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

Total release size: 59.6 kB

Release files / omtool-0.2.0.tar.gz

Download URL omtool-0.2.0.tar.gz
Size 24.6 kB
Tags Source
SHA-256 checksum
How to use checksums
03b86e80be432ef71b2c1ef3ec4ab0882742362c1a8b9747f60589e4c48772ec
BLAKE2b-256 checksum
How to use checksums
cba97bf3a65afe89c7f66a452da533d7a3a25a05d3a60a565e042b5cdb82f67a
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via poetry/1.1.14 CPython/3.10.5 Darwin/21.3.0

Release files / omtool-0.2.0-py3-none-any.whl

Download URL omtool-0.2.0-py3-none-any.whl
Size 34.9 kB
Tags Python 3
SHA-256 checksum
How to use checksums
2e8b712e1af36a80dc4ded13e55570ac49410d66531efe215e4342c9166cc14a
BLAKE2b-256 checksum
How to use checksums
ad4b6c69927963a667ef47c86e232594eed2a0d891f3353c09d48825172cfb58
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via poetry/1.1.14 CPython/3.10.5 Darwin/21.3.0

Release history Release notifications | RSS feed

This release

0.2.0 This release

2 release files

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