This repository is a home for the Molecular Oncology Almanac's workshop at the 2023 Cancer Genomics Consortium conference. There are three files of interest in this repository,
2023-08-13-workshop-slides.pdf, presentation slides for the workshopalgorithm-demo.ipynb, a jupyter notebook that illustrate usage of the algorithm.(https://github.com/vanallenlab/moalmanac/tree/main/moalmanac). This notebook should be run from the algorithm's execution directory.api-demo.ipynb, a jupyter notebook that illustrates usage of the database's API.
To download this repository via GitHub you can execute from terminal,
git clone https://github.com/vanallenlab/2023-cgc.gitThis repository uses Python 3.11 and we recommend using a virtual environment and running Python with either Anaconda or Miniconda. After installing Anaconda or Miniconda, you can set up by running
conda create -n moalmanac python=3.11 -y
source activate moalmanac
pip install -r requirements.txtThe algorithm-demo.ipynb should be moved to and run from the algorithm's execution directory.
Molecular Oncology Almanac (MOAlmanac) is a clinical interpretation algorithm paired with an underlying knowledge base for precision oncology. The primary objective of MOAlmanac is to identify and associate molecular alterations with therapeutic sensitivity and resistance as well as disease prognosis. This is done for “first-order” genomic alterations -- individual events such as somatic variants, copy number alterations, fusions, and germline -- as well as “second-order” events -- those that are not associated with one single mutation, and may be descriptive of global processes in the tumor such as tumor mutational burden, microsatellite instability, mutational signatures, and whole-genome doubling. In addition to clinical insights, MOAlmanac will annotate and evaluate first-order events based on their presence in numerous other well established datasources as well as highlight connections between them. This method currently geared towards hg19/b37 reference files and whole-exome or targeted sequencing data.
This repository is specifically for the clinical interpretation method and there are several other resources within the Molecular Oncology Almanac ecosystem:
- Molecular Oncology Almanac, the clinical interpretation algorithm for precision cancer medicine [GitHub].
- Molecular Oncology Almanac Browser, a website to browse our underlying knowledge base [GitHub].
- Molecular Oncology Almanac Connector, a Google Chrome extension to quickly suggest literature for cataloging [GitHub].
- Molecular Oncology Almanac Database, the content and release notes of our underlying knowledge base [GitHub].
- Molecular Oncology Almanac Portal, a website to launch this method on the Broad Institute's Google Cloud platform called Terra [GitHub].
This method is also available on Docker and Terra.
If you use this method, please cite our publication: