tvb

adapters.tvb

TVB (The Virtual Brain) adapter for tvbo.

All TVB ↔︎ tvbo conversion logic lives here:

Import (TVB → tvbo)

  • :func:from_tvb_simulator — full Simulator → SimulationExperiment
  • :func:from_tvb — Connectivity → Network
  • :func:from_tvb_zip — connectivity ZIP file → Network
  • :func:from_tvb_surface — Connectivity + Surface + RegionMapping → Network pair

Export (tvbo → TVB)

  • :func:to_tvb — Network → TVB Connectivity
  • :func:to_tvb_monitor — Observation → TVB Monitor

Functions

Name Description
from_tvb Import a live TVB Connectivity object into a tvbo Network.
from_tvb_simulator Convert a TVB Simulator into a tvbo SimulationExperiment datamodel.
from_tvb_surface Create a multi-level tvbo Network from TVB surface simulation data.
from_tvb_zip Import a TVB connectivity ZIP into a tvbo Network.
to_tvb Export a tvbo Network to a TVB Connectivity object.
to_tvb_monitor Convert a tvbo Observation to a TVB Monitor instance.

from_tvb

adapters.tvb.from_tvb(connectivity)

Import a live TVB Connectivity object into a tvbo Network.

Lossless conversion — all TVB fields are preserved as tvbo Node parameters and Network-level metadata.

Parameters

connectivity : tvb.datatypes.connectivity.Connectivity A configured TVB Connectivity instance.

Returns

Network Network instance with arrays loaded, ready for save().

from_tvb_simulator

adapters.tvb.from_tvb_simulator(sim, experiment_id=None)

Convert a TVB Simulator into a tvbo SimulationExperiment datamodel.

Parameters

sim : tvb.simulator.simulator.Simulator A configured TVB Simulator instance. experiment_id : int, optional Experiment identifier. Defaults to the simulator’s GID.

Returns

tvbo_datamodel.SimulationExperiment Schema-valid datamodel instance.

from_tvb_surface

adapters.tvb.from_tvb_surface(connectivity, surface, region_mapping)

Create a multi-level tvbo Network from TVB surface simulation data.

Produces two linked networks:

  1. Region-level (parent): from TVB Connectivity
  2. Vertex-level (child): mesh + region_mapping linking vertices to regions via hierarchical node_mapping

Parameters

connectivity : tvb.datatypes.connectivity.Connectivity Configured TVB Connectivity (region-level). surface : tvb.datatypes.surfaces.Surface TVB CorticalSurface (or any Surface subclass). region_mapping : tvb.datatypes.region_mapping.RegionMapping TVB RegionMapping mapping vertices to regions.

Returns

tuple[Network, Network] (region_network, surface_network)

from_tvb_zip

adapters.tvb.from_tvb_zip(zip_path)

Import a TVB connectivity ZIP into a tvbo Network.

TVB ZIPs contain: weights.txt, tract_lengths.txt, centres.txt.

Parameters

zip_path : str or Path Path to TVB connectivity ZIP file.

Returns

Network Network instance with loaded arrays ready for save().

to_tvb

adapters.tvb.to_tvb(network)

Export a tvbo Network to a TVB Connectivity object.

Parameters

network : Network tvbo Network instance with weights and lengths matrices.

Returns

tvb.datatypes.connectivity.Connectivity Configured TVB Connectivity ready for simulation.

to_tvb_monitor

adapters.tvb.to_tvb_monitor(observation)

Convert a tvbo Observation to a TVB Monitor instance.

Uses class_reference to reconstruct the exact TVB Monitor subclass with all constructor arguments including HRF kernel type.

Parameters

observation : tvbo.datamodel.schema.Observation The tvbo observation to convert.

Returns

tvb.simulator.monitors.Monitor Configured TVB monitor instance.