Metadata-Version: 2.1
Name: deepoc
Version: 1.1.4
Summary: A machine learning tool to classify complex datasets based on ontologies
Home-page: https://bitbucket.org/biomodels/deepoc
Author: Tu Vu
Author-email: tvu@ebi.ac.uk
License: UNKNOWN
Description: 
        # DeepOC
          
        DeepOC is the core of [BioModel Classifier](https://bitbucket.org/biomodels/model-classifier/src/master/) - the python application to classify biomodels automatically using Deep Neural Network. DeepOC provides some very low level functions for classifying model based on ontology, which allow us to adapt to any other projects.
        
        ## Installing
        
            pip install deepoc
        
        ## Usage
        First, you need a ground truth dataset, which is a dict of model and list of it's corresponding ontologies
        
            {
        	    "model_1": ["GO:00001", "GO:00003", "GO:00002"],
        	    "model_2: ["GO:00004", "GO:00002"]
            }
        To generate dataset and train DNN model:
        
            ground_truth = ...
            train_file = "path/to/your train csv file"
            test_file = "path/to/your test csv file"
            val_file = "path/to/your val csv file"
            features = deepoc.build_features(ground_truth)
            
            # Picking the first 300 features  
            selected_features = [feature['feature'] for idx, feature in enumerate(features) if idx < 300]
            
            train, test, val = deepoc.generate_dataset(ground_truth, features, classes)
            
            # Writing dataset to file  
            deepoc.write_dataset_to_file(train, train_file)  
            deepoc.write_dataset_to_file(test, test_file)  
            deepoc.write_dataset_to_file(val, val_file)
            
            # Configure DNN model to use Gradient Descent optimizer, 1 hidden layer with 150 nodes, learning rate of 0.001 and dropout rate of 0.5
            classifier = DeepOCClassifier(workspace, 'GD', [150], 0.001, train_file, test_file, classes, 0.5)
            # Train the model with 3000 epoch, validate every 10 epochs and batch size of 16
            classifier.train_dll_model(3000, 10, 16)
            
            # Validate the result:
            for record in val:
        	    model = record['model']
        	    predict_result = classifier.predict(record)  
        	    logger.info('Model %s: %s', model, predict_result)
        
        More examples can be found in *tests* folder.
        
        ### Classify model based on any ontology other than Gene Ontology
        To make this library work with other kind of ontology, implement the [OntologyService](https://bitbucket.org/biomodels/deepoc/src/master/deepoc/ontology/ontology_service.py) according to your ontology and instantize your object at [https://bitbucket.org/biomodels/deepoc/src/master/deepoc/ontology/__init__.py](https://bitbucket.org/biomodels/deepoc/src/master/deepoc/ontology/__init__.py) 
        
        ## Developers
        
        -   [Vu Tu](https://bitbucket.org/vmtu)
        
        ## Contact
        
        ## Licensing
        
        Biological Model Classifier source code is distributed under the GNU Affero General Public License.  
        Please read  [license.txt](LICENSE)  for information on the software availability and distribution.
Platform: UNKNOWN
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: GNU Affero General Public License v3
Classifier: Operating System :: OS Independent
Description-Content-Type: text/markdown
