######### odgi position #########
Find, translate, and liftover graph and path positions between graphs. Results are printed to stdout.
odgi position [-i, --target=FILE] [OPTION]…
The odgi position command translates positions and coordinate ranges between nodes and embedded paths. It provides liftover functionality, allowing us to translate a position between any reference paths embedded in the -i, --target
graph. We can additionally project coordinates and annotations from a source graph -x, --source
into the target
. When completing this “graph lift”, the intersecting set of paths in the two graphs are used to complete the coordinate projection.
MANDATORY OPTIONS --------------
-i, --target=FILE
Load the succinct variation graph in ODGI format from this FILE. The file name usually ends with .og. It also accepts GFAv1, but the on-the-fly conversion to the ODGI format requires additional time!
Load the succinct variation graph in ODGI format from this FILE. The file name usually ends with .og. It also accepts GFAv1, but the on-the-fly conversion to the ODGI format requires additional time!
-x, --source=FILE
Translate positions from this FILE graph into the target graph using common -l, --lift-paths shared between both graphs (default: use the same source/target graph). It also accepts GFAv1, but the on-the-fly conversion to the ODGI format requires additional time!
Translate positions from this FILE graph into the target graph using common -l, --lift-paths shared between both graphs (default: use the same source/target graph). It also accepts GFAv1, but the on-the-fly conversion to the ODGI format requires additional time!
-r, --ref-path=STRING
Translate the given positions into positions relative to this reference path STRING.
Translate the given positions into positions relative to this reference path STRING.
-R, --ref-paths=FILE
Use the ref-paths in FILE for positional translation.
Use the ref-paths in FILE for positional translation.
-l, --lift-path=STRING
Lift positions from -x, --source to -i, --target via coordinates in this path common to both graphs (default: all common paths between -x, --source and -i, --target).
Lift positions from -x, --source to -i, --target via coordinates in this path common to both graphs (default: all common paths between -x, --source and -i, --target).
-L, --lift-paths=FILE
Same as in -l, --lift-paths, but for all paths in FILE.
Same as in -l, --lift-paths, but for all paths in FILE.
-g, --graph-pos=[[node_id][,offset[,(+|-)]]]
A graph position, e.g. 42,10,+ or 302,0,-.
A graph position, e.g. 42,10,+ or 302,0,-.
-G, --graph-pos-file=FILE
Same as in -g, --graph-pos, but for all graph positions in FILE.
Same as in -g, --graph-pos, but for all graph positions in FILE.
-p, --path-pos=[path_name][,offset[,(+|-)]]**
A path position, e.g. chr8,1337,+ or chrZ,3929,-.
A path position, e.g. chr8,1337,+ or chrZ,3929,-.
-F, --path-pos-file=FILE
A FILE with one path position per line.
A FILE with one path position per line.
-b, --bed-input=FILE
A BED file of ranges in paths in the graph to lift into the target graph -v, --give-graph-pos emit graph positions.
A BED file of ranges in paths in the graph to lift into the target graph -v, --give-graph-pos emit graph positions.
-E, --gff-input=FILE
A GFF/GTF file with annotation of ranges in paths in the graph to lift into the target (sub)graph emitting graph identifiers with annotation. The output is a CSV reading for the visualization within Bandage. The first column is the node identifier, the second column the annotation. If several annotations exist for the same node, they are combined via ';'.
A GFF/GTF file with annotation of ranges in paths in the graph to lift into the target (sub)graph emitting graph identifiers with annotation. The output is a CSV reading for the visualization within Bandage. The first column is the node identifier, the second column the annotation. If several annotations exist for the same node, they are combined via ';'.
-v, --give-graph-pos
Emit graph positions (node, offset, strand) rather than path positions.
Emit graph positions (node, offset, strand) rather than path positions.
-I, --all-immediate
Emit all positions immediately at the given graph/path position.
Emit all positions immediately at the given graph/path position.
-d, --search-radius=DISTANCE
Limit coordinate conversion breadth-first search up to DISTANCE bp from each given position (default: 10000).
Limit coordinate conversion breadth-first search up to DISTANCE bp from each given position (default: 10000).
-w, --jaccard-context=N
Maximum walking distance in nucleotides for one orientation when finding the best target (reference) range for each query path (default: 10000). Note: If we walked 9999 base pairs and w, --jaccard-context is 10000, we will also include the next node, even if we overflow the actual limit.
Maximum walking distance in nucleotides for one orientation when finding the best target (reference) range for each query path (default: 10000). Note: If we walked 9999 base pairs and w, --jaccard-context is 10000, we will also include the next node, even if we overflow the actual limit.
-t, --threads=N
Number of threads to use for parallel operations.
Number of threads to use for parallel operations.
-P, --progress
Print information about the operations and the progress to stderr.
Print information about the operations and the progress to stderr.
-h, --help
Print a help message for odgi position.
Print a help message for odgi position.