Skip to content

a machine learning model to identify nucleotide features determining RNA subcellular localization

License

Notifications You must be signed in to change notification settings

YangLab/RNAlight

Repository files navigation

RNAlight

RNAlight: a machine learning model to identify determinant features for RNA subcellular localization.

Version: 1.0 2022/10/26

Author: Guo-Hua Yuan

Email: yuanguohua2020@sibs.ac.cn

1. Installation

1.1 Download RNAlight git repo

git clone git@github.com:YangLab/RNAlight.git 

1.2 Set PATH enviromental virable of RNAlight

RNAlight="/Your_Path/RNAlight"
export PATH=${RNAlight}:$PATH

echo "export ${RNAlight}:\$PATH" >> ~/.bashrc

1.3 RNAlight Conda setup

  • Create a new conda environment and activate

      conda create -n RNAlight python=3.6.10
      conda activate RNAlight
    
  • Install dependencies

      conda install scikit-learn=0.20.3 numpy=1.17.0 pandas=0.21.0 lightgbm=3.1.1
      conda install shap==0.34.0
      conda install seqkit=0.14.0
    

2. Usage

usage: RNAlight -q query.fasta [-p Prefix] [-o Output_Dir] [--shap Shapley_value] [--topn Top_n_k-mer] [-m mRNA] [--RNA RNA] [-h] [-v]

Predict diverse RNA subcellular localization with RNA sequence (cDNA format:
ACGT) and identify determinant k-mers with Shapley value 

optional arguments:
	-h, --help				show this help message and exit
	-q Query, --query Query
                    		query file to be predicted (fasta format)
	-p Prefix, --prefix Prefix
                    		prefix of outputfiles (default: query)
	-o Output_Dir, --outputdir Output_Dir
                   			output directions of outputfiles (default:RNAlight_output)
	--shap                	Provide determinant k-mers using Shapley value
	--topn TOPN           	Top n determinant k-mers computed by Shapley value (default: 10)
	-m, --mRNA            	query sequence is mRNA
	--RNA                 	query sequence is RNA format(ACGU)
	-v, --version         	version for RNAlight

3. Example

  • Your query file need to be a fasta format which recorded the cDNA sequence of RNA (U was replaced as T, ACGT).

      RNAlight -q $RNAlight/example/Query.fa -p Test -o RNAlight_Test
    
  • Please add the argument -m or --mRNA if your query sequences are mRNAs.

      RNAlight -q Your_query_mRNA.fasta -m -p mRNA -o RNAlight_mRNA
    
  • Please add the argument --RNA if your query file is a fasta format of RNA sequence (ACGU).

      RNAlight -q Your_query_RNA_format.fasta --RNA -p RNA_format -o RNAlight_RNA_foramt
    

4. Output

RNAlight_Test/
├── Test_df_kmer345_freq.tsv        # kmer frequency file (k = 3,4,5)
├── Test_df_kmer345_rawcount.tsv    # kmer rawcount file (k = 3,4,5)
├── Test_RNAlight_predict_df       # Predict result 
└── Test.tmp
    └── Test.txt                    # tabular format of querey sequences
  • Test_RNAlight_predict_df

    Field Discription
    seq_id ID of sequence
    RNALight_pred_label Predict label of sequence (0:Cytoplasm; 1: Nucleus)
    RNALight_pred_prob Probability of necleus loclaization from RNAlight
    Light_score Scaled RNALight_pred_prob (range from -1 to 1)

5. Repeat this work

If you want to repeat this from scratch, please see Repeat_Work to find requirements you need. If only use RNAlight to predict RNA subcellular localization, please ignore this section.

6. Citation

Yuan GH#, Wang Y#, Wang GZ and Yang L*. RNAlight: a machine learning model to identify nucleotide features determining RNA subcellular localization. Brief Bioinform, 2022, 10.1093/bib/bbac509

7. License

Copyright ©2022 Shanghai Institute of Nutrition and Health. All Rights Reserved.

Licensed GPLv3 for open source use or contact YangLab (yanglab@picb.ac.cn) for commercial use.

Permission to use, copy, modify, and distribute this software and its documentation for educational, research, and not-for-profit purposes, without fee and without a signed licensing agreement, is hereby granted, provided that the above copyright notice in all copies, modifications, and distributions.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

About

a machine learning model to identify nucleotide features determining RNA subcellular localization

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published