Before running DICAST, please take some time to configure it for your first run.
DICAST is best run with the GUI, which automates the configuration of scripts/snakemake/snakemake_config.yaml, scripts/config.sh & scripts/asevent_config.sh, for a quick run of DICAST without simulated data, on your experiments.
DICAST can be run via CLI, however, this feature is currently in development.
If you’d like to modify the Simulated dataset, please modify scripts/ASimulatoR_config.R (See ASimulatoR Parameters)
If you’d like to run DICAST with just one tool via docker, then the files you need to modify are: scripts/config.sh, scripts/asevent_config.sh
It’s recommended to take a closer look at the config files on disk before your first run.
- The following files are all the configuration files found in DICAST:
- scripts/snakemake/snakemake_config.yaml,scripts/ASimulatoR_config.R,scripts/config.sh &scripts/asevent_config.sh.
Read the full reference here
Most frequent changes to configurations:
The following explanations assume that you use our directory structure as described in Directory Structure.
The following are the snakemake parameters that you’re most likely to change for a CLI run:.
- do: falsechange to true. This is set to false after every run to prevent overwriting of output files
- What_tools_to_run: ‘<insert name of mapping tools to run, separated by spaces>’pick one of the following bbmap contextmap crac dart gsnap hisat mapsplice minimap segemehl star subjuncExample: to some two tools: ‘minimap star’Example: to run all tools: ‘bbmap contextmap crac dart gsnap hisat mapsplice minimap segemehl star subjunc’Example: to run one tool: ‘star’
- What_tools_to_run: ‘<insert name of Alternative Splicing tools to run, separated by spaces>’pick one of the following asgal aspli eventpointer irfinder majiq sgseq spladder whippetExample: to run all tools: ‘asgal aspli eventpointer irfinder majiq sgseq spladder whippet’Example: to some two tools: ‘eventpointer whippet’Example: to run one tool: ‘whippet’
The following are basic parameters that you are most likely to change on the GUI and in the file scipts/config.sh.
Since these files are bash scripts, it is important to mind the syntax rules. E.g., there can’t be a whitespace before and after “=”.
- if you want to use more cores for each tool within snakemake. (not the same as total cores available for snakemake
- the genome gtf annotation that you use to simulate the data. Default: ‘Homo_sapiens.GRCh38.105.gtf’.
- the genome reference file. Default: ‘Homo_sapiens.GRCh38.dna.primary_assembly.fa’.
- the genome gtf annotation that you use for mapping and alternative splicing analysis. If you’re using ASimulatoR, leave this as ASimulatoR.gtf.
- the genome gff3 annotation that you use for mapping and alternative splicing analysis. If you’re using ASimulatoR, leave this as ASimulatoR.gff3.
The reference genome, annotation file and gff3 files could be downloaded from Ensembl.