Metadata-Version: 2.1
Name: bmtool
Version: 0.1.2
Summary: BMTools
Home-page: https://github.com/tjbanks/bmtools
Author: Tyler Banks
Author-email: tbanks@mail.missouri.edu
License: MIT
Description: # bmtools
        A collection of scripts to make developing networks in BMTK easier.
        
        [![license](https://img.shields.io/github/license/mashape/apistatus.svg?maxAge=2592000)](https://github.com/tjbanks/bmtool/blob/master/LICENSE) 
        
        ## Getting Started
        
        **Installation**
        
        ```bash
        pip install bmtool
        ```
        For developers who will be pulling down additional updates to this repository regularly use the following instead.
        ```bash
        git clone https://github.com/tjbanks/bmtools
        cd bmtools
        python setup.py develop
        ```
        Then download updates (from this directory) with
        ```
        git pull
        ```
        
        **Example Use**
        
        ```bash
        > cd your_bmtk_model_directory
        > bmtools
        Usage: bmtools [OPTIONS] COMMAND [ARGS]...
        
        Options:
          --verbose  Verbose printing
          --help     Show this message and exit.
        
        Commands:
          debug
          plot
          util
        
        >  
        > bmtools plot 
        Usage: bmtools plot [OPTIONS] COMMAND [ARGS]...
        
        Options:
          --config PATH  Configuration file to use, default: "simulation_config.json"
          --no-display   When set there will be no plot displayed, useful for saving
                         plots
          --help         Show this message and exit.
        
        Commands:
          connection  Display information related to neuron connections
          positions   Plot cell positions for a given set of populations
          raster      Plot the spike raster for a given population
          report      Plot the specified report using BMTK's default report plotter
        >
        > bmtools plot positions
        ```
        ![bmtools](./figure.png "Positions Figure")
        
        ### Single Cell Tuning
        
        From a BMTK Model directory containing a `simulation_config.json` file:
        ```
        bmtools util cell tune --builder
        ```
        
        For non-BMTK cell tuning:
        ```
        bmtools util cell --template TemplateFile.hoc --mod-folder ./ tune --builder
        ```
        ![bmtools](./figure2.png "Tuning Figure")
        
        ### FIR Curve plotting
        
        ```
        > bmtools util cell fir --help
        Usage: bmtools util cell fir [OPTIONS]
        
          Creates a NEURON GUI window with FI curve and passive properties
        
        Options:
          --title TEXT
          --min-pa INTEGER   Min pA for injection
          --max-pa INTEGER   Max pA for injection
          --increment FLOAT  Increment the injection by [i] pA
          --tstart INTEGER   Injection start time
          --tdur INTEGER     Duration of injection default:1000ms
          --advanced         Interactive dialog to select injection and recording
                             points
          --help             Show this message and exit.
        
        > bmtools util cell fir
        ? Select a cell:  (Use arrow keys)
         Â» CA3PyramidalCell
           DGCell
           IzhiCell
           IzhiCell_BC
           IzhiCell_EC
           IzhiCell_EC2
           IzhiCell_EC_BIO
           IzhiCell_EmoExcitatory
           IzhiCell_EmoInhibitory
           IzhiCell_OLM
           IzhiCell_int
        ```
        
        ![bmtools](./figure3.png "FIR Figure")
        
        ## Planned future features
        ```
        bmtools build
            Create a starting point network
            Download sample networks
        
        bmtools plot
            Plot variable traces
            Plot spike rasters
            X Plot cell positions
            X Plot connection matricies
            
        bmtools debug 
            X list cell types available for single debug
            X Run a single cell in the network
            Isolate a single cell in the network
        ```
        
Platform: UNKNOWN
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Education
Classifier: Intended Audience :: Science/Research
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.6
Classifier: Topic :: Software Development :: Libraries
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Operating System :: OS Independent
Description-Content-Type: text/markdown
