    This is the readme for the models associated with the paper:

    Sekulic V, Chen TC, Lawrence JJ, Skinner FK (2015) Dendritic
    distributions of I h channels in experimentally-derived
    multi-compartment models of oriens-lacunosum/moleculare (O-LM)
    hippocampal interneurons. Front Synaptic Neurosci 7:2

    These files were contributed by V Sekulic.

    This model will also be available in Open Source Brain
    (http://opensourcebrain.org).

    -----------
    MODEL USAGE
    -----------

    Before running the model, compile the mod files appropriately, according
    to your operating system. For example, in Unix/Linux, run the ``nrnivmodl''
    command from within the top-level model directory.

    Then run one of the provided bash scripts in order to load the parameters for
    one of the four models used in the Sekulic et al. (2015) paper, as follows:

    Model R3: ./startup_R3.sh
    Model R4: ./startup_R4.sh
    Model S3: ./startup_S3.sh
    Model S4: ./startup_S4.sh

    Following that, fitted parameters as per Sekulic et al. (2015) may be loaded
    by calling the ``load_file'' function in NEURON, providing as argument one
    of the .ses files in one of the two subdirectory trees:

    04525047--90nA
    04610022--90nA

    The directories correspond to fitted session files against the experimental
    O-LM current clamp recordings for, respectively, cell 4525#4 and 4610#2 (as
    described in the Sekulic et al., 2015 paper).

    The filenames for the session files provide information as to what part of
    the Sekulic et al. (2015) paper they were used for. For instance, the file

    04525047--90nA/uniform-RmGr/dendIh_uni_RmCmTau_Starfish_hD1_3.ses

    was obtained as part of the fitting procedure for uniform ("uni") dendritic
    Ih distributions for the Starfish morphology (S3) with dendritic Ih
    ("hD1"). See ``Session Filename Legend'' below for a catalogue of the
    filename elements to aid in identification of any given session file.

    This session (see figure 3 in the paper) starts with these settings:

    and then after the optimize button is pressed (takes 140 minutes to
    run on a MacBookPro):

    The experimental recordings used for the fitting procedures were obtained from
    the following paper:

    Lawrence, J.J., Statland, J.M., Grinspan, Z.M., and McBain,
    C.J. (2006). Cell type-specific dependence of muscarinic signalling in
    mouse hippocampal stratum oriens interneurones. J. Physiol. 570,
    595–610. doi:10.1113/jphysiol.2005.100875

    The maximum conductance densities of the four models (R3, R4, S3, and S4)
    were selected from highly-ranked models in the ensemble modelling approach
    done as part of the following paper:

    Sekulic, V., Lawrence, J.J., and Skinner, F.K. (2014). Using Multi-compartment
    ensemble modeling as an investigative tool of spatially distributed biophys-
    ical balances: application to hippocampal Oriens-Lacunosum/Moleculare
    (O-LM) cells. PLoSONE 9:e106567. doi:10.1371/journal.pone.0106567

    -----------------------
    SESSION FILENAME LEGEND
    -----------------------

    General structure of filenames (all caps correspond to modifiable elements):

    dendIh_DISTRIB_FITS_MORPHOLOGY_DENDIH_PARAMSET.ses

    The elements can take on the following values:

    Element		Meaning				Possible values
    --------------------------------------------------------------------------
    DISTRIB		The distribution of Ih used	uni - uniform
    						sig - sigmoidal
    						lin - linear

    FITS		Which passive properties	Rm - specific membrane resistivity
    		were fitted (additive; so	Cm - specific membrane capacitance
    		multiple values mean each	Tau - time constant of activation of Ih
    		corresponding property was	Sf - scaling factor (for initial Gh)
    		allowed to vary).

    MORPHOLOGY	Which reconstructed model	Richy - "cell 1" in Sekulic et al (2015) paper
    		morphology was used (these	Starfish - "cell 2" in Sekulic et al (2015) paper
    		were obtained from the
    		Lawrence et al 2006 paper)

    DENDIH		Whether dendritic Ih was	hD0 - no dendritic Ih (only somatic Ih)
    		present				hD1 - somatodendritic Ih present

    PARAMSET	Which rank of the model		3 - rank 3 of the Richy or Starfish database subsets.
    		database from Sekulic et	4 - rank 4 of the Richy or Starfish database subsets.
    		al (2014) the maximum
    		conductance densities of the
    		ionic conductances were
    		obtained from. Used in
    		conjunction with the morphology
    		to determine the model from
    		the database, e.g., R3, S4.

    ------------
    CONTACT INFO
    ------------

    For questions or clarification, please email the primary author of the
    associated paper, Vladislav Sekulic, at vlad.sekulic@gmail.com