2a:["$","title",null,{"children":"Tensorflow model to classify mutational signatures | Yasmmin Martins | Observable"}] 2f:T60a,

Mutational signatures are a group of frequency patterns of single nucleotide variants that occur along the genome. Each group has been associated to a common etiology of cancer in specific tissues. These groups accounts for endogenous (internal cellular processes) or exogenous (exposure to radiation, smoking) causes.

In this notebook, the goal is to check whether a deep learning model may reproduce the same mutational signatures classes predicted by probabilistic models such as SigProfiler . These methods take a long time to execute and generate the results and the time may increase according to the number of samples and combinations of signatures in the experiment. The machine learning approach could accelerate the execution and also turn the process scalable. The ML approach also could allow the calibration of the model according to samples covariates, since some of the signatures are correlated to age, for example.

30:T1488,

Mutational signatures prediction can be derived from two main types of features table: dinucleotide (AC>CA) or single nucleotide (A[C>A]A) bases, these tables are mutational matrices, in which the rows correspond to the variants found in the VCF or MAF files of the samples, and each column accounts for the individual/sample. Here, I am using the Single Base Substitution that generates 96 combinations of base variation (SBS). All the possible classes that these features may have according to the type of cancer and tissues are found in COSMIC, but usually there are up to 10 main signatures in an experiment.

In this notebook, the matrix file was ready to use given in the SigProfiler repository. But in case you need to generate from the variant calling methods, you may use VCF or MAF files. There are open vcf and maf files in TCGA for projects of diverse types of cancer. The code below is an example of matrix generation from maf files downloaded for the cases in the TCGA-OV project using the TCGA API .


                # In case you need to install another genome build version: 
 
                from SigProfilerMatrixGenerator import install as genInstall 

                genInstall.install('GRCh38', rsync=False, bash=True) 
 
 
                
                # To generate the matrix
                from SigProfilerMatrixGenerator.scripts import SigProfilerMatrixGeneratorFunc as matGen 

                project="TCGA-OV"
                buildGen="GRCh38"
                folderMaf="mafs_tcga-ov"
                matrices = matGen.SigProfilerMatrixGeneratorFunc(project, buildGen, folderMaf, exome=False, bed_file=None, chrom_based=False, plot=False, tsb_stat=False, seqInfo=False)

The main input fields here are the label of the project, the version of the reference genome and the path to the folder with your MAF files. You may choose plotting some useful statistics summarized.

In order to obtain the control labels to train our model, the SigProfiler tool that is part of the tools package recommended by COSMIC. Their tools package contains a version for Python and for R. Since the preprocessing of the matrix was made in Python, I used the Python version. But there are other mutational signatures extraction methods, mainly in R (MutationalPatterns, MutSignatures, Mix-MMM (Python) ). To create the labels with this method, I used the mutational matrix in the original format given as example in the SigProfiler repository. The method is very simple to use, it takes two command lines (it requires you to enter in the Python interpreter console mode, just type python3 in terminal):


                from SigProfilerExtractor import sigpro as sig 

                sig.sigProfilerExtractor("matrix", "results_sample", "samples_matrix.tsv", reference_genome="GRCh37", minimum_signatures=1, maximum_signatures=10, nmf_replicates=100, cpu=-1)

In this code, "matrix" means the type of input format we are working with that is the mutational matrix, "results_sample" is the name of the results folder where the predictions for COSMIC and De Novo methods will be saved, and then specify the human genome build and the range of signatures (1 to 10) that will be tested in 100 interactions (nmf_replicates). This method returns a lot of files as results, but the most important ones are the tables for the COSMIC (results_sample/SBS96/Suggested_Solution/COSMIC_SBS96_Decomposed_Solution/Activities/COSMIC_SBS96_Activities.txt) and De Novo (results_sample/SBS96/Suggested_Solution/SBS96_De-Novo_Solution/Activities/SBS96_De-Novo_Activities_refit.txt) classes, in which the rows are the samples and each column is a distinct COSMIC or De Novo class, the numbers represent the intensity of the relationshiip among a sample to a certain class. The label with the highest number was chosen to be the label for the sample.

31:T1336,

These matrices in the mentioned configuration are used by the published profilers to obtain the most probable signatures for each sample, they may use a De Novo or the COSMIC computed frequencies for each SBS according to the specific genome build. Since in this machine learning experiment, we are interested in attribute a class for each sample, the first step to process the mutational matrix is transpose the original matrix, then each row turns into a sample having 96 numerical features as columns (See code below).


                # Loading pandas library to deal with dataFrames and perform matrix operations 
 
                import pandas as pd 
 
 
                
                # Loading the mutational matrix 

                df=pd.read_csv('sample_matrix.tsv', sep='\t') 
 
 
                
                # Extracting the values as a 2D-array, removing the index and the column names 

                X=df.values 
 
 
                
                # Removing the variant names column since it will not be used  

                X=X[:, 1:] 
 
 
                
                # Transposing the data matrix (rows now are samples, and columns are the 96 SBS features) 

                X=X.T

For this example, the labels returned by the SIgProfiler were SBS13, SBS3 and SBS40. This classes means that in some samples the cause may be defective homologous recombination-based DNA damage repair (SBS3), in other samples the etiology is enzyme activity alterations caused by mutations in the APOBEC enzymes (SBS13), and finally the last type observed is the SBS40, which does not have etiology description in COSMIC, but it is correlated to patient's age in some types of cancer. This clearly characterizes a multi-class prediction problem, since we may have up to 3 classes that will be distributed in the samples. We also need to preprocess these cateogrical labels to turn them into integer numbers (SBS3 -> 0, SBS13 -> 1, SBS40 -> 2) (see code below). In this code we will prepare the json file containing the X and Y for train and test, as well as the class names.


                # Loading pandas library to deal with dataFrames and perform matrix operations 

                import pandas as pd 
 
 
                
                # Loading the labels table 

                df=pd.read_csv('sample_cosmic_labels.tsv', sep='\t') 
 
 
                
                # Getting the signatures column 

                Y=df['best_signature'] 
 
 
                
                # Getting the labels without repetition
                cls=[]
                for y in Y:
                    if(not y in cls):
                        cls.append(y) 
 
                        
                # loading the label encoder from scikit-learn 
 
                from sklearn.preprocessing import LabelEncoder 
    
 
                  
                # inititalizing LabelEncoder 
 
                encoder = LabelEncoder() 
  
 
                
                # Fitting the labels 
 
                encoder.fit(Y) 
  
 
                
                # Transforming each category into integer values 
 
                encoded_Y = encoder.transform(Y) 
  
 
                
                # Loading train_test_split 
 
                from sklearn.model_selection import train_test_split  
    
 
                
                # Slice original data into train/test parts, following the rule 2/3 for train and 1/3 for test  
  
                X_train, X_test, y_train, y_test = train_test_split(X, encoded_Y, test_size=0.33, random_state=42) 
  
 
                
                # Representing data as dictionary  
  
                sample_data={'x_train': X_train.tolist(), 'y_train': y_train.tolist(), 'x_test': X_test.tolist(), 'y_test': y_test.tolist(), 'classNames': cls } 
  
 
                
                # Loading json library 
 
                import json 
  
 
                
                # Saving the data into json 

                with open('sample_model/data.json', 'w') as f: 
 
                    json.dump(sample_data, f)

The processed json file may now be retrieved by tensorflow JS.

32:T461,// Defining the function to call train upon callback to update the plots mutasig.train_visualization = async () => { const callbacks = { onEpochEnd: function (epoch, log) { const surface = { name: 'Training Visualization', tab: 'Training' }; const options = { xLabel: 'Epoch', yLabel: 'Value', yAxisDomain: [0, 1], seriesColors: ['teal', 'tomato'] }; // Prep the data mutasig.epochLogs.push(log); const acc = mutasig.epochLogs.map((log, i) => ({ x: i, y: log.acc })); const valAcc = mutasig.epochLogs.map((log, i) => ({ x: i, y: log.val_acc })); const data = { values: [acc, valAcc], // Custom names for the series series: ['Accuracy', 'Validation Accuracy'] // render the chart }; tfvis.render.linechart(surface, data, options); } }; return mutasig.train(callbacks); }33:[] 2d:{"id":"168621ae2e4518d4","slug":"tensorflow-model-to-classify-mutational-signatures","title":"Tensorflow model to classify mutational signatures","thumbnail":"50a26e4c780c2ae1f4c2fc12d0044e957b41a6ba98f017aaa993a22b9cf0984d","access_level":"public","create_time":"$D2022-12-18T20:47:11.392Z","update_time":"$D2022-12-18T21:32:05.590Z","view_time":null,"first_public_time":"$D2022-12-18T20:47:11.392Z","fork":false,"stars":1,"starred":false,"owner":{"type":"team","id":"143bccc9aea741c5","login":"yasmmin","name":"Yasmmin Martins","avatar_url":"https://avatars-next.observableusercontent.com/d1ade9a2167f9ce9848a78e9fec44d68fe5b1f8f01c1106ab3d3bd65e632d519","tier":"starter_2024"},"version":150,"publish_version":null,"role":null,"authored":false,"authors":[{"type":"individual","id":"44a1da9804cebf80","login":"yasmmin","name":"Yasmmin Martins","avatar_url":"https://avatars-next.observableusercontent.com/d1ade9a2167f9ce9848a78e9fec44d68fe5b1f8f01c1106ab3d3bd65e632d519","tier":null}],"members":[{"type":"individual","id":"44a1da9804cebf80","login":"yasmmin","name":"Yasmmin Martins","avatar_url":"https://avatars-next.observableusercontent.com/d1ade9a2167f9ce9848a78e9fec44d68fe5b1f8f01c1106ab3d3bd65e632d519","tier":null,"role":"editor"}],"comments":[],"custom_thumbnail":false,"trashed":false,"lapsed":null,"subscribed":null,"forks":0,"collection":null,"type":"notebook","body":{"title":"Tensorflow model to classify mutational signatures","cells":[{"id":0,"value":"# Tensorflow model to classify mutational signatures","pinned":false,"hidden":false,"mode":"md","author":"$undefined","summary":"$undefined","output":"","database":"$undefined"},{"id":5,"value":"$2f","pinned":false,"hidden":false,"mode":"html","author":"$undefined","summary":"$undefined","output":"","database":"$undefined"},{"id":10,"value":"## About the mutational signatures data and values","pinned":false,"hidden":false,"mode":"md","author":"$undefined","summary":"$undefined","output":"","database":"$undefined"},{"id":14,"value":"$30","pinned":false,"hidden":false,"mode":"html","author":"$undefined","summary":"$undefined","output":"","database":"$undefined"},{"id":16,"value":"## Formatting the data for Deep Learning","pinned":false,"hidden":false,"mode":"md","author":"$undefined","summary":"$undefined","output":"","database":"$undefined"},{"id":18,"value":"$31","pinned":false,"hidden":false,"mode":"html","author":"$undefined","summary":"$undefined","output":"","database":"$undefined"},{"id":20,"value":"## Designing DL model, training and evaluation","pinned":false,"hidden":false,"mode":"md","author":"$undefined","summary":"$undefined","output":"","database":"$undefined"},{"id":22,"value":"I developed a javascript model (MutaSig) that handles the data loading, the model generation and compilation, the training and the renderization of the evaluation visualization plots. The full script is here. The first step is loading the data from the json we created before, the snippet will feed the x_train, x_test, y_train and y_test attributes of the module object transforming the data into tensors, it will also fill the classNames that will be used later to illustrate the confusion matrix:","pinned":false,"hidden":false,"mode":"html","author":"$undefined","summary":"$undefined","output":"","database":"$undefined"},{"id":60,"value":"tf=require('https://cdn.jsdelivr.net/npm/@tensorflow/tfjs')","pinned":true,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","output":"$undefined","database":"$undefined"},{"id":64,"value":"tfvis=require('https://cdn.jsdelivr.net/npm/@tensorflow/tfjs-vis')","pinned":true,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","output":"$undefined","database":"$undefined"},{"id":69,"value":"mutasig=Object()","pinned":true,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","output":"$undefined","database":"$undefined"},{"id":25,"value":"// Defining the load data function\nmutasig.loadData = async (url) => {\n await fetch( url ).then( (response) => response.json() ).then( (data) => {\n mutasig.x_train = tf.tensor(data.x_train);\n mutasig.x_test = tf.tensor(data.x_test)\n \n mutasig.y_train = tf.tensor(data.y_train);\n mutasig.y_test = tf.tensor(data.y_test);\n \n mutasig.classNames = data.classNames;\n });\n}","pinned":true,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","output":"$undefined","database":"$undefined"},{"id":77,"value":"// Loading data\nmutasig.loadData('https://yascoma.github.io/mutasig/data.json')","pinned":true,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","output":"$undefined","database":"$undefined"},{"id":50,"value":"// Checking the contents\nmutasig","pinned":true,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","output":"$undefined","database":"$undefined"},{"id":83,"value":"The next step is creating the neural network model ( mutasig.loadModel(); ). The input shape has 96 columns, and the first Dense layer will have 128 units and the activation function is the Rectified Linear Unit (ReLU), the second layer will have 256 units and also uses ReLU and the final layer will deliver the prediction and the number of units is given by the number of classes we want to predict. The activation function of the last layer is softmax and this function also compiles the model using the Adam optimizer and sparseCategoricalCrossentropy to compute the loss and it uses the accuracy to minimize along the epochs. The configured model using tensorflowjs has the following architecture, and can be accessed by mutasig.model.summary();:","pinned":false,"hidden":false,"mode":"html","author":"$undefined","summary":"$undefined","output":"","database":"$undefined"},{"id":86,"value":"// Defining the function to create the model\nmutasig.loadModel = () => {\n mutasig.model = tf.sequential({\n layers: [\n tf.layers.dense({inputShape: [96], units: 128, activation: 'relu'}),\n tf.layers.dense({ units: 256, activation: 'relu'}),\n tf.layers.dense({ units: mutasig.classNames.length }),\n ]\n });\n \n mutasig.model.compile({\n optimizer: 'adam',\n loss: 'sparseCategoricalCrossentropy',\n metrics: ['accuracy']\n });\n}","pinned":true,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","output":"$undefined","database":"$undefined"},{"id":88,"value":"// Initializing the model and compiling\nmutasig.loadModel();","pinned":true,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","output":"$undefined","database":"$undefined"},{"id":99,"value":"// Initializing the visualization panel of tensorflow js viz (Go up to the page to see!)\ntfvis.visor();","pinned":true,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","output":"$undefined","database":"$undefined"},{"id":111,"value":"### Model architecture:","pinned":false,"hidden":false,"mode":"md","author":"$undefined","summary":"$undefined","output":"","database":"$undefined"},{"id":107,"value":"

","pinned":false,"hidden":false,"mode":"html","author":"$undefined","summary":"$undefined","output":"","database":"$undefined"},{"id":114,"value":" Once having the data and the model, we can train it and tensorflow js offers a visualization panel interact and see in real time what is happening while training the model. Firstly we instantiate the panel (tfvis.visor();), then I call the training function in mutasig ( mutasig.train_visualization(); ) with the parameters of the callback that will receive the partial results of the epoch and plot point by point. The function mutasig.train() fits the model in 50 epochs, using a batch size of 32, and shuffle the data samples. It will plot a line chart that shows the accuracy value along the epochs when some epoch ends. It will render the training chart using the title \"Training Visualization\" in the Training tab of the visualization panel.","pinned":false,"hidden":false,"mode":"html","author":"$undefined","summary":"$undefined","output":"","database":"$undefined"},{"id":117,"value":"// Defining the function to train\nmutasig.train = (fitCallbacks) => {\n const BATCH_SIZE = 32;\n \n return mutasig.model.fit( mutasig.x_train, mutasig.y_train, {\n batchSize: BATCH_SIZE,\n validationData: [ mutasig.x_test, mutasig.y_test ],\n epochs: 50,\n shuffle: true,\n callbacks: fitCallbacks\n });\n}","pinned":true,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","output":"$undefined","database":"$undefined"},{"id":120,"value":"$32","pinned":true,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","output":"$undefined","database":"$undefined"},{"id":125,"value":"mutasig.epochLogs=[];","pinned":true,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","output":"$undefined","database":"$undefined"},{"id":123,"value":"// Calling training visualization\nawait mutasig.train_visualization();","pinned":true,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","output":"$undefined","database":"$undefined"},{"id":127,"value":"After training the model we may use the test dataset to perform some predictions. The function mutasig.doPrediction(); returns the true labels of the test dataset and computes the predicted labels, returning both arrays. And the function mutasig.showAccuracy(); renders a table containing the accuracy for each class and the number of samples representing this class. Finally, the function mutasig.showConfusion(); shows a confusion matrix (3x3) comparing the number of samples that were correctly classified (main diagonal) and those that were classified in other class.","pinned":false,"hidden":false,"mode":"html","author":"$undefined","summary":"$undefined","output":"","database":"$undefined"},{"id":130,"value":"// Defining doPrediction function\nmutasig.doPrediction = () => {\n const labels = mutasig.y_test;\n const preds = mutasig.model.predict(mutasig.x_test).argMax([-1]);\n return [preds, labels];\n}","pinned":true,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","output":"$undefined","database":"$undefined"},{"id":132,"value":"// Defining showAccuracy\nmutasig.showAccuracy = async () => {\n const [preds, labels] = mutasig.doPrediction();\n console.log(labels.shape);\n console.log(preds.shape);\n // Use preds.data() to extract the values from tensor\n \n const classAccuracy = await tfvis.metrics.perClassAccuracy(labels, preds);\n \n const container = {\n name: 'Accuracy',\n tab: 'Evaluation'\n };\n \n tfvis.show.perClassAccuracy(container, classAccuracy, mutasig.classNames);\n}","pinned":true,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","output":"$undefined","database":"$undefined"},{"id":134,"value":"// Defining showConfusion\nmutasig.showConfusion = async () => {\n const [preds, labels] = mutasig.doPrediction();\n \n const confusionMatrix = await tfvis.metrics.confusionMatrix(labels, preds);\n \n const container = {\n name: 'Confusion Matrix',\n tab: 'Evaluation'\n };\n \n tfvis.render.confusionMatrix(container, {\n values: confusionMatrix,\n tickLabels: mutasig.classNames\n });\n}","pinned":true,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","output":"$undefined","database":"$undefined"},{"id":136,"value":"mutasig.showAccuracy()","pinned":true,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","output":"$undefined","database":"$undefined"},{"id":138,"value":"mutasig.showConfusion()","pinned":true,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","output":"$undefined","database":"$undefined"},{"id":140,"value":"## Results interpretation","pinned":false,"hidden":false,"mode":"md","author":"$undefined","summary":"$undefined","output":"","database":"$undefined"},{"id":142,"value":"The sample data used in this experiment had a lot of dataset issues for a model, it contains only 21 samples, so 14 of them were split for training and 7 for testing. The second issue is that the classes were not balanced: two samples were classified as SBS13, seven samples had the class SBS3 and SBS40 was assigned to 12 samples. These two issues are sevee in any context of ML application. But even considering these conditions some rounds of execution and prediction returns an accuracy value of 80%. The experimentation with all the samples of real TCGA projects may help to better calibrate and enhance this model.","pinned":false,"hidden":false,"mode":"html","author":"$undefined","summary":"$undefined","output":"","database":"$undefined"},{"id":144,"value":"### References","pinned":false,"hidden":false,"mode":"md","author":"$undefined","summary":"$undefined","output":"","database":"$undefined"},{"id":146,"value":"Mix-MMM - https://genomemedicine.biomedcentral.com/articles/10.1186/s13073-021-00988-7
\nMutationalPatterns - https://genomemedicine.biomedcentral.com/articles/10.1186/s13073-018-0539-0
\nMutSignatures - https://www.nature.com/articles/s41598-020-75062-0 ","pinned":false,"hidden":false,"mode":"html","author":"$undefined","summary":"$undefined","output":"","database":"$undefined"}],"files":"$W33","stdlib":"1","titling":"auto"}} 2e:"$2d:body" 29:E{"digest":"NEXT_REDIRECT;replace;/@yasmmin/tensorflow-model-to-classify-mutational-signatures;307;"}