Finding generalized nodes

Basic syntax

panbiotracks -m N -i INPUT_FILE_1 INPUT_FILE_2 INPUT_FILE_n -o OUTPUT_FILE

Where the -m N flag sets the program to search for nodes; INPUT_FILE_1 INPUT_FILE_2 INPUT_FILE_n are the IGT SHP files used to obtain the nodes; and OUTPUT_FILE is the name of the file where the nodes will be saved, without file extension.

Detailed instructions

The basic general method to run the program is the same as the one described for the individual tracks and IGTs.

Input files

The input files are indicated after the -i flag, and are a set of two or more GT or IGT SHP files, separated by spaces. You must type the full or relative path of each one, with their corresponding file extension. For example, assuming there are three IGT files named gt_quercus_1.shp, gt_quercus_2.shp and gt_quercus_3shp saved in the "gt" directory within a directory named "results", in the Downloads folder, the syntax will be

.\panbiotracks.exe -m P -i C:\Users\YOUR_USER\Downloads\results\gt\quercus_1.shp C:\Users\YOUR_USER\Downloads\results\gt\quercus_2.shp C:\Users\YOUR_USER\Downloads\results\gt\quercus_3.shp -o OUTPUT_FILE

if you're on Windows, or

./panbiotracks -m P -i /home/YOUR_USER/Downloads/results/gt/quercus_1.shp /home/YOUR_USER/Downloads/results/gt/quercus_2.shp /home/YOUR_USER/Downloads/results/gt/quercus_3.shp -o OUTPUT_FILE

if you're on Linux. Note that if there are spaces within the file or path names, you must enclose the path with apostrophes (') or double quotes (").

Notes about the input files

The input files need to be in the SHP format, or Panbiotracks will output an error. Also, Panbiotracks has been tested only with SHP files generated by itself, so if you use files generated by other application it might lead to errors or inaccurate results. If you want to use these files and encounter an error, feel free to tell me by opening an issue.

Output file name

The name of the file where the nodes will be saved goes after the -o flag. The name of the file does not need to have a file extension. Using the same examples as above, to save the nodes to a file named gn_quercus.shp into a directory named "gn" within the "results" folder, the syntax for the flag will be

-o C:\Users\YOUR_USER\Downloads\results\gn\gn_quercus

on Windows, or

-o /home/YOUR_USER/Downloads/results/gn/gn_quercus

on Linux.

Notes about the output files

As with the individual tracks, Panbiotracks will save three separate files containing the data of the nodes. If you want to rename or move your results, you'll need to do so for all of the generated files.