Skip to content
GitLab
Explore
Sign in
Primary navigation
Search or go to…
Project
PyFastANI
Manage
Activity
Members
Labels
Plan
Issues
Issue boards
Milestones
Wiki
Code
Merge requests
Repository
Branches
Commits
Tags
Repository graph
Compare revisions
Build
Pipelines
Jobs
Pipeline schedules
Artifacts
Deploy
Releases
Package Registry
Container Registry
Model registry
Operate
Environments
Terraform modules
Monitor
Incidents
Service Desk
Analyze
Value stream analytics
Contributor analytics
CI/CD analytics
Repository analytics
Model experiments
Help
Help
Support
GitLab documentation
Compare GitLab plans
Community forum
Contribute to GitLab
Provide feedback
Keyboard shortcuts
?
Snippets
Groups
Projects
Show more breadcrumbs
Martin Larralde
PyFastANI
Commits
0914f3ca
Commit
0914f3ca
authored
2 years ago
by
Martin Larralde
Browse files
Options
Downloads
Patches
Plain Diff
Fix badges and text in Sphinx documentation [ci skip]
parent
7bd2e9da
No related branches found
Branches containing commit
No related tags found
Tags containing commit
No related merge requests found
Changes
2
Hide whitespace changes
Inline
Side-by-side
Showing
2 changed files
docs/index.rst
+24
-19
24 additions, 19 deletions
docs/index.rst
docs/install.rst
+14
-14
14 additions, 14 deletions
docs/install.rst
with
38 additions
and
33 deletions
docs/index.rst
+
24
−
19
View file @
0914f3ca
...
...
@@ -4,15 +4,15 @@ PyFastANI |Stars|
.. |Stars| image:: https://img.shields.io/github/stars/althonos/pyfastani.svg?style=social&maxAge=3600&label=Star
:target: https://github.com/althonos/pyfastani/stargazers
`Cython <https://cython.org/>`_ *bindings and Python interface to* `
trimAl
<
h
ttp://
trimal.cgenomics.org
/>`_,
*a
tool for automated alignment trimming
.*
`Cython <https://cython.org/>`_ *bindings and Python interface to* `
FastANI
<ttp
s
://
github.com/ParBLiSS/FastANI
/>`_,
*a
method for fast whole-genome similarity estimation
.*
|Actions| |Coverage| |PyPI| |Bioconda| |AUR| |Wheel| |Versions| |Implementations| |License| |Source| |Mirror| |Issues| |Docs| |Changelog| |Downloads|
.. |Actions| image:: https://img.shields.io/github/workflow/status/althonos/pyfastani/Test/main?logo=github&style=flat-square&maxAge=300
:target: https://github.com/althonos/pyfastani/actions
.. |Coverage| image:: https://img.shields.io/codecov/c/gh/althonos/pyfastani?style=flat-square&maxAge=600
.. |Coverage| image:: https://img.shields.io/codecov/c/gh/althonos/pyfastani
/branch/main.svg
?style=flat-square&maxAge=600
:target: https://codecov.io/gh/althonos/pyfastani/
.. |PyPI| image:: https://img.shields.io/pypi/v/pyfastani.svg?style=flat-square&maxAge=3600
...
...
@@ -58,22 +58,27 @@ PyFastANI |Stars|
Overview
--------
PytrimAl is a Python module that provides bindings to trimAl using
`Cython <https://cython.org/>`_. It directly interacts with the trimAl
internals, which has the following advantages:
- **single dependency**: PytrimAl is distributed as a Python package, so you
can add it as a dependency to your project, and stop worrying about the
trimAl binary being present on the end-user machine.
- **no intermediate files**: Everything happens in memory, in a Python object
you control, so you don't have to invoke the trimAl CLI using a
sub-process and temporary files. `Alignment` objects can be created
directly from Python code.
- **friendly interface**: The different trimming methods are implement as
Python classes that can be configured independently.
- **error management**: Errors occuring in trimAl are converted
transparently into Python exceptions, including an informative
error message.
FastANI is a method published in 2018 by Jain *et al.* for high-throughput
computation of whole-genome `Average Nucleotide Identity (ANI) <https://img.jgi.doe.gov/docs/ANI.pdf>`_.
It uses `MashMap <https://github.com/marbl/MashMap>`_ to compute orthologous mappings
without the need for expensive alignments.
``pyfastani`` is a Python module, implemented using the `Cython <https://cython.org/>`_
language, that provides bindings to FastANI. It directly interacts with the
FastANI internals, which has the following advantages over CLI wrappers:
- **simpler compilation**: FastANI requires several additional libraries,
which make compilation of the original binary non-trivial. In PyFastANI,
libraries that were needed for threading or I/O are provided as stubs,
and `Boost::math` headers are vendored so you can build the package without
hassle. Or even better, just install from one of the provided wheels!
- **single dependency**: If your software or your analysis pipeline is
distributed as a Python package, you can add `pyfastani` as a dependency to
your project, and stop worrying about the FastANI binary being present on
the end-user machine.
- **sans I/O**: Everything happens in memory, in Python objects you control,
making it easier to pass your sequences to FastANI
without needing to write them to a temporary file.
Setup
...
...
This diff is collapsed.
Click to expand it.
docs/install.rst
+
14
−
14
View file @
0914f3ca
...
...
@@ -33,20 +33,20 @@ one is available, or from source after compiling the Cython code :
..
.. $ conda install -c bioconda pyfastani
..
..
..
Arch User Repository
..
^^^^^^^^^^^^^^^^^^^^
..
..
A package recipe for Arch Linux can be found in the Arch User Repository
..
under the name `python-pyfastani <https://aur.archlinux.org/packages/python-pyfastani>`_.
..
It will always match the latest release from PyPI.
..
..
Steps to install on ArchLinux depend on your `AUR helper <https://wiki.archlinux.org/title/AUR_helpers>`_
..
(``yaourt``, ``aura``, ``yay``, etc.). For ``aura``, you'll need to run:
..
..
.. code:: console
..
..
$ aura -A python-pyfastani
Arch User Repository
^^^^^^^^^^^^^^^^^^^^
A package recipe for Arch Linux can be found in the Arch User Repository
under the name `python-pyfastani <https://aur.archlinux.org/packages/python-pyfastani>`_.
It will always match the latest release from PyPI.
Steps to install on ArchLinux depend on your `AUR helper <https://wiki.archlinux.org/title/AUR_helpers>`_
(``yaourt``, ``aura``, ``yay``, etc.). For ``aura``, you'll need to run:
.. code:: console
$ aura -A python-pyfastani
GitHub + ``pip``
...
...
This diff is collapsed.
Click to expand it.
Preview
0%
Loading
Try again
or
attach a new file
.
Cancel
You are about to add
0
people
to the discussion. Proceed with caution.
Finish editing this message first!
Save comment
Cancel
Please
register
or
sign in
to comment