Skip to content
This repository was archived by the owner on Feb 26, 2025. It is now read-only.

Commit cc732a1

Browse files
committed
Updated documentation to add the README on RTD.
1 parent 5c0be1a commit cc732a1

File tree

5 files changed

+99
-111
lines changed

5 files changed

+99
-111
lines changed
Lines changed: 74 additions & 91 deletions
Original file line numberDiff line numberDiff line change
@@ -1,59 +1,10 @@
1-
<img src="docs/source/logo/BluePyOptBanner.png"/>
2-
3-
-----------------
4-
5-
# BluePyOpt: Blue Brain Python Optimisation Library
6-
7-
<table>
8-
<tr>
9-
<td>Latest Release</td>
10-
<td>
11-
<a href="https://pypi.org/project/bluepyopt/">
12-
<img src="https://img.shields.io/pypi/v/bluepyopt.svg" alt="latest release" />
13-
</a>
14-
</td>
15-
</tr>
16-
<tr>
17-
<td>Documentation</td>
18-
<td>
19-
<a href="https://bluepyopt.readthedocs.io/">
20-
<img src="https://readthedocs.org/projects/bluepyopt/badge/?version=latest" alt="latest documentation" />
21-
</a>
22-
</td>
23-
</tr>
24-
<tr>
25-
<td>License</td>
26-
<td>
27-
<a href="https://github.com/BlueBrain/bluepyopt/blob/master/LICENSE.txt">
28-
<img src="https://img.shields.io/pypi/l/bluepyopt.svg" alt="license" />
29-
</a>
30-
</td>
31-
</tr>
32-
<tr>
33-
<td>Build Status</td>
34-
<td>
35-
<a href="https://github.com/BlueBrain/BluePyOpt/actions">
36-
<img src="https://github.com/BlueBrain/BluePyOpt/workflows/Build/badge.svg?branch=master" alt="Actions build status" />
37-
</a>
38-
</td>
39-
</tr>
40-
<tr>
41-
<td>Coverage</td>
42-
<td>
43-
<a href="https://codecov.io/gh/BlueBrain/bluepyopt">
44-
<img src="https://codecov.io/github/BlueBrain/BluePyOpt/coverage.svg?branch=master" alt="coverage" />
45-
</a>
46-
</td>
47-
</tr>
48-
<tr>
49-
<td>Gitter</td>
50-
<td>
51-
<a href="https://gitter.im/bluebrain/bluepyopt">
52-
<img src="https://badges.gitter.im/Join%20Chat.svg"
53-
</a>
54-
</td>
55-
</tr>
56-
</table>
1+
|banner|
2+
3+
|release| |docs| |license| |build| |coverage| |gitter|
4+
5+
BluePyOpt
6+
=========
7+
578

589
Introduction
5910
============
@@ -77,24 +28,27 @@ Citation
7728

7829
When you use the BluePyOpt software or method for your research, we ask you to cite the following publication (**this includes poster presentations**):
7930

80-
[Van Geit W, Gevaert M, Chindemi G, Rössert C, Courcol J, Muller EB, Schürmann F, Segev I and Markram H (2016). BluePyOpt: Leveraging open source software and cloud infrastructure to optimise model parameters in neuroscience. Front. Neuroinform. 10:17. doi: 10.3389/fninf.2016.00017](http://journal.frontiersin.org/article/10.3389/fninf.2016.00017)
81-
82-
```bibtex
83-
@ARTICLE{bluepyopt,
84-
AUTHOR={Van Geit, Werner and Gevaert, Michael and Chindemi, Giuseppe and Rössert, Christian and Courcol, Jean-Denis and Muller, Eilif Benjamin and Schürmann, Felix and Segev, Idan and Markram, Henry},
85-
TITLE={BluePyOpt: Leveraging open source software and cloud infrastructure to optimise model parameters in neuroscience},
86-
JOURNAL={Frontiers in Neuroinformatics},
87-
VOLUME={10},
88-
YEAR={2016},
89-
NUMBER={17},
90-
URL={http://www.frontiersin.org/neuroinformatics/10.3389/fninf.2016.00017/abstract},
91-
DOI={10.3389/fninf.2016.00017},
92-
ISSN={1662-5196}
93-
}
94-
```
31+
`Van Geit W, Gevaert M, Chindemi G, Rössert C, Courcol J, Muller EB, Schürmann F, Segev I and Markram H (2016). BluePyOpt: Leveraging open source software and cloud infrastructure to optimise model parameters in neuroscience. Front. Neuroinform. 10:17. doi: 10.3389/fninf.2016.00017 <http://journal.frontiersin.org/article/10.3389/fninf.2016.00017>`_.
32+
33+
.. code-block::
34+
35+
bibtex
36+
@ARTICLE{bluepyopt,
37+
AUTHOR={Van Geit, Werner and Gevaert, Michael and Chindemi, Giuseppe and Rössert, Christian and Courcol, Jean-Denis and Muller, Eilif Benjamin and Schürmann, Felix and Segev, Idan and Markram, Henry},
38+
TITLE={BluePyOpt: Leveraging open source software and cloud infrastructure to optimise model parameters in neuroscience},
39+
JOURNAL={Frontiers in Neuroinformatics},
40+
VOLUME={10},
41+
YEAR={2016},
42+
NUMBER={17},
43+
URL={http://www.frontiersin.org/neuroinformatics/10.3389/fninf.2016.00017/abstract},
44+
DOI={10.3389/fninf.2016.00017},
45+
ISSN={1662-5196}
46+
}
47+
48+
9549
Support
9650
=======
97-
We are providing support using a chat channel on [Gitter](https://gitter.im/BlueBrain/BluePyOpt), or the [Github discussion page](https://github.com/BlueBrain/BluePyOpt/discussions).
51+
We are providing support using a chat channel on `Gitter <https://gitter.im/BlueBrain/BluePyOpt>`_, or the `Github discussion page <https://github.com/BlueBrain/BluePyOpt/discussions>`_.
9852

9953
News
10054
====
@@ -109,14 +63,13 @@ News
10963
Requirements
11064
============
11165

112-
* [Python 2.7+](https://www.python.org/download/releases/2.7/) or [Python 3.6+](https://www.python.org/downloads/release/python-360/)
113-
* [Pip](https://pip.pypa.io) (installed by default in newer versions of Python)
114-
* [Neuron 7.4+](http://neuron.yale.edu/) (compiled with Python support)
115-
* [eFEL eFeature Extraction Library](https://github.com/BlueBrain/eFEL) (automatically installed by pip)
116-
* [Numpy](http://www.numpy.org) (automatically installed by pip)
117-
* [Pandas](http://pandas.pydata.org/) (automatically installed by pip)
118-
* The instruction below are written assuming you have access to a command shell
119-
on Linux / UNIX / MacOSX / Cygwin
66+
* `Python 2.7+ <https://www.python.org/download/releases/2.7/>`_ or `Python 3.6+ <https://www.python.org/downloads/release/python-360/>`_
67+
* `Pip <https://pip.pypa.io>`_ (installed by default in newer versions of Python)
68+
* `Neuron 7.4+ <http://neuron.yale.edu/>`_ (compiled with Python support)
69+
* `eFEL eFeature Extraction Library` <https://github.com/BlueBrain/eFEL>`_ (automatically installed by pip)
70+
* `Numpy <http://www.numpy.org>`_ (automatically installed by pip)
71+
* `Pandas <http://pandas.pydata.org/>`_ (automatically installed by pip)
72+
* The instruction below are written assuming you have access to a command shell on Linux / UNIX / MacOSX / Cygwin
12073

12174
Installation
12275
============
@@ -125,16 +78,18 @@ If you want to use the ephys module of BluePyOpt, you first need to install NEUR
12578

12679
And then bluepyopt itself:
12780

128-
```bash
129-
pip install bluepyopt
130-
```
81+
82+
.. code-block:: bash
83+
84+
pip install bluepyopt
85+
13186
13287
Cloud infrastructure
13388
====================
13489

13590
We provide instructions on how to set up an optimisation environment on cloud
13691
infrastructure or cluster computers
137-
[here](https://github.com/BlueBrain/BluePyOpt/tree/master/cloud-config)
92+
`here <https://github.com/BlueBrain/BluePyOpt/tree/master/cloud-config>`_
13893

13994
Quick Start
14095
===========
@@ -147,13 +102,16 @@ model with 2 HH channels can be found at
147102

148103
https://github.com/BlueBrain/BluePyOpt/blob/master/examples/simplecell/simplecell.ipynb
149104

150-
![Landscape example](https://github.com/BlueBrain/BluePyOpt/blob/master/examples/simplecell/figures/landscape_example.png)
105+
106+
.. image:: ../../examples/simplecell/figures/landscape_example.png
107+
108+
151109
**Figure**: The solution space of a single compartmental model with two parameters: the maximal conductance of Na and K ion channels. The color represents how well the model fits two objectives: when injected with two different currents, the model has to fire 1 and 4 action potential respectively during the stimuli. Dark blue is the best fitness. The blue circles represent solutions with a perfect score.
152110

153111
Neocortical Layer 5 Pyramidal Cell
154112
----------------------------------
155113
Scripts for a more complex neocortical L5PC are in
156-
[this directory](https://github.com/BlueBrain/BluePyOpt/tree/master/examples/l5pc)
114+
`this directory <https://github.com/BlueBrain/BluePyOpt/tree/master/examples/l5pc>`__
157115

158116
With a notebook:
159117

@@ -162,30 +120,55 @@ https://github.com/BlueBrain/BluePyOpt/blob/master/examples/l5pc/L5PC.ipynb
162120
Thalamocortical Cells
163121
---------------------
164122
Scripts for 2 thalamocortical cell types are in
165-
[this directory](https://github.com/BlueBrain/BluePyOpt/tree/master/examples/thalamocortical-cell)
123+
`this directory <https://github.com/BlueBrain/BluePyOpt/tree/master/examples/thalamocortical-cell>`__
166124

167125
With a notebook:
168126

169127
https://github.com/BlueBrain/BluePyOpt/blob/master/examples/thalamocortical-cell/thalamocortical-cell_opt.ipynb
170128

171129

172130
Tsodyks-Markram Model of Short-Term Plasticity
173-
---------------------
131+
----------------------------------------------
174132
Scripts for 2 version of fitting the Tsodyks-Markram model to synaptic traces are in
175-
[this directory](https://github.com/BlueBrain/BluePyOpt/tree/master/examples/tsodyksmarkramstp)
133+
`this directory <https://github.com/BlueBrain/BluePyOpt/tree/master/examples/tsodyksmarkramstp>`__
176134

177135
With 2 notebooks:
178136

179137
https://github.com/BlueBrain/BluePyOpt/blob/master/examples/tsodyksmarkramstp/tsodyksmarkramstp.ipynb
180138
https://github.com/BlueBrain/BluePyOpt/blob/master/examples/tsodyksmarkramstp/tsodyksmarkramstp_multiplefreqs.ipynb
181139

182140
API documentation
183-
==================
184-
The API documentation can be found on [ReadTheDocs](http://bluepyopt.readthedocs.io/en/latest/).
141+
=================
142+
The API documentation can be found on `ReadTheDocs <http://bluepyopt.readthedocs.io/en/latest/>`_.
185143

186144
Funding
187145
=======
188146
This work has been partially funded by the European Union Seventh Framework Program (FP7/2007­2013) under grant agreement no. 604102 (HBP), the European Union’s Horizon 2020 Framework Programme for Research and Innovation under the Specific Grant Agreement No. 720270, 785907 (Human Brain Project SGA1/SGA2) and by the EBRAINS research infrastructure, funded from the European Union’s Horizon 2020 Framework Programme for Research and Innovation under the Specific Grant Agreement No. 945539 (Human Brain Project SGA3).
189147
This project/research was supported by funding to the Blue Brain Project, a research center of the École polytechnique fédérale de Lausanne (EPFL), from the Swiss government’s ETH Board of the Swiss Federal Institutes of Technology.
190148

191149
© 2016-2021, Blue Brain Project/EPFL
150+
151+
.. |release| image:: https://img.shields.io/pypi/v/bluepyopt.svg
152+
:target: https://pypi.org/project/bluepyopt
153+
154+
.. |docs| image:: https://readthedocs.org/projects/bluepyopt/badge/?version=latest
155+
:target: https://bluepyopt.readthedocs.io/
156+
157+
.. |license| image:: https://img.shields.io/pypi/l/bluepyopt.svg
158+
:target: https://github.com/BlueBrain/bluepyopt/blob/master/LICENSE.txt
159+
160+
.. |build| image:: https://github.com/BlueBrain/BluePyOpt/workflows/Build/badge.svg?branch=master
161+
:target: https://github.com/BlueBrain/BluePyOpt/actions
162+
163+
.. |coverage| image:: hhttps://codecov.io/github/BlueBrain/BluePyOpt/coverage.svg?branch=master
164+
:target: https://codecov.io/gh/BlueBrain/bluepyopt
165+
166+
.. |gitter| image:: https://badges.gitter.im/Join%20Chat.svg
167+
:target: https://gitter.im/bluebrain/bluepyopt
168+
169+
..
170+
The following image must also be defined in the index.rst file for unknown reasons.
171+
The phrase ".. substitutions" must not be removed. Function: unknown
172+
173+
.. substitutions
174+
.. |banner| image:: docs/source/logo/BluePyOptBanner.png

bluepyopt/ephys/models.py

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -448,7 +448,7 @@ def __str__(self):
448448
def get_template_name(hoc_string):
449449
"""Find the template name from hoc_string
450450
451-
Note: this will fail if there is a begintemplate in a /* */ style
451+
Note: this will fail if there is a begintemplate in a `/* */` style
452452
comment before the real begintemplate
453453
"""
454454
for i, line in enumerate(hoc_string.split('\n')):

docs/source/conf.py

Lines changed: 7 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -20,7 +20,6 @@
2020
# add these directories to sys.path here. If the directory is relative to the
2121
# documentation root, use os.path.abspath to make it absolute, like shown here.
2222
sys.path.insert(0, os.path.abspath('.'))
23-
# sys.path.append('sphinxext')
2423

2524
# -- General configuration -----------------------------------------------------
2625

@@ -49,7 +48,6 @@
4948

5049
# General information about the project.
5150
project = u'bluepyopt'
52-
copyright = u'2016, BBP, EPFL'
5351

5452
# The version info for the project you're documenting, acts as replacement for
5553
# |version| and |release|, also used in various other places throughout the
@@ -103,8 +101,13 @@
103101

104102
# The theme to use for HTML and HTML Help pages. See the documentation for
105103
# a list of builtin themes.
106-
html_theme = 'sphinx_rtd_theme'
107-
# html_theme = 'haiku-bbp'
104+
html_theme = 'sphinx-bluebrain-theme'
105+
html_title = 'BluepyOpt'
106+
html_show_sourcelink = False
107+
html_theme_options = {
108+
"repo_url": "https://github.com/BlueBrain/BluePyOpt/",
109+
"repo_name": "BlueBrain/BluePyOpt"
110+
}
108111

109112
# Theme options are theme-specific and customize the look and feel of a theme
110113
# further. For a list of options available for each theme, see the

docs/source/index.rst

Lines changed: 5 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -3,27 +3,16 @@
33
You can adapt this file completely to your liking, but it should at least
44
contain the root `toctree` directive.
55
6-
BluePyOpt
7-
=========
86
9-
The Blue Brain Python Optimisation Library (BluePyOpt) is an extensible
10-
framework for data-driven model parameter optimisation that wraps and
11-
standardises several existing open-source tools.
127
13-
It simplifies the task of creating and sharing these optimisations,
14-
and the associated techniques and knowledge.
15-
This is achieved by abstracting the optimisation and evaluation tasks
16-
into various reusable and flexible discrete elements according to established
17-
best-practices.
18-
19-
Further, BluePyOpt provides methods for setting up both small- and large-scale
20-
optimisations on a variety of platforms,
21-
ranging from laptops to Linux clusters and cloud-based compute infrastructures.
8+
.. include:: ../../README.rst
9+
:end-before: .. substitutions
2210

2311
.. toctree::
2412
:maxdepth: 3
2513

26-
api
14+
Home <self>
15+
api.rst
2716

2817
Indices and tables
2918
==================
@@ -32,3 +21,4 @@ Indices and tables
3221
* :ref:`modindex`
3322
* :ref:`search`
3423

24+
.. |banner| image:: /logo/BluePyOptBanner.png

tox.ini

Lines changed: 12 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,16 +1,19 @@
11
[tox]
22
envlist = py{27,3}-{unit,functional,style}
3+
34
[gh-actions]
45
python =
56
2.7: py27
67
3.6: py3
78
3.7: py3
89
3.8: py3
910
3.9: py3
11+
1012
[testenv]
1113
envdir =
1214
py27{-unit,-functional,-style,-syntax}: {toxworkdir}/py27
1315
py3{5,6,7,8,}{-unit,-functional,-style,-syntax}: {toxworkdir}/py3
16+
docs: {toxworkdir}/docs
1417
deps =
1518
coverage
1619
flake8
@@ -42,3 +45,12 @@ commands =
4245

4346
unit: nosetests -vx -a unit --with-coverage --cover-package bluepyopt --cover-xml --cover-xml-file=cov_reports/unit.coverage.xml --cover-html --cover-html-dir=cov_reports/html/unit []
4447
functional: nosetests -vx -a !unit --with-coverage --cover-package bluepyopt --cover-xml --cover-xml-file=cov_reports/functional.coverage.xml --cover-html --cover-html-dir=cov_reports/html/functional []
48+
49+
[testenv:docs]
50+
basepython = python3.6
51+
changedir = docs
52+
deps =
53+
sphinx
54+
sphinx-bluebrain-theme
55+
commands = make html SPHINXOPTS=-W
56+
whitelist_externals = make

0 commit comments

Comments
 (0)