annotate README.md @ 1:0d8128a8623e draft default tip

planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/main/tools/syri commit cb48fa8b0d1a3e4e2483b4b0ecea6011d4f71200
author iuc
date Mon, 28 Apr 2025 07:17:49 +0000
parents 27a56ecc88ee
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
0
27a56ecc88ee planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/main/tools/syri commit 85ece544d9a93ca2523c1ed44036b4cf7a4cfd57
iuc
parents:
diff changeset
1 # SyRI Galaxy wrapper
27a56ecc88ee planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/main/tools/syri commit 85ece544d9a93ca2523c1ed44036b4cf7a4cfd57
iuc
parents:
diff changeset
2
27a56ecc88ee planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/main/tools/syri commit 85ece544d9a93ca2523c1ed44036b4cf7a4cfd57
iuc
parents:
diff changeset
3 Galaxy tool wrapper for [SyRI](https://github.com/schneebergerlab/syri): Synteny and Rearrangement Identifier. Syri compares alignments between two chromosome-level assemblies and identifies synteny and structural rearrangements.
27a56ecc88ee planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/main/tools/syri commit 85ece544d9a93ca2523c1ed44036b4cf7a4cfd57
iuc
parents:
diff changeset
4
27a56ecc88ee planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/main/tools/syri commit 85ece544d9a93ca2523c1ed44036b4cf7a4cfd57
iuc
parents:
diff changeset
5 ## Minimap2 Galaxy Wrapper Compatibility
27a56ecc88ee planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/main/tools/syri commit 85ece544d9a93ca2523c1ed44036b4cf7a4cfd57
iuc
parents:
diff changeset
6
27a56ecc88ee planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/main/tools/syri commit 85ece544d9a93ca2523c1ed44036b4cf7a4cfd57
iuc
parents:
diff changeset
7 * When using minimap2 for generating alignments for syri, the minimum required Galaxy wrapper version is `2.28+galaxy1`
27a56ecc88ee planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/main/tools/syri commit 85ece544d9a93ca2523c1ed44036b4cf7a4cfd57
iuc
parents:
diff changeset
8 * This version correctly adds the `--eqx` flag, which is required by SyRI to interpret alignment CIGAR strings
27a56ecc88ee planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/main/tools/syri commit 85ece544d9a93ca2523c1ed44036b4cf7a4cfd57
iuc
parents:
diff changeset
9
27a56ecc88ee planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/main/tools/syri commit 85ece544d9a93ca2523c1ed44036b4cf7a4cfd57
iuc
parents:
diff changeset
10 ## Accepted Alignment Inputs
27a56ecc88ee planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/main/tools/syri commit 85ece544d9a93ca2523c1ed44036b4cf7a4cfd57
iuc
parents:
diff changeset
11
27a56ecc88ee planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/main/tools/syri commit 85ece544d9a93ca2523c1ed44036b4cf7a4cfd57
iuc
parents:
diff changeset
12 * For now alignments in `bam`, `sam` and `paf` are available as inputs
27a56ecc88ee planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/main/tools/syri commit 85ece544d9a93ca2523c1ed44036b4cf7a4cfd57
iuc
parents:
diff changeset
13 * Delta file from mummer is currently not accepted
27a56ecc88ee planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/main/tools/syri commit 85ece544d9a93ca2523c1ed44036b4cf7a4cfd57
iuc
parents:
diff changeset
14
27a56ecc88ee planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/main/tools/syri commit 85ece544d9a93ca2523c1ed44036b4cf7a4cfd57
iuc
parents:
diff changeset
15 ## Sample name in output vcf
27a56ecc88ee planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/main/tools/syri commit 85ece544d9a93ca2523c1ed44036b4cf7a4cfd57
iuc
parents:
diff changeset
16
27a56ecc88ee planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/main/tools/syri commit 85ece544d9a93ca2523c1ed44036b4cf7a4cfd57
iuc
parents:
diff changeset
17 * Users can add a sample name to add to output vcf. This is checked by regex
27a56ecc88ee planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/main/tools/syri commit 85ece544d9a93ca2523c1ed44036b4cf7a4cfd57
iuc
parents:
diff changeset
18
27a56ecc88ee planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/main/tools/syri commit 85ece544d9a93ca2523c1ed44036b4cf7a4cfd57
iuc
parents:
diff changeset
19 ```
27a56ecc88ee planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/main/tools/syri commit 85ece544d9a93ca2523c1ed44036b4cf7a4cfd57
iuc
parents:
diff changeset
20 <param argument="--samplename" name="sample_name" type="text" label="Sample name for the output VCF file. (default: sample)" optional="true">
27a56ecc88ee planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/main/tools/syri commit 85ece544d9a93ca2523c1ed44036b4cf7a4cfd57
iuc
parents:
diff changeset
21 <validator type="regex" message="Invalid characters in sample name">^[a-zA-Z0-9\-_]+$</validator>
27a56ecc88ee planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/main/tools/syri commit 85ece544d9a93ca2523c1ed44036b4cf7a4cfd57
iuc
parents:
diff changeset
22 </param>
27a56ecc88ee planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/main/tools/syri commit 85ece544d9a93ca2523c1ed44036b4cf7a4cfd57
iuc
parents:
diff changeset
23 ```
27a56ecc88ee planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/main/tools/syri commit 85ece544d9a93ca2523c1ed44036b4cf7a4cfd57
iuc
parents:
diff changeset
24
27a56ecc88ee planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/main/tools/syri commit 85ece544d9a93ca2523c1ed44036b4cf7a4cfd57
iuc
parents:
diff changeset
25 ## Empty Map IDs Output — Not an Error
27a56ecc88ee planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/main/tools/syri commit 85ece544d9a93ca2523c1ed44036b4cf7a4cfd57
iuc
parents:
diff changeset
26
27a56ecc88ee planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/main/tools/syri commit 85ece544d9a93ca2523c1ed44036b4cf7a4cfd57
iuc
parents:
diff changeset
27 * The output **Map IDs file** lists corresponding chromosomes between the reference and query genomes
27a56ecc88ee planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/main/tools/syri commit 85ece544d9a93ca2523c1ed44036b4cf7a4cfd57
iuc
parents:
diff changeset
28 * SyRI only generates the output when the chromosome names differ between the two genomes.
27a56ecc88ee planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/main/tools/syri commit 85ece544d9a93ca2523c1ed44036b4cf7a4cfd57
iuc
parents:
diff changeset
29 * If the chromosome names are identical, the file will be **absent or empty** — this is expected and not an error.
27a56ecc88ee planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/main/tools/syri commit 85ece544d9a93ca2523c1ed44036b4cf7a4cfd57
iuc
parents:
diff changeset
30
27a56ecc88ee planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/main/tools/syri commit 85ece544d9a93ca2523c1ed44036b4cf7a4cfd57
iuc
parents:
diff changeset
31 ## Exit codes
27a56ecc88ee planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/main/tools/syri commit 85ece544d9a93ca2523c1ed44036b4cf7a4cfd57
iuc
parents:
diff changeset
32
27a56ecc88ee planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/main/tools/syri commit 85ece544d9a93ca2523c1ed44036b4cf7a4cfd57
iuc
parents:
diff changeset
33 * Any non zero
27a56ecc88ee planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/main/tools/syri commit 85ece544d9a93ca2523c1ed44036b4cf7a4cfd57
iuc
parents:
diff changeset
34 * Regex pattern `- ERROR -` in stderr/stdout