跳转到主要内容

使用TileDB进行高效存储和检索单细胞数据的Python API

项目描述

概述

这是一个用于与SOMA API规范交互的统一单细胞数据模型的Python实现。

安装

TileDB-SOMA可在PyPIConda上获取,并且可以通过以下指示使用pipmamba安装。

python -m pip install tiledbsoma
mamba install -c conda-forge -c tiledb tiledbsoma-py

安装特定版本

$ python -m pip install git+https://github.com/single-cell-data/TileDB-SOMA.git@0.0.6#subdirectory=apis/python

更新到最新版本

$ python -m pip install --upgrade tiledbsoma

当在较旧的架构上运行时(例如Opteron,非AVX2)出现非法指令错误时,问题在于Conda或PyPI上可用的预编译二进制文件并非针对所有处理器变种。您可以按照以下所示从源代码安装。

要检查是否是此问题,在Linux上

grep avx2 /proc/cpuinfo

如果您的系统为空,则您必须从源代码构建以在该系统上运行TileDB-SOMA。

从源代码

  • 这需要tiledb(请参阅./setup.cfg以获取版本),以及在setup.cfg中指定的其他依赖项。
  • 克隆此仓库
  • 在您的检出中cd并然后cd apis/python
  • python -m pip install .
  • 或者,如果您想修改代码并运行它,python -m pip install -v -e .
  • 如果TileDB和TileDB-SOMA库已本地安装到自定义目录,例如/usr/local,则使用环境变量TILEDB_PATHTILEDBSOMA_PATH设置路径,TILEDB_PATH=/usr/local python -m pip install -v -e .
  • 可选地,如果您愿意,可以在venv中运行它
    $ python -m venv venv
    $ . ./venv/bin/activate
    $ python -m pip install -v -e .
    
  • 在任何情况下
    python -m pytest tests
    

状态

请参阅https://github.com/single-cell-data/TileDB-SOMA/issues

platform_config格式

在访问SOMA API时,可以使用platform_config参数配置TileDB特定设置。此处描述了TileDB SOMA接受的选项,使用TypeScript接口语法

interface PlatformConfig {
  tiledb?: TDBConfig;
}

interface TDBConfig {
  create?: TDBCreateOptions;
}

interface TDBCreateOptions {
  dims?: { [dim: string]: TDBDimension };
  attrs?: { [attr: string]: TDBAttr };
  allows_duplicates?: bool;

  offsets_filters?: TDBFilter[];
  validity_filters?: TDBFilter[];

  capacity?: number;
  cell_order?: string;
  tile_order?: string;
}

interface TDBDimension {
  filters?: TDBFilter[];
  tile?: number;
}

interface TDBAttr {
  filters?: TDBFilter[];
}

/**
 * Either the name of a filter (in which case it will use
 * the default arguments) or a specification with filter args.
 */
type TDBFilter = string | TDBFilterSpec;

interface TDBFilterSpec {
  /** The name of the filter. */
  _name: string;
  /** kwargs that are passed when constructing the filter. */
  [kwarg: string]: any;
}

开发者信息

请参阅TileDB-SOMA wiki

项目详情


下载文件

下载适合您平台的文件。如果您不确定选择哪个,请了解有关安装包的更多信息。

源分发

tiledbsoma-1.14.2.tar.gz (454.4 kB 查看哈希值)

上传时间:

构建分发

tiledbsoma-1.14.2-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (17.5 MB 查看哈希值)

上传时间: CPython 3.11 manylinux: glibc 2.17+ x86-64

tiledbsoma-1.14.2-cp311-cp311-macosx_11_0_x86_64.whl (25.9 MB 查看哈希值)

上传时间: CPython 3.11 macOS 11.0+ x86-64

tiledbsoma-1.14.2-cp311-cp311-macosx_11_0_arm64.whl (23.0 MB 查看哈希值)

上传时间: CPython 3.11 macOS 11.0+ ARM64

tiledbsoma-1.14.2-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (17.5 MB 查看哈希值)

上传时间: CPython 3.10 manylinux: glibc 2.17+ x86-64

tiledbsoma-1.14.2-cp310-cp310-macosx_11_0_x86_64.whl (25.9 MB 查看哈希值)

上传时间: CPython 3.10 macOS 11.0+ x86-64

tiledbsoma-1.14.2-cp310-cp310-macosx_11_0_arm64.whl (23.0 MB 查看哈希值)

上传时间: CPython 3.10 macOS 11.0+ ARM64

tiledbsoma-1.14.2-cp39-cp39-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (17.5 MB 查看哈希值)

上传时间: CPython 3.9 manylinux: glibc 2.17+ x86-64

tiledbsoma-1.14.2-cp39-cp39-macosx_11_0_x86_64.whl (25.9 MB 查看哈希值)

上传时间: CPython 3.9 macOS 11.0+ x86-64

tiledbsoma-1.14.2-cp39-cp39-macosx_11_0_arm64.whl (23.0 MB 查看哈希值)

上传于 CPython 3.9 macOS 11.0+ ARM64

由以下机构支持

AWS AWS 云计算和安全赞助商 Datadog Datadog 监控 Fastly Fastly CDN Google Google 下载分析 Microsoft Microsoft PSF 赞助商 Pingdom Pingdom 监控 Sentry Sentry 错误日志 StatusPage StatusPage 状态页面