Skip to content

Commit

Permalink
Add step-by-step guides to GettingStarted page
Browse files Browse the repository at this point in the history
  • Loading branch information
pgleeson committed Oct 24, 2023
1 parent 5cc0446 commit 0c3d9f5
Showing 1 changed file with 23 additions and 7 deletions.
30 changes: 23 additions & 7 deletions source/Userdocs/GettingStarted.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,12 +2,28 @@
# Getting started with NeuroML

The best way to understand NeuroML is to work through NeuroML examples to see how they are constructed and what they can do.
In this chapter, we will step through increasingly complex models to see how they are written and simulated using NeuroML.
We present below a set of step-by-step guides to illustrate how models are written and simulated using NeuroML.

To stress that **Python** is the suggested language for developing, simulating, and analysing NeuroML models, we will limit ourselves to the Python NeuroML tools only: {ref}`libNeuroML <libNeuroML>` and {ref}`pyNeuroML <pyNeuroML>`.
You can learn more about the different NeuroML tools in their {ref}`specific sections <userdocs:software>`.
<table>
<tr>
<td><a href="https://docs.neuroml.org/Userdocs/SingleNeuronExample.html"><img src="../_images/example-single-izhikevich2007cell-sim-v.png" height=150 title="Guide 1"/></a>&nbsp;&nbsp;</td>
<td><a href="https://docs.neuroml.org/Userdocs/IzhikevichNetworkExample.html"><img src="../_images/example_izhikevich2007network_sim-spikes.png" height=150 title="Guide 2"/></a>&nbsp;&nbsp;</td>
<td><a href="https://docs.neuroml.org/Userdocs/SingleCompartmentHHExample.html"><img src="../_images/HH_single_compartment_example_sim-v.png" height=150 title="Guide 3"/></a>&nbsp;&nbsp;</td>
<td><a href="https://docs.neuroml.org/Userdocs/MultiCompartmentOLMexample.html"><img src="../_images/olm.cell.xy.png" height=150 title="Guide 4"/></a>&nbsp;&nbsp;</td>
</tr>
</table>

You do not need to install any software on your computers to run the example code included in this chapter.
Each example is followed by a [Jupyter notebook](https://jupyter.org/index.html) for you to experiment with.
These can be run using the "launch" button in the top right hand corner.
Please proceed to the first example section using the navigation button on the right below.

| Link to guide | Description | Model life cycle stages |
| :------ | ----------- | ----------------------- |
| [Guide 1](https://docs.neuroml.org/Userdocs/SingleNeuronExample.html) | Create and simulate a simple regular spiking Izhikevich neuron in NeuroML | Create, Validate, Simulate |
| [Guide 2](https://docs.neuroml.org/Userdocs/IzhikevichNetworkExample.html) | Create a network of two synaptically connected populations of Izhikevich neurons | Create, Validate, Visualise, Simulate |
| [Guide 3](https://docs.neuroml.org/Userdocs/SingleCompartmentHHExample.html) | Build and simulate a single compartment Hodgkin-Huxley neuron | Create, Validate, Visualise, Simulate |
| [Guide 4](https://docs.neuroml.org/Userdocs/MultiCompartmentOLMexample.html) | Create and simulate a multi compartment hippocampal OLM neuron | Create, Validate, Visualise, Simulate |
| [Guide 5](https://docs.neuroml.org/Userdocs/OptimisingNeuroMLModels) | Optimise/fit NeuroML models to experimental data | Create, Validate, Simulate, Fit |
| [Guide 6](https://docs.neuroml.org/Userdocs/CreatingNeuroMLModels.html\#converting-cell-models-to-neuroml-and-sharing-them-on-open-source-brain) | Guide to converting cell models to NeuroML and sharing them on Open Source Brain | Create, Validate, Simulate, Share |
| [Guide 7](https://docs.neuroml.org/Userdocs/NML2_examples/NeuroML-DB.html) | Create novel NeuroML models from components on NeuroML-DB | Reuse, Create, Validate, Simulate |
| [Guide 8](https://docs.neuroml.org/Userdocs/ExtendingNeuroMLv2.html\#example-lorenz-model-for-cellular-convection) | Extend NeuroML by creating a novel model type in LEMS | Create, Simulate |


You do not need to install any software on your computers to run many of the examples above. These examples are followed by a [Jupyter notebook](https://jupyter.org/index.html) for you to experiment with inside your browser ({ref}`more info <userdocs:usage:jupyterbooks>`).

0 comments on commit 0c3d9f5

Please sign in to comment.