Skip to main content

MD trajectory viewer

Project description

trajole: integrated ligand/energy-surface trajectory viewer

This viewer allows easy exploration of MD trajectories:

  • hop through frames or 2d matrix view
  • easy bookmarking of specific views, frames and details
  • pocket discovery tool
  • ligand table against a conformation
  • contact map
  • inter-atomic distance plots
  • port mapping for remote vm's

It also prioritises fast loading, mainly by skipping solvent atoms as a default.

Other viewers will be better for publication quality images.

Installation

uv is the best tool to install python tooling.

Note: on Mac, there may be a slow initial startup time as Rosetta transpiles some x86 libraries to ARM

  1. installing with uv in global tool mode:

    uv tool install trajole

  2. or if you want to isolate it:

    uvx trajole

  3. if you want to stay in the pip ecososystem, you can use pipx:

    pipx install trajole

  4. or if you want to install it in your current environment:

    pip install trajole

Once installed, check out the command-line options by running the command:

  `trajole`

Examples: I suggest downloading the examples to play with all the different modes: https://github.com/boscoh/trajole/tree/main/examples

Developing trajole

trajole has two components

  • back-end server which is a Python fastapi backend server that reads trajectories and serves it over a local port
  • front-end client that runs in the browser and displays free-energy surfaces and proteins

Building the trajole client in development mode

Installing javascript deps

First you must install the dependencies in rseed/rseed/jolecule/vue:

npm install

Then you must install the jolecule js repo somewhere in your system (not in the rseed directory).

In /path/to/jolecule:

npm link

Then in trajole/client:

npm link jolecule

Once linked, we can build the client:

npm run build

Then you need to run the build script, that will copy the client into sever/client:

./build.sh

Release Notes

  • 1.6.11
    • more bug fixes
  • 1.6.10
    • bug fixes for loading frames
  • 1.6.9
    • multiple matrix
  • 1.6.8
    • always strips water by default
  • 1.6.7
    • autodetect sparse versus dense matrix
  • 1.6.6
    • defaults to rshow.matrix.yaml
    • handles uploads of matrix json or plain matrix double list
    • popups on left adjusts
    • autodetects sparse versus full matrix in fes
  • 1.6.5
    • consolidate with easytraj 0.2.5 and foamdb 0.4.0
  • 1.6.4
    • import cleanup
    • logging
    • easytrajh5 0.2.3
  • 1.6.3
    • import bus
  • 1.6.2
    • alphaspace toggle bug
    • easytrajh5 bus
  • 1.6
    • dep to easytrajh5
    • file_mode a/r detect
    • ensemble view
    • slideshow
  • 1.5.2
    • distance plots
  • 1.5
    • ligand focus
    • LRU fixed
    • select_min_frame
  • 1.4
    • dry_topology streaming
    • reworked async calls
    • Alphaspace Radius UX - pockets panel
    • refactored Vue components
    • Vuex for state
    • hydrogen on/off option
    • profiling logging output
  • 1.3.4
    • logging
  • 1.3.3
    • removed FES remapper
  • 1.3.2
    • deprecated FreeEnergySurface
  • 1.3.1
    • removed foamdb as dep (creates pip install issues)
  • 1.3
    • AS Communities
    • compatible with RSeed 2.2
  • 1.2
    • frames in url query
  • 1.1
    • alphaspace frame bug fix
  • 1.0
    • first release

Project details


Download files

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

Source Distribution

trajole-1.6.11.tar.gz (40.7 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

trajole-1.6.11-py3-none-any.whl (46.8 kB view details)

Uploaded Python 3

File details

Details for the file trajole-1.6.11.tar.gz.

File metadata

  • Download URL: trajole-1.6.11.tar.gz
  • Upload date:
  • Size: 40.7 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.7.5

File hashes

Hashes for trajole-1.6.11.tar.gz
Algorithm Hash digest
SHA256 2989e0fc61271103c5a1ebcca4ef665e327263cfa54bbc24762effde19990536
MD5 1ca86cfdb923a714c29b87f835e6c8fb
BLAKE2b-256 1520091e5a5405714c22c24561336289b78b7cbc614d89dbd48feb21f9bc9e91

See more details on using hashes here.

File details

Details for the file trajole-1.6.11-py3-none-any.whl.

File metadata

  • Download URL: trajole-1.6.11-py3-none-any.whl
  • Upload date:
  • Size: 46.8 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.7.5

File hashes

Hashes for trajole-1.6.11-py3-none-any.whl
Algorithm Hash digest
SHA256 81c55db30917fd487297b02692cc6204266869cc158e7cbaf88b0a0f8efffde5
MD5 3978c068ecadb2bc94217f3e80573f1b
BLAKE2b-256 f520bbb9894daa1c4ada059e5c01dbfba26d2f17ce97a097aeda147fc2d5c4b9

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page