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
-
installing with uv in global tool mode:
uv tool install trajole -
or if you want to isolate it:
uvx trajole -
if you want to stay in the pip ecososystem, you can use pipx:
pipx install trajole -
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
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
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
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
2989e0fc61271103c5a1ebcca4ef665e327263cfa54bbc24762effde19990536
|
|
| MD5 |
1ca86cfdb923a714c29b87f835e6c8fb
|
|
| BLAKE2b-256 |
1520091e5a5405714c22c24561336289b78b7cbc614d89dbd48feb21f9bc9e91
|
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
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
81c55db30917fd487297b02692cc6204266869cc158e7cbaf88b0a0f8efffde5
|
|
| MD5 |
3978c068ecadb2bc94217f3e80573f1b
|
|
| BLAKE2b-256 |
f520bbb9894daa1c4ada059e5c01dbfba26d2f17ce97a097aeda147fc2d5c4b9
|