Network Connections Tutorial
- Specifying Groups
- Specifying Synaptic Connection Locations
- Specifying packing of Cell Groups
- Creating Network Connections
- Further things to try...
Network Connections in neuroConstruct are made between cells in 2 Cell Groups.
Run neuroConstruct. Click on File -> New Project. Enter the project name and the directory in which to place the main project folder. Click OK Reject the offer to create a few sample objects in the new project.
Add 2 cell types to the project. Go to Cell Types -> Add New Cell Type to Project and specify GranuleCell in the drop down box (naming the cell Granule). Add a PurkinjeCell calledPurkinje also.
Before a Network Connection can be made a Synaptic Mechanism (e.g. a Double Exponential Synapse) needs to be associated with subsets of dendrites/axons on the Cells in these Groups.
To add a new Synaptic Mechanism for the project, go to tab Cell Mechanism -> Add ChannelML from Template and select the Double Exponential Synapse. Enter the name of the Mechanism (e.g. PF_Purk_Syn) and the new mechanism will be opened for editing. You can view the HTML representation of the ChannelML file (1st tab) or the original ChannelML file (2nd tab). Pressing Validate file will validate the XML against the latest XML Schema file describing the content of ChannelML files. Pressing Generate relevant plots creates a plot of the conductance waveform in the file (note the implementation of plot generation is hardcoded in Java for a subset of ChannelML files). The 3rd tab can be used to edit the XML in an external text editor. The 4th and 5th tabs show the XSD files which transform the XML into NEURON and GENESIS format. More info on Cell Mechanisms available here.
Go to the tab Visualisation, select View with the granule cell selected in the drop down box.
Select Groups in the lower right hand drop down box to view the Section Groups. There are four pre defined Section Groups:
- all: Every Section is included in this Group
- soma_group: This Group should contain only one Section, representing the soma
- dendrite_group: The Group of dendritic Sections
- axon_group: The Group of axonal Sections
Network Connections will generally initiate on a Section in either the soma_group or the axon_group, and the connections will generally terminate on a Section in either the soma_group or the dendrite_group. These can be changed at the bottom of the Morphology based connection dialog to allow, e.g. axo-axonic or dendrodendritic connections, which can be quite useful for electrical synapses.
Not every Section of the Cell would be a suitable location of a particular synapse, so other subgroups can be defined which specify where the connections should be made. By pressing Edit Groups, new Section Groups can be made (e.g. basal/apical dendrites, parallel fibers), grouping Sections into biophysically interesting regions of the cell. A Section will always belong to at most one of soma_group, dendrite_group or axon_group.
For the granule cell, click on Edit Groups, add a new group called parallel_fibers, and add the sections parallelFiberPos and parallelFiberNeg to the group.
Specifying Synaptic Connection Locations
Select Synaptic Connection Location in the drop down box. Click Edit Synaptic Locations. The added Synaptic Mechanism (PF_Purk_Syn) should be in the drop down list. Select this and then select the Section Group, parallel_fibers, where the synapse can be found.
It is important to point out again that the PRE synaptic location will be the intersection of the Sections specified in the GUI for presynaptic connections (nromally soma_group or the axon_group, but see above) and the Group(s) selected here. Similarly for the POST synaptic location. Therefore if the Group all is selected as a Synaptic Connection Location, synapses can be made on the axons (PRE), dendrites (POST) and soma (PRE and POST). However if only the Group dendrite_group is selected as a Synaptic Connection Location (or another Group only containing dendrites), then this particular Cell Type will only have POST synaptic connections. Axons on another Cell Type will need to be specified as Synaptic Connection Locations for this Synaptic Mechanism to make a Network Connection.
View the PurkinjeCell now. There should be a group main_dends already defined. Associate this group with the Synaptic Mechanism (PF_Purk_Syn) also.
Specifying packing of Cell Groups
Add 2 regions as in Tutorial 2. Make both rectangular boxes, the first with lower point (0,0,0) measuring 120x50x120 (default values). The second region will automatically be placed on top of this starting at (0,50,0) with the same dimensions.
Add 2 Cell Groups. The first named GranuleCells, associate with the lower region, fill with 12 granule cells (click on Choose... beside Packing Pattern in the New Cell Group dialog and enter 12 beside CellNumber). The Second, PurkinjeCell, place in the upper region, and fill with a single Purkinje cell.
Creating Network Connections
Now that it is specified on which parts of the Cells synapses can be made, Network Connections can be created.
Go to tab Network and click on Add Morphology Connection under Morphology Based Connections.
Select the source Cell Group (GranuleCells) and the Target Cell Group (PurkinjeCell).
Select the Synaptic Properties, including which Synaptic Mechanism is involved in the Network Connection, the voltage threshold which will cause the synapse to fire, the delay after passing the threshold, and the weight of the synapse. These past two values can be given fixed or variable values, in which case a new value will be generated for each instance of the synapse.
Other options include the method for searching for the connection point, the max and min lengths of the allowed connections, and a number of other Connection Conditions. These are explained in more detail in the Tool Tips which pop up when the cursor hovers over the relevant panel/label. Ensure viewing Tool Tips is enabled in Settings -> General Properties & Project Defaults.
Once a Network Connection is specified, generate the network, and view the latest positions in tab Visualisation. You will see the generated Network Connections as lines going from green (PRE synaptic location) to red (POST synaptic location) between the Sections which are connected by the synapse. If the option is selected in 3D Settings a sphere will be placed at each of the Synaptic Endpoints.
Further things to try...
Try adjusting the parameters in the Network Connection. Set max and min values for the lengths of the connections. Distances from pre to post synaptic location can be checked by clicking Analyse connection lengths after generation of the network.
Add more Purkinje cells and see how many connections go to each. Select Analyse number of connections at tab Generate.
Try adding cell mechanisms to the cell as in Tutorial 2, adding input to the Granule cells and running the network. Note these cells are greatly simplified versions of the cells in the cerebellum and are unlikely to show very many of the properties of their biological counterparts. Look at the included examples, e.g. GranuleCellLayer.ncx for more realistic cells.