IntroductionExamplesDocumentationDownloadLinksContact
 

Glossary of the main terms used in neuroConstruct

3D View of Cells - Abstract Cell - Abstracted Cell Mechanisms - Action Potential Propagation Speed - Anti Aliasing - Arborization Defined Connection - ASC - Axes in 3D - Biophysical validity - Cell density mechanism - Cell Group - Cell Group Priority - Cell Mechanism - Cell Type - Channel Mechanism - ChannelML - Compartmentalisation - Cvapp - Data Set - Data Set Manager - Electrotonic length - File based Cell Mechanisms - Finite volume Segment - GENESIS - GENESIS Compartmentalisation - Glomerulus - Graph - Group - HDF5 - Internal number of divisions - Ion Concentration - MorphML - Morphological validity - Morphology Based Connection - Morphology save format - Network Connection - NetworkML - Neurolucida - NeuroML - NEURON - NMODL - nseg - Packing Pattern - Parallel computing support - Plot/Graph - Plot Frame - Project - Project validity - Python - Region - Section - Section Group - Segment - Simply Connected cell - Simulation Configuration - SWC - Synaptic Connection Location - Synaptic Mechanism - Tool Tips - Validity checks - Variables to plot/save - Volume Based Connection - XML - Zipped Project -

3D View of Cells

When a single cell is viewed in 3D (at tab Visualisation, select the name of the Cell Type in the drop down box and press View) there are a number of actions possible:

  • Left click anywhere in the view and drag to rotate the cell
  • Right click anywhere and drag to translate the cell
  • Clicking the middle mouse button and dragging (or turning the middle wheel) will zoom the view. Note that if there is no middle button, there is a zoom slider bar on the GUI
  • Pressing the 0 button will reset the view, usually centering on the cell
  • Pressing the ^ button will open a window in full screen with just the 3D objects (good for capturing screenshots)
  • Left clicking on one of Segments will highlight that segment (red) and any other segments in the same Section (yellow) (only when All solid is selected)
  • When a Segment is selected, a summary of the 3D information on it appears, and the endpoints, etc. can be altered by pressing the Edit... button
Specifying Section Groups allows different subsections of the cell to be assigned as dendrites, etc. and can be used to colour regions of the cells. When multiple cells are being displayed (e.g. when Latest Generated Positions is selected, or a simulation is reloaded) the following options are also possible:
  • Clicking on part of a cell highlights that cell. Note this is easiest when the level of detail displayed is All Solid (see below). Selecting cells can also be difficult is other objects are close, e.g. transparent regions, synaptic endpoint spheres, 3D axes (turn some of these off via 3D Settings). If a cell can't be selected by clicking, the cell group and cell number can be selected in the drop down boxes.
  • Multiple cells in a cell group can be selected too via the drop down boxes (e.g. all cells, a percentage of cells, etc.). These can then be plotted together as a group if a previous simulation has been loaded.
  • When one or more cells are selected, checking the Transparent mode box keeps that/those cell opaque, makes cells it is/they are connected to partially transparent and turns other cells almost completely transparent.
There are a number of settings which can be changed by pressing the 3D Settings button:
  • The background colour and preferred cell segment colour
  • Whether the 3D axes will be shown.
  • The resolution of 3D elements. Note for better 3D performance when viewing large cells/networks this should be set low (<12)!
  • A number of items can be excluded or included from the 3D view, e.g. Regions (when viewing generated networks), Inputs, Synaptic Endponts (green for presynaptic location, red for post), etc.
  • The level of detail to display (see below)
The default view for 3D cells is to show all the segments in full solid detail (spheres or cylinders/truncated cones). However this can be too much detail to show on many machines for large cells. The following options allow different views of the cells, either at reduced details, or transformed for a particular simulator:
  • All solid: all segments are seen in 3D detail. Note the resolution of these can be increased or decreased under 3D Settings
  • Soma solid, neurite lines: segments in the soma group are solid, all other segments are lines through their centres
  • Soma solid, no neurites: just the soma segments are shown in 3D
  • All lines: all segments are represented by lines
  • Original Compartmentalisation: a transparent view of the cell, showing the segments in 3D, white lines through their centres, blue spheres for their end points, and yellow lines linking segments which are electrically connected, but not physically linked. There will be a red sphere in the middle of each of the internal divisions, with small blue spheres connecting them. These red spheres correspond to the simulated points in NEURON as defined by the nseg value.
  • GENESIS Compartmentalisation: this is a Compartmentalisation of the cell which converts it to a smaller number of compartments for GENESIS but retains the section groups, total surface area, total dendritic length and total axial resistance.
Note: see points on allocating extra memory for the application here, which will be important when displaying large networks in 3D. Also, there is sometimes excessive flickering when showing 3D on Windows (a common problem when mixing Java3D and Swing, see here), try updating the drivers for your graphics card, or adding -Dsun.java2d.noddraw=true to the command in nC.bat.

index

Abstract Cell

A Cell Type which represents a real neuron, but whose morphology is described with a much reduced number of segments. These types of cells are useful for investigating basic electrophysiological properties of cells, or in large networks, where simpler individual cells are needed to reduce simulation time. These cells can be created manually by adding a Cell Type based on the included examples (e.g. SimpleCell), viewing in tab Visualisation, clicking on one of the segments, and pressing Edit....

index

Abstracted Cell Mechanisms

A Cell Mechanism which has been split between model template and parameters, allowing easy mapping onto each of the available simulation platforms. Note: This is a pre-ChannelML approach to implementing Cell Mechanisms and shouldn't be used anymore.

index

Action Potential Propagation Speed

While the 3D structure of axons is important for creating the correct connectivity (e.g parallel fibers in cerebellar granule cells) the segments representing these axons need not necessarily be explicitly modelled, indeed physiological data on the channels present etc. can be quite difficult to obtain. Instead an average value for the speed of propagation of the Action Potential can be used for these segments, with the axonal propagation delay (calculated using the distance along the segments to the last fully modelled segment) added to the internal synaptic mechanism delay. To specify sections which should be modelled using Action Potential Propagation Speeds, select Cell density mechanism in the drop down box when viewing a single cell in the Visualisation tab. Note that reducing the number of explicitly modelled segments will reduce the simulation runtime.

index

Anti Aliasing

If anti-aliasing is turned on, 3D renderings of both solid compartments and line segments will be smoother. This may have some performance overhead on some video cards, or may prevent the 3D view from displaying, and so should be turned off.

index

Arborization Defined Connection

See Volume Based Connection.

index

ASC

The file ending given to morphologies saved in the file format used by Neurolucida.

index

Axes in 3D

A set of axes can be added in 3D (either when a single cell is being displayed or a generated network). The green axis represents the x direction, the yellow the y direction and the red the z direction. The axes measure 100 microns from the origin in positive and negative directions, the arrow on the positive. The ticks are at 10 micron intervals. Due to perspective the axes should only be used for getting bearings/a concept of scale in the 3D scene.

index

Biophysical validity

A number of checks can be carried out on the cells in a project to ensure they meet some minimum requirements for producing realistic results in the chosen simulators. It is not a complete list. At the moment these checks are:

The following checks, when failed, lead to warnings:
  • At most one passive conductance on a segment (more than one can lead to erroneous calculations of Electrotonic length)
The intention is to expand these checks to make it easier for non/new computational neuroscientists to catch some common errors when creating cell models. If there are any suggestions for checks to be made, please get in touch.

index

Cell density mechanism

A term used to describe the mechanisms which can be applied to cell segments to allow simulation of electrophysiological mechanisms. Density refers to the fact that the effect of the mechanism is dependent on the physical size (surface area/length) of the segment. A Channel Mechanism is specified as a conductance per unit area, or alternatively an Action Potential Propagation Speed measures the rate of propagation of signals along a segment to synaptic connections. Specific capacitance and specific axial resistance can be specified on a per group basis also. To specify which cell density mechanisms are present on a cell, select Cell density mechanism in the drop down box when viewing a single cell in the Visualisation tab.

index

Cell Group

A number of cells of the same Cell Type positioned in 3D space. These will be laid out relative to a specified Region and arranged according to a Packing Pattern. Only Cell Groups included in the selected Simulation Configuration will be generated.

index

Cell Group Priority

Specifies the order in which Cell Groups are placed. Higher priority Cell Groups are always placed first.

index

Cell Mechanism

A general term for an electrophysiological process (currently either a Channel Mechanism, a Synaptic Mechanism or an Ion Concentration) which is placed on modelled cell membranes or at the interface of two cells to alter their internal electrical and chemical state. More on Cell Mechanisms in the main documentation.

index

Cell Type

A prototype cell containing information on its 3D morphology and the various Cell density mechanisms which determine its electrophysiological behaviour. Each Cell Group specifies a particular Cell Type and from these networks are built. Cell Types can be hard-coded (e.g. Simple Cell, Purkinje Cell) (which can form the basis of manually edited Abstract Cells) or ones based on imported morphology files, e.g. using GenesisMorphReader where a morphology file (ending in .p) as used in GENESIS is specified (more on importing morphologies). A Cell Type can be checked for validity. More on Cell Types in the main documentation

index

Channel Mechanism

An implementation of a model of an electrophysiological process (e.g. a voltage gated ion channel, ion pump, etc.) which is placed on modelled cells' membranes to alter their behaviour. For NEURON these are usually implemented in NMODL. The preferred way to specify these in neuroConstruct is with a ChannelML file.

index

ChannelML

ChannelML is a language (using XML technologies) for specifying the dynamics of various subcellular processes (Channel Mechanisms, Synaptic Mechanisms, etc.) which are present on biologically detailed model neurons. It is a part of Level 2 of NeuroML. The ability to model these types of mechanisms is one of the key features of platforms like NEURON or GENESIS, but the implementation of the mechanisms is far from trivial, requiring both knowledge of the physiological processes and of a low level programming language. ChannelML seeks to separate the electrophysiological data from any specific implementation, defining a template for numerous types of cellular mechanism, containing only the relevant biophysical parameters (e.g. reversal potentials, (in)activation rate equations) which can be automatically validated for completeness. These files can then be mapped to script files in the language of the target simulator for inclusion in cell models. The format for valid ChannelML files is described in an XML Schema document. Examples of valid ChannelML files and mappings to simulators can be found here, and detailed specifications of the elements allowed in a ChannelML document are available here. A description of the current support for MorphML and NeuroML in general in neuroConstruct is available here and details of the process to convert an existing channel script, e.g. a mod file, to ChannelML is outlined here.

index

Compartmentalisation

Imported morphologies (e.g. Neurolucida files) may not always be in the most efficient spatial discretisation for a particular simulator (a number of 3D points/diameters can be specified along an unbranched dendrite to describe the structure, but these will lead to many segments in a simulator which maps all segments to individual compartments). A Compartmentalisation is a reorganisation of the structure of segments/sections to retain as many of the properties the cell which are important for electrophysiological simulations (total membrane area, total axial resistance along branches, total length etc.) but enables mapping on to a smaller number of simulated compartments. See GENESIS Compartmentalisation. The various Compartmentalisations can be visualised in 3D, see 3D View of Cells.

index

Cvapp

This Java application, developed by Robert Cannon, allows transformation between various morphology formats (e.g. from Neurolucida to NEURON or GENESIS), editing of loaded morphologies, along with other functions for cleaning up and optimising morphology files. It also has its own file format (stored in *.swc files). More information here. The Neuromorpho database uses SWC as the format for it's curated morphologies.

index

Data Set

Set of x, y values which can be plotted in a Plot Frame, saved in the Project (for reloading through the Data Set Manager), exported, etc. The x values do not have to be evenly spaced, unique or sequential. See here for information on what variables can be saved/plotted during a simulation run.

index

Data Set Manager

A number of Data Sets can be stored in a neuroConstruct Project, showing a concept illustrating a point about the model, e.g. an I-F curve derived from a number of simulation runs. When a Data Set is viewed in a Plot Frame the points can be saved to the project. The Data Set Manager allows these saved Data Sets to be viewed, edited, and redisplayed in a new (or any open) Plot Frame

index

Electrotonic length

This measure of the length of dendrites, etc. as "seen" by electrical charge is dependent on the shape, axial and membrane resistance of the section. See the NEURON or GENESIS books for more details. It is important when simulating neurons with realistic morphologies that individually simulated points are not too far apart in terms of electrotonic length (a max of 0.1 is usually fine, though much smaller is needed if trying to match the behaviour of morphologically complex cells between simulators), i.e. a sufficiently fine-graned spatial discretisation should be used. Too short an electrotonic length can sometimes lead to problems in numerical integration, and neuroConstruct will perform validity checks for both of these (too long and too short). To correct the internal number of divisions in a Section to stay below a maximum electrotonic length, e.g. on an imported morphology, visualise the cell in 3D, showing all solids, click on any section, then Edit... and either manually set the parameter for each Section or select the Remesh option in the drop down function selector. See also the note about Compartmentalisations. Note that electrotonic length is dimensionless, and the term space constant is used for this measure in microns (see GENESIS book, or Rall's chapter in Koch and Segev 1989).

index

File based Cell Mechanisms

A Cell Mechanism whose functionality is hard coded in a native simulation environment's scripting language, e.g a mod file for NEURON or a GENESIS script file containing a single Cell Mechanism. Note: there can be a script for each simulation environment associated with the Cell Mechanism, but it is up to the modeller to ensure they produce the same results. Details on how to modify native script files for inclusion in neuroConstruct cells is available in the main documentation

index

Finite volume Segment

A Segment on a Cell in neuroConstruct, which for the purposes of packing is considered to take up space. Normally, only Segments in the soma are considered space filling, and will be packed to avoid each other. Dendrites and axons are ignored in packing as it would normally be impossible to get these well packed taking into account the dendritic arborisations. If large Sections in a specific cell need to be treated differently (e.g. a Glomerulus), these Segments can be specified as having finite volume

index

GENESIS

GENESIS is a general purpose simulation platform which was developed to support the simulation of neural systems ranging from complex models of single neurons to simulations of large networks made up of more abstract neuronal components. The main tasks of actually simulating what goes on inside the neurons of a network built with neuroConstruct is carried out by simulation packages such as GENESIS. GENESIS is available for download here.

index

GENESIS Compartmentalisation

This Compartmentalisation for the GENESIS platform is needed since a simple mapping of each Segment in a detailed neuronal reconstruction to a compartment for running on GENESIS would lead to too great a spatial discretization. This Compartmentalisation maps the n Segments in each Section on to two CYLINDRICAL Sections each of half the original Section length, with the radii chosen to preserve total curved surface area and total axial resistance along the length. For sections with large electrotonic length, and which have an internal number of divisions (nseg) greater than 2, these cylinders will be split accordingly (e.g for num int divs = 7 or 8, the 2 cylinders will be split in 4 each).

index

Glomerulus

Glomeruli are present in many areas of the CNS. Post synaptic connections from a number of cell types converge on a single point on a cell axon. An example would be the Mossy Fiber rosette in the cerebellum, where Granule cell dendrites, Golgi Cells axons and dendrites synapse on boutons on the Mossy Fiber axon.

index

Graph

See Plot/Graph

index

Group

See Cell Group or Section Group.

index

HDF5

HDF5 is a binary file format used for exchanging large amounts of structured data between software applications, widely used in the astrophysics community, among others. Libraries for development and an application, HDFView, for viewing the contents of HDF5 files can be obtained here here. This format is envisioned to be a useful alternative to text files or XML when exchanging voltage trace (or spike time) data, or network structure information (see NetworkML) between computational neuroscience applications.

index

Internal number of divisions

A Section (in neuroConstruct) can consist of a long list of 3D point/diameters (Segments). Not all of this 3D information is relevant when modelling the Sections, sometimes just the surface area/axial resistance at a point is sufficient for modelling the dendrite. This is the approach NEURON takes modelling cables/sections. For long sections, it is possible to specify a number of internal divisions, and the membrane potential at each time step is calculated at the centre of each of these divisions (this is also known as setting the spatial discretisation of the morphology). The term nseg is used for this number in NEURON (see details in the NEURON book). It is also possible to set this parameter for Sections in neuroConstruct. View the cell in 3D (All solid), click on a segment, click Edit..., and in the second drop down box, select Section details. The number of internal divisions can be chosen automatically too (especially convenient for imported detailed morphologies, after the passive electrical properties are set), see electrotonic length. See information too on Compartmentalisations.

index

Ion Concentration

A term used for a mechanism describing how the internal concentration of an ion alters. An example would be a pool of calcium, which decays to a resting value.

index

MorphML

MorphML is an language which has been developed (using XML technologies) to allow data on cell morphologies to be easily transferred between neuronal simulation applications. More information is available here. It is a part of the NeuroML initiative, and is the core of NeuroML Level 1. Detailed specifications of the elements allowed in a MorphML document are available here. There has been a paper describing this part of the NeuroML language. A description of the current support for MorphML and NeuroML in general in neuroConstruct is available here.

index

Morphological validity

For a cell with multiple Sections and Segments, to be considered valid i.e. in a form that will produce sensible, similar 3D morphologies in each of the simulators we deal with it should meet the following criteria (not a complete list):

  • Only one segment without a parent (root segment)
  • All segments have sections
  • All segments have endpoints
  • All Segment IDs unique
  • All Segment names unique
  • All Section names unique
  • Segments after the first in a section are only connected to 1 on parent
  • At most one segment is spherical and is in the Section Group soma_group
  • At least one segment present in cell
  • At least one soma section, i.e. section which is in group soma_group
  • Cell name present
The following checks, when failed, lead to warnings (due to potential problems when packing, for example):
  • First soma segment is at origin
  • Start point matches point at specified fraction along parent
  • Cell is a Simply Connected cell
  • Each section is part of one of: soma_group, axon_group, dendrite_group

index

Morphology Based Connection

This type of Network Connection is appropriate for connecting cells where the axon of the presynaptic cell is well stereotyped and does not vary significantly between cells (e.g. parallel fiber of cerebellar granule cell). Cell axons can be created in 3D and a sub set of its sections allowing a certain type of Synaptic Mechanism can be specified. For single compartment cell models this type of Network Connection is most appropriate, Section Group all can be used for each synapse.

index

Morphology save format

There are two possible ways to save morphologies in neuroConstruct projects, both based on a mapping from the set of Java classes describing the cell internally in neuroConstruct:

  • XML based Java serialisation (*.java.xml files): a mapping to an XML file of the classes. Note: not any part of NeuroML.
  • Serialised Java object form (*.java.ser files): a serialised representation of the Java classes.
The second of these is quicker to load and save and the files are smaller. The first however can be opened (and edited!) with a text editor. Change which format to use via Settings -> General Properties & Project Defaults/Project properties. Cell morphologies are stored in the morphologies directory of the project home directory. *.bak files in that dir backup the previously stored morphology before a new one is saved (if a problem occurs saving a morphology, close the application, remove the .bak from the name of the morphology file to use the previous structure of the cell when reloading the project). Note that the cells aren't currently stored in neuroConstruct projects in NeuroML/MorphML format, since new functionality is usually added to the neuroConstruct Cell class before it is supported in the specifications.

index

Network Connection

A connection between a number of points on cells in one Cell Group to points in another Cell Group. Some of the factors which need to be specified are:

  • Source Cell Group: (Presynaptic cells)
  • Target Cell Group: (Post synaptic cells)
  • Synaptic Properties: Which Synaptic Mechanism (under tab Cell Mechanism) defines the synapse, the delay, threshold and weight
  • Method of searching for a connection point (random, closest, etc.)
  • Maximum and minimum lengths of the connection
  • Various conditions on the number of connections to make between the Cells Groups
There are two main types of Network Connection: Morphology Based Connection and Volume Based Connection More on Network Connections in this tutorial.

index

NetworkML

NetworkML is a language (based on XML technologies and a HDF5 equivalent in development) to allow data on cell placement and connectivity in 3D to be easily transferred between neuronal simulation applications. More information is available here. It is a part of the NeuroML initiative, and is the core of NeuroML Level 3.

index

Neurolucida

A product by MicroBrightField Bioscience which is a system for "3D neuron reconstruction, serial section reconstruction, and anatomical mapping". It is a popular product for creating 3D morphological reconstructions of neurons with complex dendritic trees (although this is not the only functionality). A number of databases exist containing neuronal information in the file format used by these products (see Neuromorpho.org). neuroConstruct can import these files and extract the morphological information to use as the basis of detailed single cell models. See here for more information/limitations.

index

NeuroML

NeuroML, the Neural Open Markup Language, is a model development language in XML that provides a common data format for defining and exchanging descriptions of neuronal cell and network models. Currently, there are three Levels of compliance to the NeuroML specifications:

  • Level 1 provides a common data format for neuronal morphology data and metadata. MorphML forms the main part of the specification at this Level.
  • Level 2 builds on Level 1 to include specifications for describing passive membrane properties, and the distributions of channels on neuron models. The dynamics of ion channels, synapses, and ion concentration mechanisms can also be described at this Level in ChannelML
  • Level 3 allows networks of cells to be described, either in template form (from which networks can be generated) or as explicit descriptions of cell placement and synaptic connectivity. The core of this Level is described in NetworkML. neuroConstruct can save generated networks in NetworkML, and load NetworkML files from any other application to use in simulations, provided the cell type/group/network connection names match those in the project.
More information on NeuroML is available here, and a web interface for checking the validity of any NeuroML file is here. A description of the support for NeuroML in neuroConstruct is here.

index

NEURON

NEURON is a simulation environment for developing and exercising models of neurons and networks of neurons. The main tasks of actually simulating what goes on inside the neurons of a network built with neuroConstruct is done by simulation packages such as NEURON. The package is available for download here. More on importing NEURON models in the main documentation, and information on the interaction between neuroConstruct and NEURON on various platforms can be found here.

index

NMODL

Channel Mechanisms and Synaptic Mechanisms can be created in NMODL, and these can be placed in the cells in NEURON simulations. More info available here. See here for details on use of NMODL (*.mod) files in neuroConstruct.

index

nseg

A NEURON section property. See Internal number of divisions.

index

Packing Pattern

When cells are placed in a Region, the somas need to be arranged in a particular pattern. In neuroConstruct, some of the available patterns are:

  • Random: Cells are placed in random locations in the Region
  • Cubic Close Packed: Cells are placed in Cubic Close Packed formation. A layer is placed in 2D first and the spheres in the next layer lie on top, at the center of the 4 spheres underneath, touching each. This is optimal packing of spheres in 3D
  • Simple Regular: The cells are placed in layers with cell centres directly above each other
  • Single Placed Cell: A single cell is placed in an exact location in the Region (or relative to the origin)
  • Hexagonal: The cells are placed in a single layer in a hexagonal pattern (each soma is surrounded by 6 other somas at equal angles)
  • One Dimensional Regular Spacing: The cells are placed at regular intervals in a straight line
Note that for each of these packing patterns a number of variables need to be specified, besides the Region, e.g. the number of cells to place, extra cell spacing whether to avoid existing cells from this (or other) Cell Groups. New packing patterns can be added by extending the Java class CellPackingAdapter.

index

Parallel computing support

Support for generation of networks for execution in parallel computing environments is in development, concentrating on Parallel NEURON over MPI at present. As documentation for this is currently limited, please get in touch for more details.

index

Plot/Graph

These terms are used in various ways by NEURON and GENESIS for a) the frame/window showing a number of sets of data and b) the individual sets of points in each trace. In neuroConstruct, Data Set is used for a set of points which can be plotted, and Plot Frame is used for the window in which a number of these can be viewed. In the Input/Output tab, the second table lists the values to to be plotted during a simulation run. For example, the membrane potential of a subset of cells in each group could be plotted. Note that here too is where variables to be saved during the simulation are specified, e.g. all cells' membrane potential could be saved but just one specified to be plotted, etc. The names to use for variables to plot and/or save are given here

index

Plot Frame

The window in which a number of Data Sets can be viewed. Each Plot Frame has a name and new Data Sets can be added to existing Plot Frames. The Data Sets can be viewed in a number of different ways: all graphs using the same axes, graphs stacked vertically, zoomed in to user selected area, etc. Each Data Set is listed and can be individually analysed (e.g. for mean/std dev values, spiking rates calculated) or the format (colour/point type) edited. See here for information on what variables can be saved/plotted during a simulation run.

index

Project

In neuroConstruct, a Project contains the specification of the Cell Types, Regions, Cell Groups and Network Connections in a model, along with the simulation parameters (duration, dt, etc.) and inputs into the network. A Project can be used to generate networks using combinations of these cells/connections etc. in different Simulation Configurations. Also associated with a Project are a number of Previous Simulations, i.e. recorded simulations run in a simulation environment (e.g. NEURON) which are available for replaying when the project is opened. The main project file (*.neuro.xml) is a proprietary XML file (not part of NeuroML), which should only be opened with neuroConstruct (though some minor manual edits are possible if you're careful...). A Project and all of its associated files (morphology files, simulation files, etc.) can be zipped up through the GUI for easy distribution.

index

Project validity

To catch many, but not all, potential sources of error in a project a number of validity checks are performed. These include checks on the morphology and biophysical parameters of each of the cells in the project, and various global checks on the project settings, e.g. appropriate temperature, electrical input or network connection to all cell groups, etc.

index

Python

Python is a scripting language which is becoming increasingly widely used in computational neuroscience. Details of the support for Python in neuroConstruct can be found here.

index

Region

A volume in 3D space which can be filled with cells. These regions can be also used for specifying bounding regions for selecting cells, e.g. to selectively apply stimulations, or to aid in analysis of a subset of cells. In the current version of neuroConstruct, regions can be either rectangular boxes, spheres, cylinders or cones. More on Regions in the main documentation

index

Section

An unbranched part of a cell morphology, corresponding roughly to the concept of a section in NEURON. An example would be a non bifurcating dendritic section, or the soma. Each Section contains at least one Segment. The Section provides the start point and start radius, and each of the Segments has an end point and radius corresponding to the 3D points along the Section. Sections which have similar properties can be assigned to one or more Section Group. All of the Segments in a Section are also in these Groups. Note that a Section is referred to as a cable in MorphML. A Section is mapped to a section in NEURON, and the start point of this and endpoints of the Segments become the pt3d points along it. GENESIS only has the concept of a compartment, so the Segments are each mapped to a compartment as a default (but see GENESIS Compartmentalisation). See the NeuroML Level 1/MorphML paper for more details of the mapping to the different simulation environments.

index

Section Group

A group of Sections sharing some properties. These can be used to specify the Channel Mechanisms placed on areas of the cell (e.g. apical dendrites), or the locations where specific Synaptic Mechanisms are allowed (see Synaptic Connection Location). There are four special groups:

  • all: every Section is included in this Group
  • soma_group: The Group containing only one Section, representing the soma
  • dendrite_group: The Group of dendritic Sections
  • axon_group: The Group of axonal Sections
Every Section is part of one and only one of the last 3 Groups. Sections in groups whose names start with colour_, e.g. colour_Yellow, will be coloured as such in the single cell 3D view (these colourings may come from morphology files, e.g. Neurolucida format).

index

Segment

The basic unit of the morphological description of the cell. Segments correspond to the concept of a compartment as used in GENESIS. One or more Segments go to make up a Section, which maps to a cable in simulation environments using that concept (e.g. the section in NEURON, where the start point of the Section, and the Segment end points provide the pt3d points along the section). A Segment has a unique name, an end point, a pointer to its Section, a pointer to its parent Segment, and a value for the fraction (0 to 1) of the parent Segment's length at which it's connected. The first Segment in a Section can be connected at a point between 0 and 1 along its parent segment (which will be in another section) but all other segments need to be connected at the 1 point to their parent. Note: there is a difference with how NEURON handles sections, they specify the 0 to 1 point of connectivity along their parent section. When there are n Segments in a Section in neuroConstruct, this will translate to a NEURON section with n+1 pt3d points. See Section and the NeuroML Level 1/MorphML paper for more details of the mapping to the different simulation environments.

index

Simply Connected cell

A Cell where each Segment is connected to either the start of end point (0 or 1) of its parent

index

Simulation Configuration

Most neuroConstruct Projects will illustrate not just a single aspect of a cell or network, but will seek to show how the cells react under different inputs, or how a network behaves with different Cell Groups/cell populations present, etc. A particular Simulation Configuration has a number of Cell Groups, Network Connections, Electrical Inputs, and Plots associated with it, along with a simulation duration. As an example, a project accompanying a publication might have one Simulation Configuration for each figure in the paper. More on Simulation Configurations in the main documentation

index

SWC

The file ending given to morphologies saved in the file format initially developed for Cvapp.

index

Synaptic Connection Location

A Synaptic Mechanism can be associated with a list of Section Groups. This means that any of the Sections in those Groups can be involved in a Network Connection involving the Synapse type. Note: Each of the Sections will also be a member of either soma_group, dendrite_group or axon_group. A PRE synaptic connection location is allowed on Sections in soma_group or axon_group while a POST synaptic connection location is allowed on a Section in soma_group or dendrite_group. See this tutorial for more on Synaptic Connection Locations and Network Connections

index

Synaptic Mechanism

An implementation of a model of synaptic transmission. This is a subtype of a Cell Mechanism. Usually this involves an event in one cell influencing the conductance at a point in another cell. For NEURON these are usually implemented in NMODL. Synaptic Mechanisms are needed to specify a Synaptic Connection Location on a cell.

index

Tool Tips

These appear when the cursor hovers over certain buttons, panels, checkboxes, etc. and provide hints on usage. They can be turned off via Settings -> General Properties & Project Defaults or by clicking on the button in the main toolbar.

index

Validity checks

Due to the large number of parameters present in a simulation of a network of realistic neurons, a number of automated checks have been created to help ensure sensible data is being given to the simulators. Note that these are *not complete* and there is still plenty of opportunity for "garbage in, garbage out". There are checks on:

  • Morphological validity: the structure of the cells in the project are valid
  • Biophysical validity: the cells in the project have minimal/sensible biophysical properties set
  • Project validity: the above two checks are performed on each of the cells in the project along with a number of other tests
Note: projects/cells will work and native scripts can be generated even when not valid, but the simulation results should be treated as suspect.

index

Variables to plot/save

Variables which change during the simulation can be specified to be plotted and/or saved for later display in neuroConstruct via the Input/Output tab. Variables have different names in each of the simulation environments (e.g. v or Vm), so a set of generic names of the most common interesting values has been defined:

  • VOLTAGE for the membrane potential (v in NEURON, Vm in GENESIS)
  • SPIKE can be used to record spike trains, as opposed to voltage at every timestep, e.g. SPIKE:-20 sets the spike threshold to -20mV
To plot a value present on a Cell Mechanism, use a colon, e.g. NaConductance:m. Note, as the gate activation variables are a special case, GENESIS will search through the list of gates (only if the Cell Mechanism is defined by a ChannelML file), search for a gate with the specified name, and plot that variable. See Ex4-NEURONGENESIS for an example. Other named variables that can be plotted for Cell Mechanisms are:
  • CONC for the concentration of an ion, e.g. CaPool:CONC:ca
  • REV_POT for the reversal potential of an ion, e.g. NaConductance:REV_POT:na
  • CURR_DENS for the current density through a channel, e.g. NaConductance:CURR_DENS:na
  • COND_DENS for the conductance density of a channel, e.g. NaConductance:COND_DENS:na

index

Volume Based Connection

This type of Network Connection is appropriate for connecting cells where the axon of the presynaptic cell is known to make connections within a certain 3D region (e.g. axonal arborisation of cortical pyramidal cell). This region is defined relative to the cell body and dendrites of postsynaptic cells falling within this region allowing the same type of Synaptic Mechanism are candidates for connections. These regions are be specified at tab Visualisation in the single cell 3D view when a segment is being edited (select the appropriate function in the drop down box)

index

XML

Short for eXtensible Markup Language, XML is a specification developed by the W3C. XML uses a similar tag structure to HTML, as used for Web documents. However, it allows designers to create their own customised tags, enabling the definition, transmission, validation, and interpretation of data between applications and between organisations. It is useful in the context of neuroscience when it comes to exchanging anatomical data, model descriptions, etc. between research groups and simulation environments and is the technology used in specifying the NeuroML language.

index

Zipped Project

All files in a neuroConstruct Project (morphology files, simulation data, etc.) can be zipped up into a single file for easy distribution/backup. To create a zipped neuroConstruct project select File -> Zip this Project... and to automatically unzip and open a file created in this way, select File -> Import Zipped Project...

index