YOLO Microbiome Analysis System
Project description
YaMAS (YOLO Microbiome Analysis System)
YaMAS is a package designed to easily download DNA datasets from the NCBI SRA website. It is developed by the YOLO lab team, and is designed to be simple, efficient, and easy to use for non-programmers.
Dependencies
Before proceeding with the installation and execution of YaMAS, please ensure that you have a clean environment set up on your system, with all dependencies installed. To create one, follow the steps below:
- Get YaMAS readyכ.
- Create a new qiime2 environment using conda. Make sure you name it 'qiime2'.
- Download the SRA-toolkit and Entrez packages to the environment.
- Download the metaphlan package. Make sure the database works properly before proceeding.
- Exporting a 16S project requires a downloaded classifier file.
You are now ready to run and install YaMAS in the newly created and activated qiime2 environment.
Installation
To install YaMAS, you can use pip:
pip install YMS
Getting Started
YaMAS provides an easy-to-use interface in the terminal.
To download a project, use the one of the following templates:
Get YaMAS ready
yamas --ready <operating_system_type>
Arguments:
- operating_system_type: Ubuntu/CentOS
Pay attention to the output of the command.
If the environment is ready, you will need to run one more command.
If not, follow the output guidelines.
16S/18S dataset
yamas --download PRJEB01234 --type 16S/18S
To export an OTU (Operational Taxonomic Unit), taxonomy, and phylogeny tree for a single project, use the following command:
yamas --export <project_path> <data_type> <start> <end> <classifier_file> <threads>
Arguments:
- project_path: path to the project directory (created by YaMAS in the previous step).
- data_type: choose one of the following types: 16S / 18S
- classifier_file: path to the trained classifier file.
- start & end: choose graph edges.
- threads: specifies the number of threads to use for parallel processing, which can speed up the export process (default is 12).
Shotgun dataset
yamas --download PRJEB01234 --type Shotgun
Continue data downloading
Continue downloading project after downloading SRA before converting to .fastq.
Use the following command:
yamas --continue_from_fastq <dataset_id> <project_path> <data_type>
Arguments:
- project_path: path to the project directory (created by YaMAS, if you started downloading data in the past).
- data_type: choose one of the following types: 16S / 18S / Shotgun
Continue downloading project after downloading SRA and converting them to .fastq.
Use the following command:
yamas --continue_from <dataset_id> <project_path> <data_type>
Arguments:
- project_path: path to the project directory (created by YaMAS, if you started downloading data in the past).
- data_type: choose one of the following types: 16S / 18S / Shotgun
Other arguments and configurations
- config: You can add a configuration file in order to save the data in a different folder, and change other configurations.
- verbose: To get more information about a downloading process, use the verbose option (this is highly recommended).
- Listing more than one project will download them one by one into different folders.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.