TNT_Script/README.md

100 lines
2.3 KiB
Markdown
Raw Normal View History

2023-02-26 02:42:56 +08:00
# TNT Script used by Guoyi
The TNT script follows MIT and part of script is from setk.run belonging to Salvador Arias (Instituto Miguel Lillo, San Miguel de Tucumán, Argentina).
2023-02-26 02:42:56 +08:00
2023-02-26 03:32:18 +08:00
## Usage
2023-02-26 02:42:56 +08:00
2023-02-27 01:42:50 +08:00
- Place this script and your matrix tnt file `filename` under the folder that you call `tnt` or `exe` file is placed
2023-02-26 03:45:29 +08:00
2023-02-27 01:24:22 +08:00
- Enter `tnt`
2023-02-26 03:32:18 +08:00
2023-02-27 01:24:22 +08:00
- Enter command `guoyi filename;`
2023-02-26 03:32:18 +08:00
2023-02-27 01:24:22 +08:00
## Functions
2023-02-26 03:32:18 +08:00
2023-02-27 01:45:00 +08:00
- Estimate implied weighting K value.
2023-02-26 03:45:29 +08:00
2023-07-17 06:31:26 +08:00
- Search trees via TBR Mult (1000 times) and Xmult (use random sectorial searches, produce 1,000 hits to best length and stop, 10 cycles of drifting, ratchet and fusing).
2023-02-26 03:45:29 +08:00
2023-02-27 01:24:22 +08:00
- Perform Strict consensus.
2023-07-17 06:31:26 +08:00
- Calculate Relative Bremer support, jackknifing (1,000 times), and bootstrap (1,000 times).
2023-02-27 01:24:22 +08:00
- Map apomorphic characters on the consensus tree.
2023-02-27 01:24:22 +08:00
- Calculate TL, CI, and RI.
2023-02-26 03:45:29 +08:00
2023-02-26 03:32:18 +08:00
## Options
2023-02-26 02:42:56 +08:00
2023-02-27 01:24:22 +08:00
- Results instructions are at the end of `tnt.log`.
- `trees.tre`, `resample.tre` are trees with taxname.
2023-02-27 01:37:48 +08:00
- `trees_no.tre`, `resample_no.tre` are trees without taxname.
2023-02-26 02:42:56 +08:00
2023-02-27 01:24:22 +08:00
- `nelsen` can be replaced by `majority`.
2023-02-26 02:42:56 +08:00
2023-02-27 01:24:22 +08:00
- `xmult` and `mult` replications and hold trees number can be adjusted.
2023-02-26 02:42:56 +08:00
- `winclada.tre` can be transferred to the acceptable format for WinClada by tnt2winclada and the output file can be put into Winclada with your tnt matrix file `filename` for mapping apomorphic characters and homoplasy.
2023-07-17 06:31:26 +08:00
## Cite
Cite this script is mandatory, list me (Guoyi Zhang) in your Acknowledgements is recommended.
# TNT2WinClada
```
~|~|\ |~|~ ~) | |o._ |~| _ _| _
| | \| | /_ \/\/ || ||_|(_|(_|(_|
MIT, Guoyi Zhang, 2023
```
## Function
Convert TNT output tree file without tags and taxname, e.g. `winclada.tre` produced by TNT script, to WinClada acceptable format tree.
## Compile
### Linux & Unix
```
2023-07-18 16:42:35 +08:00
mkdir -p build && cd build
cmake ..
make && make install
```
### Windows
```
cl /EHsc tnt2winclada.cpp
```
## Usage
```
tnt2winclada -i ${input_file} -o ${output_file}
```
2023-07-17 06:31:26 +08:00
Interactive commands are also available.
2023-07-18 16:42:35 +08:00
```
tnt2winclada
~|~|\ |~|~ ~) | |o._ |~| _ _| _
| | \| | /_ \/\/ || ||_|(_|(_|(_|
TNT2WinClada
MIT, Guoyi Zhang, 2023
please type help to see more commands
tnt2winclada> help
help show interactive commands help
input <filename> input a TNT output tree from the specified file
output <filename> output a winclada accessible tree file
quit quit the program
exit exit the program
tnt2winclada>
```