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

Commit 283d466

Browse files
committed
describe multiple ASC soma in docs
1 parent 9dd8d7e commit 283d466

File tree

2 files changed

+19
-4
lines changed

2 files changed

+19
-4
lines changed

doc/source/specification.rst

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -90,7 +90,7 @@ The only allowed bifurcation point in Soma is its root point. An error is thrown
9090

9191
Multiple Soma
9292
*************
93-
Multiple somas are not supported
93+
Multiple somas are supported only for ASC. See :ref:`its specification <specification-neurolucida>`.
9494

9595
Soma with 4 and more points
9696
***************************

doc/source/specification_neurolucida.rst

Lines changed: 18 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -10,9 +10,24 @@ Soma
1010
----
1111

1212
* Files without a soma are valid.
13-
* Multiple soma
14-
ASC files with *multiple* CellBody tags will raise an error.
15-
`Unit test <https://github.com/BlueBrain/MorphIO/blob/5e111f3141f7a1ee72e0260111ce569741d80acb/tests/test_neurolucida.py#L58>`_
13+
* Multiple soma is supported via multiple CellBody S-exps, with each of them being the soma contour at a given Z
14+
altitude. A single CellBody in this definition is called a soma stack. All Z coordinates within a soma stack must
15+
be the same. Z coordinates among different soma stacks must be different. An example.
16+
17+
.. code-block:: lisp
18+
19+
(
20+
(CellBody) ; <- first soma stack
21+
( 5.88 0.84 1.0 2.35)
22+
( 6.05 2.53 1.0 2.35)
23+
( 6.39 4.38 1.0 2.35)
24+
)
25+
(
26+
(CellBody) ; <- second soma stack
27+
( 1.85 0.67 2.0 1.35)
28+
( 0.84 1.52 2.0 1.35)
29+
( -4.54 2.36 2.0 1.35)
30+
)
1631
1732
Duplicate points
1833
----------------

0 commit comments

Comments
 (0)