Metadata-Version: 2.1
Name: merpy
Version: 1.3.0
Summary: use MER inside python
Home-page: https://github.com/lasigeBioTM/merpy
Author: Andre Lamurias
Author-email: alamurias@lasige.di.fc.ul.pt
License: UNKNOWN
Description: [![Downloads](https://pepy.tech/badge/merpy)](https://pepy.tech/project/merpy)
        
        Use MER scripts inside python.
        
        
        (from the MER repository)
        
        MER is a Named-Entity Recognition tool which given any lexicon and any input text returns the list of 
        terms recognized in the text, including their exact location (annotations).
        
        Given an ontology (owl file) MER is also able to link the entities to their classes.
        
        More information about MER can be found in:
        - MER: a Shell Script and Annotation Server for Minimal Named Entity Recognition and Linking, F. Couto and A. Lamurias, Journal of Cheminformatics, 10:58, 2018
        [https://doi.org/10.1186/s13321-018-0312-9]
        - MER: a Minimal Named-Entity Recognition Tagger and Annotation Server, F. Couto, L. Campos, and A. Lamurias, in BioCreative V.5 Challenge Evaluation, 2017
        [https://www.researchgate.net/publication/316545534_MER_a_Minimal_Named-Entity_Recognition_Tagger_and_Annotation_Server]
        
        
        ## Documentation
        
        https://merpy.readthedocs.io/en/latest/
        
        ## Dependencies
        
        ### awk
        
        MER was developed and tested using the GNU awk (gawk) and grep. If you have another awk interpreter in your machine, there's no assurance that the program will work.
        
        For example, to install GNU awk on Ubuntu:
        
        ```
        sudo apt-get install gawk
        ```
        
        ## Installation
        ```bash
        pip install merpy
        ```
        or
        
        ```bash
        python setup.py install
        ```
        
        Then you might want to update the MER scripts and download preprocessed data:
        ```python
        >>> import merpy
        >>> merpy.download_mer()
        >>> merpy.download_lexicons()
        ```
        
        ## Basic Usage
        
        ```python
        >>> import merpy
        >>> merpy.download_lexicons()
        >>> merpy.process_lexicon("hp")
        >>> document = 'Influenza, commonly known as "the flu", is an infectious disease caused by an influenza virus. Symptoms can be mild to severe. The most common symptoms include: a high fever, runny nose, sore throat, muscle pains, headache, coughing, and feeling tired'
        >>> entities = merpy.get_entities(document, "hp") # get_entities_mp uses multiprocessing (set n_cores param)
        >>> print(entities)
        [['111', '115', 'mild', 'http://purl.obolibrary.org/obo/HP_0012825'], ['119', '125', 'severe', 'http://purl.obolibrary.org/obo/HP_0012828'], ['168', '173', 'fever', 'http://purl.obolibrary.org/obo/HP_0001945'], ['214', '222', 'headache', 'http://purl.obolibrary.org/obo/HP_0002315'], ['224', '232', 'coughing', 'http://purl.obolibrary.org/obo/HP_0012735'], ['246', '251', 'tired', 'http://purl.obolibrary.org/obo/HP_0012378'], ['175', '185', 'runny nose', 'http://purl.obolibrary.org/obo/HP_0031417']]
        >>> lexicons = merpy.get_lexicons()
        >>> merpy.show_lexicons()
        lexicons preloaded:
        ['lexicon', 'go', 'cell_line_and_cell_type', 'chebi_lite', 'chemical', 'hp', 'disease', 'wordnet_nouns', 'hpo', 'radlex', 'doid', 'protein', 'hpomultilang', 'tissue_and_organ', 'mirna', 'subcellular_structure']
        
        lexicons loaded ready to use:
        ['lexicon', 'doid', 'hp']
        
        lexicons with linked concepts:
        ['doid', 'hp', 'go', 'chebi_lite', 'lexicon']
        >>> merpy.create_lexicon(["gene1", "gene2", "gene3"], "genelist")
        wrote genelist lexicon
        >>> merpy.process_lexicon("genelist")
        >>> merpy.delete_lexicon("genelist")
        deleted genelist lexicon
        >>> merpy.download_lexicon("https://github.com/lasigeBioTM/MER/raw/biocreative2017/data/ChEBI.txt", "chebi")
        wrote chebi lexicon
        >>> merpy.process_lexicon("chebi")
        
        
        ```
        
Keywords: ner,mer
Platform: UNKNOWN
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Description-Content-Type: text/markdown
Provides-Extra: dev
