yejg2017 / pbbioconda

PacBio Secondary Analysis Tools on Bioconda

PacBio Secondary Analysis Tools on Bioconda

---

Information

PacBio® tools distributed via Bioconda are: pre-release versions, not necessarily ISO compliant, intended for Research Use Only and not for use in diagnostic procedures, intended only for command-line users, and possibly newer than the currently available SMRT® Analysis builds. While efforts have been made to ensure that releases on Bioconda live up to the quality that PacBio strives for, we make no warranty regarding any Bioconda release.

Support

As PacBio tools distributed via Bioconda are not covered by any service level agreement or the like, please do not contact a PacBio Field Applications Scientist or PacBio Customer Service for assistance with any Bioconda release. We instead provide an issue tracker for you to report issues to us at: https://github.com/PacificBiosciences/pbbioconda. We make no warranty that any such issue will be addressed, to any extent or within any time frame.

Official tech support is only provided for official and stable SMRT Link releases provided by PacBio.

No support via mail to developers.

For issues with the installation of conda or adding the bioconda channel, please refer to the official bioconda website.

For issues with installed PacBio binaries through bioconda, please create a new issue! Our developers will triage your problems internally and reply as soon as possible.

Installation

Information how to install conda and add the bioconda channel is available on https://bioconda.github.io/. Please verify that you have set up conda channel priorities according to set up conda channels. We strongly recommend you use Miniconda with the Python 2.7 backend, as PacBio packages are not Python 3 compatible yet.

Packages can be installed using following command:

> conda install -c bioconda package_name

Packages can be updated with:

> conda update package_name

In general, because conda only performs the smallest set of updates in order to satisfy the dependency graph, it is strongly advised to always update the environment as a whole afterwards:

> conda update --all

In order to avoid stale dependencies in the dependency graph.

Availability

Notes:

• Python packages require version 2.7; Python 3 is currently not supported! You cannot install PacBio packages alongside python 3-only packages in the same environment! In order to use python 3-only packages, create a separate conda env.
• BAM refers to the PacBio BAM format that includes additional per-record or per-ZMW information
• Packages might conflict with other bioconda packages not maintained by PacBio

Packages

Package	Linux	Mac	Description
bam2fastx	Y	Y	Convert and split BAM files into fasta.gz and fastq.gz
bax2bam	Y	Y	Convert legacy PacBio Bax.H5, Bas.H5, and Ccs.H5 files to BAM
blasr	Y	Y	The long read aligner
genomicconsensus	Y	Y	Polish genome assemblies. Attention: deprecated and replaced by gcpp
isoseq3	Y	-	Scalable de novo isoform discovery (Release Notes)
lima	Y	-	Demultiplex barcoded samples (Release Notes)
minorseq	Y	-	Minor Variant Calling and Phasing Tools
pbbam	Y	Y	BAM C++ library (Release Notes)
pbccs	Y	-	Generate consensus sequences from single SMRTbells (Release Notes)
pbcommand	Y	Y	Common models, CLI tool contract and SMRT Link service interface
pbcopper	Y	Y	Core C++ library for data structures, algorithms, and utilities (Release Notes)
pbcore	Y	Y	Python library for reading and writing data files
pbcoretools	Y	Y	CLI tools and add-ons for PacBio's core APIs (incl dataset)
pblaa	Y	-	Long amplicon analysis
pbalign	Y	Y	Python wrapper for BLASR and associated tools
pbgcpp	Y	-	C++ port of assembly polisher. Replaces variantCaller/arrow (Release Notes)
pbmm2	Y	Y	A minimap2 frontend for PacBio native data formats (Release Notes)
pbsv	Y	-	Structural variant analysis (Release Notes)
recalladapters	Y	-	Recall adapters (Release Notes)

Combo-Packages

These combine multiple repos into a single bioconda package.

Package	Linux	Mac	Description
pb-falcon	Y	-	pypeflow/FALCON/FALCON_unzip (Release Notes)
pb-dazzler	Y	Y	PacBio forks of DALIGNER/DAMASKER/DAZZ_DB/DEXTRACTOR

Available Meta-Packages

These include dependencies only. They describe a mutually consistent, well-tested set of versions of all dependencies.

Package	Linux	Mac	Description
pb-assembly	Y	-	Everything needed to run Falcon and Unzip (Release Notes)

FAQ

Where do I get support?

PacBio tools distributed via bioconda are not covered by any service level agreement or the like. As such, please do not contact a PacBio Field Applications Scientist or PacBio Customer Service for assistance with any bioconda releases. We instead provide an issue tracker for you to report issues.

I can't find tool X, when will it be available on bioconda?

We do not provide ETAs for currently not available tools.

When will a new version of tool X be available?

We do not provide ETAs for our release schedule.

Will SMRT Link be available on bioconda?

There are no plans. For the latest SMRT Link release, please refer to currently available SMRT Link downloads.

Can I get the exact version of the binaries from SMRT Link version XY through bioconda?

There is no effort to keep official SMRT Link releases and bioconda binaries in sync.

Which version of tool X shall I use, from bioconda or from SMRT Link?

If you need ISO-compliant software that has been fully vetted, you must use our official SMRT Link software. Bioconda binaries are pre-release versions that adhere to high standards, but might generate slightly different output, due to bug fixes and/or new features.

Why is the official SMRT Tools Guide not in sync with bioconda binaries?

Official documentation provided by PacBio is for binaries distributed in stable SMRT Link releases. You can click on package names in the table above to get to unofficial, best effort documentation. Combo- and meta-packages don't necessarily have additional documentation, as they serve as lightweight, yet well-tested, sets of existing packages.

Which operating systems are supported?

All packages are available for 64-bit linux. Some are available for 64-bit MacOS. For details, please study the table above. There are no plans to provide darwin binaries for packages currently missing MacOS. There are no plans to provide executables for Windows. We do not provide support for WSL (Windows Subsystem for Linux).

Disclaimer/Copyright

© Copyright Pacific Biosciences of California, Inc. All rights reserved. Pacific Biosciences, the Pacific Biosciences logo, PacBio, SMRT, SMRTbell, Iso-Seq and Sequel are trademarks of Pacific Biosciences. All other trademarks are the sole property of their respective owners. Certain notices, terms, conditions and/or use restrictions may pertain to your use of Pacific Biosciences products and/or third party products. Please refer to the applicable Pacific Biosciences Terms and Conditions of Sale and to the applicable license terms at http://www.pacb.com/legal-and-trademarks/product-license-and-use-restrictions/. Information herein is subject to change without notice. Pacific Biosciences assumes no responsibility for any errors or omissions herein.

THIS WEBSITE AND CONTENT AND ALL SITE-RELATED SERVICES, INCLUDING ANY DATA, ARE PROVIDED "AS IS," WITH ALL FAULTS, WITH NO REPRESENTATIONS OR WARRANTIES OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, ANY WARRANTIES OF MERCHANTABILITY, SATISFACTORY QUALITY, NON-INFRINGEMENT OR FITNESS FOR A PARTICULAR PURPOSE. YOU ASSUME TOTAL RESPONSIBILITY AND RISK FOR YOUR USE OF THIS SITE, ALL SITE-RELATED SERVICES, AND ANY THIRD PARTY WEBSITES OR APPLICATIONS. NO ORAL OR WRITTEN INFORMATION OR ADVICE SHALL CREATE A WARRANTY OF ANY KIND. ANY REFERENCES TO SPECIFIC PRODUCTS OR SERVICES ON THE WEBSITES DO NOT CONSTITUTE OR IMPLY A RECOMMENDATION OR ENDORSEMENT BY PACIFIC BIOSCIENCES.