tmquick 1.0.3__tar.gz → 1.0.6__tar.gz
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- {tmquick-1.0.3/tmquick.egg-info → tmquick-1.0.6}/PKG-INFO +34 -17
- {tmquick-1.0.3 → tmquick-1.0.6}/README.md +73 -55
- {tmquick-1.0.3 → tmquick-1.0.6}/pyproject.toml +1 -1
- {tmquick-1.0.3 → tmquick-1.0.6}/readme_pypi.md +33 -16
- {tmquick-1.0.3 → tmquick-1.0.6/tmquick.egg-info}/PKG-INFO +34 -17
- {tmquick-1.0.3 → tmquick-1.0.6}/LICENSE.md +0 -0
- {tmquick-1.0.3 → tmquick-1.0.6}/MANIFEST.in +0 -0
- {tmquick-1.0.3 → tmquick-1.0.6}/setup.cfg +0 -0
- {tmquick-1.0.3 → tmquick-1.0.6}/setup.py +0 -0
- {tmquick-1.0.3 → tmquick-1.0.6}/tmq/__init__.py +0 -0
- {tmquick-1.0.3 → tmquick-1.0.6}/tmq/cli.py +0 -0
- {tmquick-1.0.3 → tmquick-1.0.6}/tmq/commands/__init__.py +0 -0
- {tmquick-1.0.3 → tmquick-1.0.6}/tmq/commands/average_trajmap_cli.py +0 -0
- {tmquick-1.0.3 → tmquick-1.0.6}/tmq/commands/csv2shift_cli.py +0 -0
- {tmquick-1.0.3 → tmquick-1.0.6}/tmq/commands/diff2graph_cli.py +0 -0
- {tmquick-1.0.3 → tmquick-1.0.6}/tmq/commands/hotspot_cli.py +0 -0
- {tmquick-1.0.3 → tmquick-1.0.6}/tmq/commands/pdb2csv_cli.py +0 -0
- {tmquick-1.0.3 → tmquick-1.0.6}/tmq/commands/shift2graph_cli.py +0 -0
- {tmquick-1.0.3 → tmquick-1.0.6}/tmq/commands/traj2pdb_cli.py +0 -0
- {tmquick-1.0.3 → tmquick-1.0.6}/tmq/commands/trajmap_cli.py +0 -0
- {tmquick-1.0.3 → tmquick-1.0.6}/tmq/core/__init__.py +0 -0
- {tmquick-1.0.3 → tmquick-1.0.6}/tmq/core/average_trajmap.py +0 -0
- {tmquick-1.0.3 → tmquick-1.0.6}/tmq/core/csv2shift.py +0 -0
- {tmquick-1.0.3 → tmquick-1.0.6}/tmq/core/diff2graph.py +0 -0
- {tmquick-1.0.3 → tmquick-1.0.6}/tmq/core/hotspot.py +0 -0
- {tmquick-1.0.3 → tmquick-1.0.6}/tmq/core/pdb2csv.py +0 -0
- {tmquick-1.0.3 → tmquick-1.0.6}/tmq/core/shift2graph.py +0 -0
- {tmquick-1.0.3 → tmquick-1.0.6}/tmq/core/traj2pdb.py +0 -0
- {tmquick-1.0.3 → tmquick-1.0.6}/tmq/core/trajmap.py +0 -0
- {tmquick-1.0.3 → tmquick-1.0.6}/tmq/utils/__init__.py +0 -0
- {tmquick-1.0.3 → tmquick-1.0.6}/tmq/utils/utils.py +0 -0
- {tmquick-1.0.3 → tmquick-1.0.6}/tmquick.egg-info/SOURCES.txt +0 -0
- {tmquick-1.0.3 → tmquick-1.0.6}/tmquick.egg-info/dependency_links.txt +0 -0
- {tmquick-1.0.3 → tmquick-1.0.6}/tmquick.egg-info/entry_points.txt +0 -0
- {tmquick-1.0.3 → tmquick-1.0.6}/tmquick.egg-info/requires.txt +0 -0
- {tmquick-1.0.3 → tmquick-1.0.6}/tmquick.egg-info/top_level.txt +0 -0
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
Metadata-Version: 2.4
|
|
2
2
|
Name: tmquick
|
|
3
|
-
Version: 1.0.
|
|
3
|
+
Version: 1.0.6
|
|
4
4
|
Summary: TrajMapQuick: Towards Fast Trajectory Map Analysis and Visualization
|
|
5
5
|
Author: Wande M. Oluyemi (PhD), Adeniyi T. Adewumi (PhD), Shadrach C. Eze, Stephen C. Nnemolisa, @ Research Laboratory for Rational Design of Drugs and Biomaterials (ResLaR Labs), Afe Babalola University, Ado-Ekiti Nigeria
|
|
6
6
|
Project-URL: Homepage, https://github.com/SHEDOOMTC/TrajMapQuick.git
|
|
@@ -42,12 +42,12 @@ We have also extended the code to allow for automatic detection of regions with
|
|
|
42
42
|
|
|
43
43
|
See **[Github](https://github.com/SHEDOOMTC/TrajMapQuick/blob/main/README.md)**
|
|
44
44
|
|
|
45
|
-
|
|
46
45
|
## **Installation**
|
|
46
|
+
|
|
47
|
+
### **From Source**
|
|
47
48
|
```bash
|
|
48
49
|
# Clone the repo
|
|
49
|
-
git clone https://github.com/SHEDOOMTC/TrajMapQuick.git
|
|
50
|
-
cd TrajMapQuick
|
|
50
|
+
git clone https://github.com/SHEDOOMTC/TrajMapQuick.git && cd TrajMapQuick
|
|
51
51
|
|
|
52
52
|
# In conda environment with pip
|
|
53
53
|
conda create -n tmq python=3.10
|
|
@@ -61,31 +61,45 @@ conda activate tmq
|
|
|
61
61
|
|
|
62
62
|
Use tmq --help to see the arguments
|
|
63
63
|
```
|
|
64
|
+
|
|
65
|
+
### **From PyPI**
|
|
66
|
+
```bash
|
|
67
|
+
pip install tmquick
|
|
68
|
+
conda install -c conda-forge mdtraj
|
|
69
|
+
```
|
|
70
|
+
|
|
64
71
|
## **Commands**
|
|
65
72
|
```bash
|
|
66
|
-
#TrajMapQuick uses a
|
|
67
|
-
tmq shift : Extract matrices, compute residue-residue shifts and make plots:
|
|
73
|
+
#TrajMapQuick uses a four levell subcommand from the global "tmq" command
|
|
74
|
+
tmq shift : Extract matrices, compute residue-residue shifts and make plots:
|
|
75
|
+
For more, use tmq shift --help
|
|
68
76
|
|
|
69
|
-
tmq hotspot : Detect hotspots in residue shifts and create plots:
|
|
77
|
+
tmq hotspot : Detect hotspots in residue shifts and create plots:
|
|
78
|
+
For more, use tmq hotspot --help
|
|
70
79
|
|
|
71
|
-
tmq diff
|
|
80
|
+
tmq diff: Computes difference between two matrices and creates
|
|
81
|
+
the difference map: For more, use tmq diff --help
|
|
72
82
|
|
|
73
|
-
tmq average Computes average of n matrices and creates the average map:
|
|
83
|
+
tmq average Computes average of n matrices and creates the average map:
|
|
84
|
+
For more, use tmq average --help
|
|
74
85
|
|
|
75
86
|
```
|
|
76
87
|
## **Usage (CLI)**
|
|
77
88
|
```bash
|
|
78
89
|
# For tmq shift, arguments are passed into the flags for trajectory, topology etc.
|
|
79
90
|
|
|
80
|
-
tmq shift --traj traj.pdb --top top.parmtop --str 1 --resr 1-300
|
|
91
|
+
tmq shift --traj traj.pdb --top top.parmtop --str 1 --resr 1-300 \
|
|
92
|
+
--resrs 110-125 --cent backbone --out shift_output
|
|
81
93
|
|
|
82
|
-
#for tmq hotspot, arguments are passed similiarly,
|
|
94
|
+
#for tmq hotspot, arguments are passed similiarly, the region of shift is not provided
|
|
83
95
|
|
|
84
|
-
tmq hotspot --traj traj.pdb --top top.parmtop --str 1 --resr 1-300
|
|
96
|
+
tmq hotspot --traj traj.pdb --top top.parmtop --str 1 --resr 1-300 \
|
|
97
|
+
--cent backbone --out hotspot_output
|
|
85
98
|
```
|
|
86
99
|
## **Usage (Python API)**
|
|
87
|
-
The core modules in the tmq library are clearly demonstrated in the
|
|
88
|
-
|
|
100
|
+
The core modules in the tmq library are clearly demonstrated in the
|
|
101
|
+
**[Python_API.ipynb](./Notebooks/Python_API.ipynb)** file
|
|
102
|
+
|
|
89
103
|
```python
|
|
90
104
|
#Typical modules are loaded and then used as explained in the jupyter notebook above:
|
|
91
105
|
|
|
@@ -120,7 +134,7 @@ jupyter notebook Python_API.ipynb
|
|
|
120
134
|
All library requirements are pre-installed installed via pip or conda and are available for use in CLI or via Python API
|
|
121
135
|
|
|
122
136
|
## **Examples**
|
|
123
|
-
Three trajectories and topologies files are included in the **[Test](./Test)** directory for users to try out the codes. Trajectory 1 has only 125 frames (from apo strucuture of PDB ID: 8EM8 with 789 residues) while others have 250 frames (from apo and bound strucutres of BACE1, with 389 residues). To get the full sized trajectories, see [** directory for users to try out the codes. Trajectory 1 has only 125 frames (from apo strucuture of PDB ID: 8EM8 with 789 residues) while others have 250 frames (from apo and bound strucutres of BACE1, with 389 residues). To get the full sized trajectories, see [](https://doi.org/10.5281/zenodo.20681326)
|
|
124
138
|
|
|
125
139
|
See the full examples on **[Github](https://github.com/SHEDOOMTC/TrajMapQuick/blob/main/README.md)**
|
|
126
140
|
|
|
@@ -154,9 +168,12 @@ For questions or issues, please contact us @ [Reslar Labs](reslarscience@gmail.c
|
|
|
154
168
|
If you use TrajMapQuick, please cite: SHEDOOMTC. (2026). TrajMapQuick: Towards Fast Trajectory Map Analysis and Visualization (v1.0). Zenodo. https://doi.org/10.5281/zenodo.20681061
|
|
155
169
|
|
|
156
170
|
**Software:**
|
|
157
|
-
[](https://doi.org/10.5281/zenodo.20681061)
|
|
172
|
+
|
|
158
173
|
|
|
159
174
|
**Dataset:**
|
|
160
|
-
[](https://doi.org/10.5281/zenodo.20681326)
|
|
176
|
+
|
|
177
|
+
|
|
161
178
|
|
|
162
179
|
|
|
@@ -13,51 +13,9 @@ We have also extended the code to allow for automatic detection of regions with
|
|
|
13
13
|
- **Hotspot Detection and Plotting:** This automatically probes and detects regions of high fluctuations and computes the residual shift for each region for downstream processing.
|
|
14
14
|
- **Hotspot Annotation:** An RMSF like plot is also generated with the key hotspots highlight for visual confirmation and inspection.
|
|
15
15
|
|
|
16
|
-
## **Project Structure**
|
|
17
|
-
<pre>
|
|
18
|
-
TrajMapQuick/
|
|
19
|
-
├── README.md # Project overview, installation, usage
|
|
20
|
-
├── requirements.txt # Python dependencies
|
|
21
|
-
├── setup.py # Packaging configuration
|
|
22
|
-
├── environment.yml # Build config
|
|
23
|
-
├── pyproject.toml # Build config
|
|
24
|
-
├── LICENSE # MIT license
|
|
25
|
-
├── Manifest.in
|
|
26
|
-
├── tmq/ # Source codes and CLI wrappers lives here
|
|
27
|
-
│ ├── cli.py/ # Main command line launcher
|
|
28
|
-
│ ├── __init__.py # Main launcher for the python API
|
|
29
|
-
│ ├── core/ # Python package folder
|
|
30
|
-
│ │ ├── __init__.py
|
|
31
|
-
│ │ ├── traj2pdb.py # Converts trajectory to pdb
|
|
32
|
-
│ │ ├── pdb2csv.py # Converts pdb to distance matrix
|
|
33
|
-
│ │ ├── trajmap.py # plots the trajectory map
|
|
34
|
-
│ │ ├── csv2shift.py # Core shift logic for a given loop
|
|
35
|
-
│ │ ├── shift2graph.py # Makes shift plots for a given loop
|
|
36
|
-
│ │ ├── hotspot.py # Automatic detection of regions with peak fluctuations
|
|
37
|
-
│ │ ├── diff2graph.py # Computes and plot difference map for two trajectories
|
|
38
|
-
│ │ └── average_trajmap.py # Computes and plot average map for two trajectories
|
|
39
|
-
│ ├── commands/ # Main wrapper for the CLI
|
|
40
|
-
│ │ ├── __init__.py
|
|
41
|
-
│ │ ├── traj2pdb_cli.py # CLI wrapper
|
|
42
|
-
│ │ ├── pdb2csv_cli.py # CLI wrapper
|
|
43
|
-
│ │ ├── trajmap_cli.py # CLI wrapper
|
|
44
|
-
│ │ ├── csv2shift_cli.py # CLI wrapper
|
|
45
|
-
│ │ ├── shift2graph_cli.py # CLI wrapper
|
|
46
|
-
│ │ ├── hotspot_cli.py # CLI wrapper
|
|
47
|
-
│ │ ├── diff2graph_cli.py # CLI wrapper
|
|
48
|
-
│ │ └── average_trajmap_cli.py# CLI wrapper
|
|
49
|
-
│ └── utils # Holds functions
|
|
50
|
-
│ │ ├── __init__.py
|
|
51
|
-
│ │ └── utils.py # utility functions
|
|
52
|
-
├── docs/ # docstrings for the modules
|
|
53
|
-
├── assets/ # Container for images
|
|
54
|
-
├── Tests/ # Containers for test trajectories and topologies
|
|
55
|
-
└── Conda/ # Backup YAML files
|
|
56
|
-
|
|
57
|
-
|
|
58
|
-
</pre>
|
|
59
|
-
|
|
60
16
|
## **Installation**
|
|
17
|
+
|
|
18
|
+
### **From Source**
|
|
61
19
|
```bash
|
|
62
20
|
# Clone the repo
|
|
63
21
|
git clone https://github.com/SHEDOOMTC/TrajMapQuick.git && cd TrajMapQuick
|
|
@@ -74,30 +32,44 @@ conda activate tmq
|
|
|
74
32
|
|
|
75
33
|
Use tmq --help to see the arguments
|
|
76
34
|
```
|
|
35
|
+
|
|
36
|
+
### **From PyPI**
|
|
37
|
+
```bash
|
|
38
|
+
pip install tmquick
|
|
39
|
+
conda install -c conda-forge mdtraj
|
|
40
|
+
```
|
|
41
|
+
|
|
77
42
|
## **Commands**
|
|
78
43
|
```bash
|
|
79
44
|
#TrajMapQuick uses a four levell subcommand from the global "tmq" command
|
|
80
|
-
tmq shift : Extract matrices, compute residue-residue shifts and make plots:
|
|
45
|
+
tmq shift : Extract matrices, compute residue-residue shifts and make plots:
|
|
46
|
+
For more, use tmq shift --help
|
|
81
47
|
|
|
82
|
-
tmq hotspot : Detect hotspots in residue shifts and create plots:
|
|
48
|
+
tmq hotspot : Detect hotspots in residue shifts and create plots:
|
|
49
|
+
For more, use tmq hotspot --help
|
|
83
50
|
|
|
84
|
-
tmq diff
|
|
51
|
+
tmq diff: Computes difference between two matrices and creates
|
|
52
|
+
the difference map: For more, use tmq diff --help
|
|
85
53
|
|
|
86
|
-
tmq average Computes average of n matrices and creates the average map:
|
|
54
|
+
tmq average Computes average of n matrices and creates the average map:
|
|
55
|
+
For more, use tmq average --help
|
|
87
56
|
|
|
88
57
|
```
|
|
89
58
|
## **Usage (CLI)**
|
|
90
59
|
```bash
|
|
91
60
|
# For tmq shift, arguments are passed into the flags for trajectory, topology etc.
|
|
92
61
|
|
|
93
|
-
tmq shift --traj traj.pdb --top top.parmtop --str 1 --resr 1-300
|
|
62
|
+
tmq shift --traj traj.pdb --top top.parmtop --str 1 --resr 1-300 \
|
|
63
|
+
--resrs 110-125 --cent backbone --out shift_output
|
|
94
64
|
|
|
95
|
-
#for tmq hotspot, arguments are passed similiarly,
|
|
65
|
+
#for tmq hotspot, arguments are passed similiarly, the region of shift is not provided
|
|
96
66
|
|
|
97
|
-
tmq hotspot --traj traj.pdb --top top.parmtop --str 1 --resr 1-300
|
|
67
|
+
tmq hotspot --traj traj.pdb --top top.parmtop --str 1 --resr 1-300 \
|
|
68
|
+
--cent backbone --out hotspot_output
|
|
98
69
|
```
|
|
99
70
|
## **Usage (Python API)**
|
|
100
|
-
The core modules in the tmq library are clearly demonstrated in the
|
|
71
|
+
The core modules in the tmq library are clearly demonstrated in the
|
|
72
|
+
**[Python_API.ipynb](./Notebooks/Python_API.ipynb)** file
|
|
101
73
|
|
|
102
74
|
```python
|
|
103
75
|
#Typical modules are loaded and then used as explained in the jupyter notebook above:
|
|
@@ -122,6 +94,50 @@ cd ./Notebooks/
|
|
|
122
94
|
jupyter notebook Python_API.ipynb
|
|
123
95
|
```
|
|
124
96
|
|
|
97
|
+
## **Project Structure**
|
|
98
|
+
<pre>
|
|
99
|
+
TrajMapQuick/
|
|
100
|
+
├── README.md # Project overview, installation, usage
|
|
101
|
+
├── requirements.txt # Python dependencies
|
|
102
|
+
├── setup.py # Packaging configuration
|
|
103
|
+
├── environment.yml # Build config
|
|
104
|
+
├── pyproject.toml # Build config
|
|
105
|
+
├── LICENSE # MIT license
|
|
106
|
+
├── Manifest.in
|
|
107
|
+
├── tmq/ # Source codes and CLI wrappers lives here
|
|
108
|
+
│ ├── cli.py/ # Main command line launcher
|
|
109
|
+
│ ├── __init__.py # Main launcher for the python API
|
|
110
|
+
│ ├── core/ # Python package folder
|
|
111
|
+
│ │ ├── __init__.py
|
|
112
|
+
│ │ ├── traj2pdb.py # Converts trajectory to pdb
|
|
113
|
+
│ │ ├── pdb2csv.py # Converts pdb to distance matrix
|
|
114
|
+
│ │ ├── trajmap.py # plots the trajectory map
|
|
115
|
+
│ │ ├── csv2shift.py # Core shift logic for a given loop
|
|
116
|
+
│ │ ├── shift2graph.py # Makes shift plots for a given loop
|
|
117
|
+
│ │ ├── hotspot.py # Automatic detection of regions with peak fluctuations
|
|
118
|
+
│ │ ├── diff2graph.py # Computes and plot difference map for two trajectories
|
|
119
|
+
│ │ └── average_trajmap.py # Computes and plot average map for two trajectories
|
|
120
|
+
│ ├── commands/ # Main wrapper for the CLI
|
|
121
|
+
│ │ ├── __init__.py
|
|
122
|
+
│ │ ├── traj2pdb_cli.py # CLI wrapper
|
|
123
|
+
│ │ ├── pdb2csv_cli.py # CLI wrapper
|
|
124
|
+
│ │ ├── trajmap_cli.py # CLI wrapper
|
|
125
|
+
│ │ ├── csv2shift_cli.py # CLI wrapper
|
|
126
|
+
│ │ ├── shift2graph_cli.py # CLI wrapper
|
|
127
|
+
│ │ ├── hotspot_cli.py # CLI wrapper
|
|
128
|
+
│ │ ├── diff2graph_cli.py # CLI wrapper
|
|
129
|
+
│ │ └── average_trajmap_cli.py# CLI wrapper
|
|
130
|
+
│ └── utils # Holds functions
|
|
131
|
+
│ │ ├── __init__.py
|
|
132
|
+
│ │ └── utils.py # utility functions
|
|
133
|
+
├── docs/ # docstrings for the modules
|
|
134
|
+
├── assets/ # Container for images
|
|
135
|
+
├── Tests/ # Containers for test trajectories and topologies
|
|
136
|
+
└── Conda/ # Backup YAML files
|
|
137
|
+
|
|
138
|
+
|
|
139
|
+
</pre>
|
|
140
|
+
|
|
125
141
|
## **Requirements**
|
|
126
142
|
- Trajectory processing libraries (mdtraj, biopython)
|
|
127
143
|
|
|
@@ -133,7 +149,7 @@ jupyter notebook Python_API.ipynb
|
|
|
133
149
|
All library requirements are pre-installed installed via pip or conda and are available for use in CLI or via Python API
|
|
134
150
|
|
|
135
151
|
## **Examples**
|
|
136
|
-
Three trajectories and topologies files are included in the **[Test](./Test)** directory for users to try out the codes. Trajectory 1 has only 125 frames (from apo strucuture of PDB ID: 8EM8 with 789 residues) while others have 250 frames (from apo and bound strucutres of BACE1, with 389 residues). To get the full sized trajectories, see [** directory for users to try out the codes. Trajectory 1 has only 125 frames (from apo strucuture of PDB ID: 8EM8 with 789 residues) while others have 250 frames (from apo and bound strucutres of BACE1, with 389 residues). To get the full sized trajectories, see [](https://doi.org/10.5281/zenodo.20681326)
|
|
137
153
|
|
|
138
154
|
|
|
139
155
|
The Utility of the shift command (using a 500 frame trajectory) was shown by the figure below:
|
|
@@ -190,10 +206,12 @@ For questions or issues, please contact us @ [Reslar Labs](reslarscience@gmail.c
|
|
|
190
206
|
|
|
191
207
|
If you use TrajMapQuick, please cite: SHEDOOMTC. (2026). TrajMapQuick: Towards Fast Trajectory Map Analysis and Visualization (v1.0). Zenodo. https://doi.org/10.5281/zenodo.20681061
|
|
192
208
|
|
|
209
|
+
|
|
193
210
|
**Software:**
|
|
194
|
-
[](https://doi.org/10.5281/zenodo.20681061)
|
|
212
|
+
|
|
195
213
|
|
|
196
214
|
**Dataset:**
|
|
197
|
-
[](https://doi.org/10.5281/zenodo.20681326)
|
|
198
216
|
|
|
199
217
|
|
|
@@ -17,12 +17,12 @@ We have also extended the code to allow for automatic detection of regions with
|
|
|
17
17
|
|
|
18
18
|
See **[Github](https://github.com/SHEDOOMTC/TrajMapQuick/blob/main/README.md)**
|
|
19
19
|
|
|
20
|
-
|
|
21
20
|
## **Installation**
|
|
21
|
+
|
|
22
|
+
### **From Source**
|
|
22
23
|
```bash
|
|
23
24
|
# Clone the repo
|
|
24
|
-
git clone https://github.com/SHEDOOMTC/TrajMapQuick.git
|
|
25
|
-
cd TrajMapQuick
|
|
25
|
+
git clone https://github.com/SHEDOOMTC/TrajMapQuick.git && cd TrajMapQuick
|
|
26
26
|
|
|
27
27
|
# In conda environment with pip
|
|
28
28
|
conda create -n tmq python=3.10
|
|
@@ -36,31 +36,45 @@ conda activate tmq
|
|
|
36
36
|
|
|
37
37
|
Use tmq --help to see the arguments
|
|
38
38
|
```
|
|
39
|
+
|
|
40
|
+
### **From PyPI**
|
|
41
|
+
```bash
|
|
42
|
+
pip install tmquick
|
|
43
|
+
conda install -c conda-forge mdtraj
|
|
44
|
+
```
|
|
45
|
+
|
|
39
46
|
## **Commands**
|
|
40
47
|
```bash
|
|
41
|
-
#TrajMapQuick uses a
|
|
42
|
-
tmq shift : Extract matrices, compute residue-residue shifts and make plots:
|
|
48
|
+
#TrajMapQuick uses a four levell subcommand from the global "tmq" command
|
|
49
|
+
tmq shift : Extract matrices, compute residue-residue shifts and make plots:
|
|
50
|
+
For more, use tmq shift --help
|
|
43
51
|
|
|
44
|
-
tmq hotspot : Detect hotspots in residue shifts and create plots:
|
|
52
|
+
tmq hotspot : Detect hotspots in residue shifts and create plots:
|
|
53
|
+
For more, use tmq hotspot --help
|
|
45
54
|
|
|
46
|
-
tmq diff
|
|
55
|
+
tmq diff: Computes difference between two matrices and creates
|
|
56
|
+
the difference map: For more, use tmq diff --help
|
|
47
57
|
|
|
48
|
-
tmq average Computes average of n matrices and creates the average map:
|
|
58
|
+
tmq average Computes average of n matrices and creates the average map:
|
|
59
|
+
For more, use tmq average --help
|
|
49
60
|
|
|
50
61
|
```
|
|
51
62
|
## **Usage (CLI)**
|
|
52
63
|
```bash
|
|
53
64
|
# For tmq shift, arguments are passed into the flags for trajectory, topology etc.
|
|
54
65
|
|
|
55
|
-
tmq shift --traj traj.pdb --top top.parmtop --str 1 --resr 1-300
|
|
66
|
+
tmq shift --traj traj.pdb --top top.parmtop --str 1 --resr 1-300 \
|
|
67
|
+
--resrs 110-125 --cent backbone --out shift_output
|
|
56
68
|
|
|
57
|
-
#for tmq hotspot, arguments are passed similiarly,
|
|
69
|
+
#for tmq hotspot, arguments are passed similiarly, the region of shift is not provided
|
|
58
70
|
|
|
59
|
-
tmq hotspot --traj traj.pdb --top top.parmtop --str 1 --resr 1-300
|
|
71
|
+
tmq hotspot --traj traj.pdb --top top.parmtop --str 1 --resr 1-300 \
|
|
72
|
+
--cent backbone --out hotspot_output
|
|
60
73
|
```
|
|
61
74
|
## **Usage (Python API)**
|
|
62
|
-
The core modules in the tmq library are clearly demonstrated in the
|
|
63
|
-
|
|
75
|
+
The core modules in the tmq library are clearly demonstrated in the
|
|
76
|
+
**[Python_API.ipynb](./Notebooks/Python_API.ipynb)** file
|
|
77
|
+
|
|
64
78
|
```python
|
|
65
79
|
#Typical modules are loaded and then used as explained in the jupyter notebook above:
|
|
66
80
|
|
|
@@ -95,7 +109,7 @@ jupyter notebook Python_API.ipynb
|
|
|
95
109
|
All library requirements are pre-installed installed via pip or conda and are available for use in CLI or via Python API
|
|
96
110
|
|
|
97
111
|
## **Examples**
|
|
98
|
-
Three trajectories and topologies files are included in the **[Test](./Test)** directory for users to try out the codes. Trajectory 1 has only 125 frames (from apo strucuture of PDB ID: 8EM8 with 789 residues) while others have 250 frames (from apo and bound strucutres of BACE1, with 389 residues). To get the full sized trajectories, see [** directory for users to try out the codes. Trajectory 1 has only 125 frames (from apo strucuture of PDB ID: 8EM8 with 789 residues) while others have 250 frames (from apo and bound strucutres of BACE1, with 389 residues). To get the full sized trajectories, see [](https://doi.org/10.5281/zenodo.20681326)
|
|
99
113
|
|
|
100
114
|
See the full examples on **[Github](https://github.com/SHEDOOMTC/TrajMapQuick/blob/main/README.md)**
|
|
101
115
|
|
|
@@ -129,9 +143,12 @@ For questions or issues, please contact us @ [Reslar Labs](reslarscience@gmail.c
|
|
|
129
143
|
If you use TrajMapQuick, please cite: SHEDOOMTC. (2026). TrajMapQuick: Towards Fast Trajectory Map Analysis and Visualization (v1.0). Zenodo. https://doi.org/10.5281/zenodo.20681061
|
|
130
144
|
|
|
131
145
|
**Software:**
|
|
132
|
-
[](https://doi.org/10.5281/zenodo.20681061)
|
|
147
|
+
|
|
133
148
|
|
|
134
149
|
**Dataset:**
|
|
135
|
-
[](https://doi.org/10.5281/zenodo.20681326)
|
|
151
|
+
|
|
152
|
+
|
|
136
153
|
|
|
137
154
|
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
Metadata-Version: 2.4
|
|
2
2
|
Name: tmquick
|
|
3
|
-
Version: 1.0.
|
|
3
|
+
Version: 1.0.6
|
|
4
4
|
Summary: TrajMapQuick: Towards Fast Trajectory Map Analysis and Visualization
|
|
5
5
|
Author: Wande M. Oluyemi (PhD), Adeniyi T. Adewumi (PhD), Shadrach C. Eze, Stephen C. Nnemolisa, @ Research Laboratory for Rational Design of Drugs and Biomaterials (ResLaR Labs), Afe Babalola University, Ado-Ekiti Nigeria
|
|
6
6
|
Project-URL: Homepage, https://github.com/SHEDOOMTC/TrajMapQuick.git
|
|
@@ -42,12 +42,12 @@ We have also extended the code to allow for automatic detection of regions with
|
|
|
42
42
|
|
|
43
43
|
See **[Github](https://github.com/SHEDOOMTC/TrajMapQuick/blob/main/README.md)**
|
|
44
44
|
|
|
45
|
-
|
|
46
45
|
## **Installation**
|
|
46
|
+
|
|
47
|
+
### **From Source**
|
|
47
48
|
```bash
|
|
48
49
|
# Clone the repo
|
|
49
|
-
git clone https://github.com/SHEDOOMTC/TrajMapQuick.git
|
|
50
|
-
cd TrajMapQuick
|
|
50
|
+
git clone https://github.com/SHEDOOMTC/TrajMapQuick.git && cd TrajMapQuick
|
|
51
51
|
|
|
52
52
|
# In conda environment with pip
|
|
53
53
|
conda create -n tmq python=3.10
|
|
@@ -61,31 +61,45 @@ conda activate tmq
|
|
|
61
61
|
|
|
62
62
|
Use tmq --help to see the arguments
|
|
63
63
|
```
|
|
64
|
+
|
|
65
|
+
### **From PyPI**
|
|
66
|
+
```bash
|
|
67
|
+
pip install tmquick
|
|
68
|
+
conda install -c conda-forge mdtraj
|
|
69
|
+
```
|
|
70
|
+
|
|
64
71
|
## **Commands**
|
|
65
72
|
```bash
|
|
66
|
-
#TrajMapQuick uses a
|
|
67
|
-
tmq shift : Extract matrices, compute residue-residue shifts and make plots:
|
|
73
|
+
#TrajMapQuick uses a four levell subcommand from the global "tmq" command
|
|
74
|
+
tmq shift : Extract matrices, compute residue-residue shifts and make plots:
|
|
75
|
+
For more, use tmq shift --help
|
|
68
76
|
|
|
69
|
-
tmq hotspot : Detect hotspots in residue shifts and create plots:
|
|
77
|
+
tmq hotspot : Detect hotspots in residue shifts and create plots:
|
|
78
|
+
For more, use tmq hotspot --help
|
|
70
79
|
|
|
71
|
-
tmq diff
|
|
80
|
+
tmq diff: Computes difference between two matrices and creates
|
|
81
|
+
the difference map: For more, use tmq diff --help
|
|
72
82
|
|
|
73
|
-
tmq average Computes average of n matrices and creates the average map:
|
|
83
|
+
tmq average Computes average of n matrices and creates the average map:
|
|
84
|
+
For more, use tmq average --help
|
|
74
85
|
|
|
75
86
|
```
|
|
76
87
|
## **Usage (CLI)**
|
|
77
88
|
```bash
|
|
78
89
|
# For tmq shift, arguments are passed into the flags for trajectory, topology etc.
|
|
79
90
|
|
|
80
|
-
tmq shift --traj traj.pdb --top top.parmtop --str 1 --resr 1-300
|
|
91
|
+
tmq shift --traj traj.pdb --top top.parmtop --str 1 --resr 1-300 \
|
|
92
|
+
--resrs 110-125 --cent backbone --out shift_output
|
|
81
93
|
|
|
82
|
-
#for tmq hotspot, arguments are passed similiarly,
|
|
94
|
+
#for tmq hotspot, arguments are passed similiarly, the region of shift is not provided
|
|
83
95
|
|
|
84
|
-
tmq hotspot --traj traj.pdb --top top.parmtop --str 1 --resr 1-300
|
|
96
|
+
tmq hotspot --traj traj.pdb --top top.parmtop --str 1 --resr 1-300 \
|
|
97
|
+
--cent backbone --out hotspot_output
|
|
85
98
|
```
|
|
86
99
|
## **Usage (Python API)**
|
|
87
|
-
The core modules in the tmq library are clearly demonstrated in the
|
|
88
|
-
|
|
100
|
+
The core modules in the tmq library are clearly demonstrated in the
|
|
101
|
+
**[Python_API.ipynb](./Notebooks/Python_API.ipynb)** file
|
|
102
|
+
|
|
89
103
|
```python
|
|
90
104
|
#Typical modules are loaded and then used as explained in the jupyter notebook above:
|
|
91
105
|
|
|
@@ -120,7 +134,7 @@ jupyter notebook Python_API.ipynb
|
|
|
120
134
|
All library requirements are pre-installed installed via pip or conda and are available for use in CLI or via Python API
|
|
121
135
|
|
|
122
136
|
## **Examples**
|
|
123
|
-
Three trajectories and topologies files are included in the **[Test](./Test)** directory for users to try out the codes. Trajectory 1 has only 125 frames (from apo strucuture of PDB ID: 8EM8 with 789 residues) while others have 250 frames (from apo and bound strucutres of BACE1, with 389 residues). To get the full sized trajectories, see [** directory for users to try out the codes. Trajectory 1 has only 125 frames (from apo strucuture of PDB ID: 8EM8 with 789 residues) while others have 250 frames (from apo and bound strucutres of BACE1, with 389 residues). To get the full sized trajectories, see [](https://doi.org/10.5281/zenodo.20681326)
|
|
124
138
|
|
|
125
139
|
See the full examples on **[Github](https://github.com/SHEDOOMTC/TrajMapQuick/blob/main/README.md)**
|
|
126
140
|
|
|
@@ -154,9 +168,12 @@ For questions or issues, please contact us @ [Reslar Labs](reslarscience@gmail.c
|
|
|
154
168
|
If you use TrajMapQuick, please cite: SHEDOOMTC. (2026). TrajMapQuick: Towards Fast Trajectory Map Analysis and Visualization (v1.0). Zenodo. https://doi.org/10.5281/zenodo.20681061
|
|
155
169
|
|
|
156
170
|
**Software:**
|
|
157
|
-
[](https://doi.org/10.5281/zenodo.20681061)
|
|
172
|
+
|
|
158
173
|
|
|
159
174
|
**Dataset:**
|
|
160
|
-
[](https://doi.org/10.5281/zenodo.20681326)
|
|
176
|
+
|
|
177
|
+
|
|
161
178
|
|
|
162
179
|
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|