cellme
Convert a human cell line identifier into a truth-track VCF of its known mutations.
Introduction
cellme builds a truth/known VCF for a cell line by resolving a name such as MOLT-4 to a Cancer Cell Line Encyclopedia sample, fetching that sample's somatic mutations from the cBioPortal REST API, and writing them as a sorted VCF.
The mutation source is the ccle_broad_2019 study.
Records are against the GRCh37 assembly but a liftover can be performed if you need GRCh38 output.
Installation
Install the release from PyPI with pip:
pip install cellme
Add cellme to a uv project, or run it without installing, with:
uv add cellme
uvx cellme --help
Development Installation
Install the Python package and dependency management tool uv using the official documentation.
Install the dependencies of the project with:
uv sync --locked
To check successful installation, run:
uv run cellme --help
Usage
Write a GRCh38 truth track for the cell line MOLT-4 to a file:
uv run cellme "MOLT-4" --build GRCh38 --reference /ref/hg38.fa --output MOLT-4.GRCh38.vcf
[!IMPORTANT] Always pass
--referencewith a FASTA for the build you target, as shown above. It ensure the correct anchor bases are set for insertions and deletions. Without it, indel anchor bases fall back to a placeholderNand those records are markedANCHOR=placeholder.
The query is matched case-insensitively on the leading cell line token, so MOLT-4, MOLT4, and the full MOLT4_HAEMATOPOIETIC_AND_LYMPHOID_TISSUE sample ID all resolve to the same sample.
VCF INFO Fields
Every record is annotated with compact, self-describing INFO fields.
| Key | Type | Description |
|---|---|---|
GENE |
String | HUGO gene symbol. |
PROTEIN_CHANGE |
String | Protein-level change in CCLE short form (HGVS p.-like), e.g. R306*. |
VARIANT_CLASS |
String | Variant classification (MAF-style), e.g. Missense_Mutation. |
VARIANT_TYPE |
String | Sequence alteration type reported by CCLE: SNP, DNP, INS, or DEL. |
CELL_LINE |
String | Cell line resolved from the query. |
SAMPLE_ID |
String | CCLE sample identifier for the cell line. |
ENTREZ |
Integer | NCBI Entrez gene identifier. |
REFSEQ |
String | RefSeq mRNA accession for the annotated transcript. |
PROTEIN_POS |
String | Affected protein position or range, 1-based. |
SOURCE |
String | Source database and study, e.g. cBioPortal CCLE ccle_broad_2019. |
ORIGINAL_BUILD |
String | Genome build of the source coordinates before any liftover. |
ORIGINAL_LOCUS |
String | Original locus before liftover in UCSC position format, e.g. chr17:7577022. |
LIFTED |
Flag | Coordinate was lifted from ORIGINAL_BUILD to the output reference build. |
ANCHOR |
String | Provenance of the indel anchor base: reference or placeholder. |
The ID column is set to a stable gene:proteinChange token where one is available, for example TP53:R306*, and falls back to gene:chrom:pos otherwise.
Development and Testing
See the contributing guide for more information.
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file cellme-1.0.0.tar.gz.
File metadata
- Download URL: cellme-1.0.0.tar.gz
- Upload date:
- Size: 93.4 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
2d68d16096d5ec5d9c47d41ad2ebe9eebcfaa58d4b296271cf5b87842c1fcbc7
|
|
| MD5 |
6acefe239a1d54eca6ee41e9fa7d229a
|
|
| BLAKE2b-256 |
ef381f154b1476d3b03ec362e07f492cd880eeb9b72234a2710023fc36264838
|
Provenance
The following attestation bundles were made for cellme-1.0.0.tar.gz:
Publisher:
publish_cellme.yml on clintval/cellme
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
cellme-1.0.0.tar.gz -
Subject digest:
2d68d16096d5ec5d9c47d41ad2ebe9eebcfaa58d4b296271cf5b87842c1fcbc7 - Sigstore transparency entry: 2726320548
- Sigstore integration time:
-
Permalink:
clintval/cellme@38c3c54cf8608240b2560dd228869132c624945e -
Branch / Tag:
refs/tags/1.0.0 - Owner: https://github.com/clintval
-
Access:
private
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish_cellme.yml@38c3c54cf8608240b2560dd228869132c624945e -
Trigger Event:
push
-
Statement type:
File details
Details for the file cellme-1.0.0-py3-none-any.whl.
File metadata
- Download URL: cellme-1.0.0-py3-none-any.whl
- Upload date:
- Size: 16.5 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
4c959421966d385ce90d5b6ff35e0591fe23a7091e62fe445d27b36baf288ed1
|
|
| MD5 |
fc0658b085f68e3c73ea9c5e6aa9cf32
|
|
| BLAKE2b-256 |
ab5d9df89ca7824f87a5c6591b86ec944baf68935d5685c0ac2c209281f28665
|
Provenance
The following attestation bundles were made for cellme-1.0.0-py3-none-any.whl:
Publisher:
publish_cellme.yml on clintval/cellme
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
cellme-1.0.0-py3-none-any.whl -
Subject digest:
4c959421966d385ce90d5b6ff35e0591fe23a7091e62fe445d27b36baf288ed1 - Sigstore transparency entry: 2726320559
- Sigstore integration time:
-
Permalink:
clintval/cellme@38c3c54cf8608240b2560dd228869132c624945e -
Branch / Tag:
refs/tags/1.0.0 - Owner: https://github.com/clintval
-
Access:
private
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish_cellme.yml@38c3c54cf8608240b2560dd228869132c624945e -
Trigger Event:
push
-
Statement type:
