BLAST Oriented to the Identification of SIDER Elements
1.2K
BLASTOISE is a Python-based software tool engineered to automate the identification of SIDER (Short Interspersed Degenerated Retroposon) elements within the genomes of Leishmania spp. species. The inherent heterogeneity and degeneration of these retroposons present considerable identification challenges, which BLASTOISE is designed to overcome.
The software is distributed through several channels:
The BLASTOISE Docker image is built on a Linux base, but thanks to Docker's containerization technology, it runs seamlessly on any major operating system, including Windows, macOS, and Linux.
All you need is Docker Desktop (for Windows and Mac) or Docker Engine (for Linux) installed on your system. The web interface is accessed through your local web browser, providing a consistent experience regardless of your OS.
The BLASTOISE Docker image comes with a comprehensive web application, powered by the FastAPI framework, that provides an intuitive graphical user interface for interactive analysis. This is the recommended way to use BLASTOISE with Docker.
Using Docker is the recommended approach as it runs on Windows, macOS, and Linux, simplifying dependency management and ensuring a consistent runtime environment.
For users on Windows and macOS, the simplest way to get the image is by using the Docker Desktop graphical interface:
rfpacheco/blastoise in
the search bar.On any platform (including Linux), you can use the command line.
:latest tag for the
most recent version or a specific version tag for reproducibility.# Pull the latest version
docker pull rfpacheco/blastoise:latest
# Or, pull a specific version (e.g., 0.4.3)
docker pull rfpacheco/blastoise:0.4.3
Once the image is pulled, you can run the container to start the web application.
rfpacheco/blastoise image, and click
the "Run" button.8000. This maps the container's port 8000
to your local machine's port 8000.http://localhost:8000 in a web browser.Run the Container: Execute the following command to start the container and the web server. The -p 8000:8000
flag maps the container's internal port to the host machine.
docker run --rm -p 8000:8000 rfpacheco/blastoise:latest
Access the Web Interface: Navigate to http://localhost:8000 in a web browser.
Once running, you can:
It is also possible to execute CLI commands directly via Docker by overriding the container's default command. This
procedure requires mounting local data directories into the container's filesystem using the -v flag.
blastoise (Main Discovery Tool) Example:
# Example: Execute the main 'blastoise' tool via Docker
docker run --rm \
-v /path/to/your_data:/app/data \
-v /path/to/your_output:/app/output \
rfpacheco/blastoise:latest \
blastoise -d /app/data/query.fasta -g /app/data/genome.fasta -o /app/output/my_results
blastoise-sider-filter (Validation Tool) Example:
docker run --rm \
-v /path/to/your_data:/app/data \
-v /path/to/your_output:/app/output \
rfpacheco/blastoise:latest \
blastoise-sider-filter -d /app/data/candidates.csv -g /app/data/genome.fasta -rf /app/data/query.fasta
Note on Paths: When using the CLI with Docker, all paths for input and output arguments (
-d,-g,-o,-rf, etc.) must correspond to the paths inside the container (e.g.,/app/data,/app/output).
All necessary dependencies (Python, BLAST, and required libraries) are pre-installed in the Docker image. No further installation is required on the user's part.
BLASTOISE is open-source software distributed under the terms of the MIT License.
Should you use BLASTOISE in your research, we kindly request that you cite the following publication:
@software{Pacheco_BLASTOISE_2025,
author = {Pacheco, R.},
title = {{BLASTOISE: BLAST Oriented to the Identification of SIDER Elements}},
year = {2025},
publisher = {GitHub},
journal = {GitHub repository},
url = {https://github.com/rfpacheco/BLASTOISE}
}
For inquiries, bug reports, or contributions, please use the following channels:
Content type
Image
Digest
sha256:13cebc465…
Size
1.3 GB
Last updated
9 months ago
docker pull rfpacheco/blastoise