跳到正文
cccskills
免费在 GitHub 公开

bioconductor-basilisk

Installs a self-contained conda instance that is managed by the R/Bioconductor installation machinery. This aims to provide a consistent Python environment that can be used reliably by Bioconductor packages. Functions are also provided to e

中文简介正在准备中。当前显示原文说明。

查看安装方法

包含的文件(1)

  • SKILL.md5.5 KB

SKILL.md(原文)

安装前可以查看交给 AI 代理的指令内容。

basilisk

Dependencies & Environment

Package-intrinsic requirements from the Bioconductor landing page — reproduce in any R environment.

  • Version: 1.24.0 · Bioconductor: 3.23 · R: ≥ 4.6
  • Depends: reticulate
  • Imports: dir.expiry
  • Install: BiocManager::install("basilisk")

When to Use

  • Developing Bioconductor packages that require a reliable, self-contained Python environment using BasiliskEnvironment to freeze dependencies.
  • Executing Python-based calculations (e.g., scikit-learn's TruncatedSVD) on R matrices safely in an isolated process via basiliskRun.
  • Managing multiple, isolated Python environments within a single R session using createLocalBasiliskEnv and basiliskRun to prevent dependency clashes.

When NOT to Use

  • For interactive, ad-hoc Python development where you want to use your pre-existing global environment, use reticulate directly because basilisk is primarily intended for package developers to freeze dependencies.
  • For simple R-native tasks, use native R implementations because provisioning custom Python virtual environments adds installation overhead.

Data Requirements

  • Input format: Pure R objects (e.g., matrices like matrix(rnorm(1000), ncol=10)) that are amenable to serialization.
  • Structure: Variables must be explicitly passed as arguments to the function supplied to basiliskRun.
  • Normalization state: Not explicitly constrained by basilisk; depends entirely on the downstream Python module being called.

Key Parameters

  • envname (no default): The unique name of the basilisk environment to create or load in BasiliskEnvironment.
  • pkgname (no default): The name of the client package defining the environment in BasiliskEnvironment.
  • packages (no default): A character vector of Python packages (with explicit version constraints like "pandas==2.2.3") to install.
  • fun (no default): The R function containing the Python code to execute inside the isolated environment via basiliskRun.
  • persist (FALSE): Logical indicating whether to persist variables across multiple calls to basiliskRun by passing a store environment.
  • obsolete.only (TRUE): Logical in clearExternalDir to remove only obsolete environments.

Best Practices

  • Always specify exact version numbers for all Python packages (e.g., "scikit-learn==1.6.1") in BasiliskEnvironment to future-proof the installation.
  • Use basiliskStart and basiliskStop (via on.exit()) to manage the process context when executing basiliskRun.
  • Ensure the return value of the function passed to basiliskRun is a pure R object, not a reticulate binding or pointer to external memory.
  • Explicitly import non-base R functions via their namespace (using ::) inside the function passed to basiliskRun.

Common Pitfalls

  • Relying on closures capturing the R environment in which the function was defined causes failures; fix this by explicitly passing variables as arguments to the function in basiliskRun.
  • Returning reticulate bindings to Python objects causes invalid pointer errors when transferred back to the parent process; fix this by returning only pure R objects.
  • Deeply nested directories on Windows exceeding the 260-character file path limit cause installation to silently fail; fix this by setting the BASILISK_EXTERNAL_DIR environment variable to a shorter path.
  • Low disk usage quotas causing incomplete installations; fix this by running clearExternalDir to forcibly clear obsolete environments.

Alternatives

  • reticulate: The underlying framework for R-to-Python interoperability, suitable for interactive use but lacks the Bioconductor-managed freezing of Python versions.
  • renv: Manages R package dependencies and Python virtualenvs at the project level rather than the package level.
  • herper: Manages Conda environments from R but does not isolate execution in a separate process like basilisk.

Citations

  • Lun A (2025). Freezing Python versions inside Bioconductor packages. Package basilisk vignette.

References

<!-- biomate-cta -->

Run this on BioMate

This skill is the knowledge layer — when, why, and how to use basilisk. To run this analysis on your own data with managed compute, automated QC, and reproducible outputs, use BioMate — free to start.

▶ Open basilisk on BioMate →

评价

还没有评价。欢迎分享你的使用感受。

评论

无需登录即可发表。欢迎分享使用感受、提问,或说明在哪些环境下无法运行。

还没有评论。来写第一条吧。

提交后会立即公开。请勿填写邮箱、电话等个人信息。URL 最多 2 个。

0 / 1000 字

此表单受 reCAPTCHA 保护,适用 Google 的隐私权政策和服务条款。

同一仓库的技能

The package contains functions for exploratory oligonucleotide array analysis. The dependence on tkWidgets only concerns few convenience functions. 'affy' is fully functional without it.

中文简介正在准备中。当前显示原文说明。

bioMate-AI/biomate-bioconductor-kb7932026年6月21日 更新

This tool uses the label-tree function from HyPhy to annotate a phylogenetic tree. It allows users to select a subset of leaves using either a regular expression or a list of sequence names, and then apply a specified label to these selecte

中文简介正在准备中。当前显示原文说明。

bioMate-AI/biomate-bioconductor-kb7932026年6月21日 更新

This package provides a client for the Bioconductor AnnotationHub web resource. The AnnotationHub web resource provides a central location where genomic files (e.g., VCF, bed, wig) and other resources from standard locations (e.g., UCSC, En

中文简介正在准备中。当前显示原文说明。

bioMate-AI/biomate-bioconductor-kb7932026年6月21日 更新

apeglm provides Bayesian shrinkage estimators for effect sizes for a variety of GLM models, using approximation of the posterior for individual coefficients.

中文简介正在准备中。当前显示原文说明。

bioMate-AI/biomate-bioconductor-kb7932026年6月21日 更新

ASURAT is a software for single-cell data analysis. Using ASURAT, one can simultaneously perform unsupervised clustering and biological interpretation in terms of cell type, disease, biological process, and signaling pathway activity. Inputting a single-cell RNA-seq data and knowledge-based databases, such as Cell Ontology, Gene Ontology, KEGG, etc., ASURAT transforms gene expression tables into original multivariate tables, termed sign-by-sample matrices (SSMs).

中文简介正在准备中。当前显示原文说明。

bioMate-AI/biomate-bioconductor-kb7932026年6月21日 更新

AUCell allows to identify cells with active gene sets (e.g. signatures, gene modules...) in single-cell RNA-seq data. AUCell uses the "Area Under the Curve" (AUC) to calculate whether a critical subset of the input gene set is enriched with

中文简介正在准备中。当前显示原文说明。

bioMate-AI/biomate-bioconductor-kb7932026年6月21日 更新

查看 bioMate-AI 的全部技能

报告此技能的问题