axon_population.create_population

axon_population.create_population(data: tuple[ndarray] | ndarray | str = None, n_ax: int = 100, FVF: None | float = None, percent_unmyel: float = 0.7, M_stat: str = 'Schellens_1', U_stat: str = 'Ochoa_U', overwrite=False)[source]

Creat an placed axon population

Parameters:

  • data (tuple[np.ndarray] | np.ndarray | str) –

    data to used to create the population. Supported data:

    • str: of the file path and name where to load the population properties.

    • tuple[np.ndarray] containing the population properties.

    • np.ndarray: of dimention (2, n_ax) or (4, n_ax), arange in the following order: types, diameters, y (optional), z (optional).

  • n_ax (int, optional) – Number of axon to generate for the population (Unmyelinated and myelinated), default 100

  • FVF (float) – Fiber Volume Fraction estimated for the area. If None, the value n_ax is used. By default set to None

  • percent_unmyel (float) – ratio of unmyelinated axons in the population. Should be between 0 and 1.

  • M_stat (str) – name of the statistic in the librairy or path to a new librairy in csv for myelinated diameters repartition

  • U_stat (str) – name of the statistic in the librairy or path to a new librairy in csv for unmyelinated diameters repartition

Note

When FVF is set, an approximated value of n_ax is calculated from:

\[FVF = \frac{n_{axons}*E_{d}}{A_{tot}}\]

where $E_{d}$ is the espected diameters from the myelinated and unmyelinated fibers stats and $A_{tot}$ is geometry total area.

Tip

It goes for the previous definition that FVF will only be accurate for large axon population. This might be improved in future version but for now it is adviced to define small population using n_ax instead of FVF