WebUI Configuration Reference
This reference summarizes the purpose, workflows, and configurable parameters of every WebUI module.
No configuration information matches this search.
Simulation
Simulation setup, neural network models, parameter sweeps, and model-specific controls.
5 categories · 83 entries
Field Potential
Proxy signals, biophysical kernels, CDM/LFP computation, and M/EEG forward models.
6 categories · 34 entries
Features
Feature methods, computation settings, data loading, and electrophysiology parsing.
9 categories · 123 entries
Inference
Inverse-model training, model assets, prediction settings, and SBI controls.
6 categories · 37 entries
Analysis
Boxplots, topographic maps, and simulation-result visualization controls.
4 categories · 39 entries
WebUI module
83 entries
Simulation
Simulation setup, neural network models, parameter sweeps, and model-specific controls.
Module overview and available workflows8 entries
| Page, option, or parameter | Detailed information |
|---|---|
Simulation module |
Configure and run neural circuit simulations, or upload existing simulation outputs, to generate synthetic data for downstream processing. |
Load data |
Load existing simulation outputs, such as spike times, spike gids, timing information, and network data. |
New simulation |
Configure and run a new neural circuit simulation using a predefined or custom model. |
/simulation/upload_sim |
Load previously generated simulation pickle outputs, including complete simulation bundles or legacy spike-time, spike-gid, timing, and network files. |
/simulation/new_sim/custom |
Configure a custom simulation by supplying the required model and parameter files. The uploaded code defines available parameters and output behavior. |
/simulation/new_sim/hagen |
Configure the Hagen current-based excitatory/inhibitory LIF network, including population parameters and connectivity matrices. |
/simulation/new_sim/four_area |
Configure four coupled cortical areas. Local parameters apply to the selected area; inter-area matrices configure connections between areas. |
/simulation/new_sim/cavallari |
Configure the Cavallari conductance-based network, including spatial connectivity, external drive, synaptic conductances, and neuron dynamics. |
Simulation and parameter-sweep controls9 entries
| Page, option, or parameter | Detailed information |
|---|---|
Tstop |
Total simulated duration in ms. Increase it to observe longer dynamics, at the cost of proportionally longer computation and larger outputs. |
Dt |
Simulation integration time step in ms. Smaller values improve temporal resolution and numerical accuracy but increase runtime and output size. |
Local Num Threads |
Number of CPU threads used by the simulator. Use a positive integer appropriate for the available CPU cores; excessive values can reduce performance. |
Sim Run Mode |
Single trial runs one simulation using the parameter values shown in the form. Parameter grid sweep runs multiple simulations while exploring selected parameters. In parameter exploration, ungrouped parameters form a Cartesian grid search; joint sweep groups link selected parameters by candidate index so they change together instead. For each swept parameter, Start is the first simulated value, Step is the amount added between values, and End is the target limit. Use a positive Step when End is above Start and a negative Step when End is below Start. End is included only when repeated Step increments reach it exactly. |
Sim Numpy Seed |
Seed used for NumPy randomization. Enable Fix seed and enter a non-negative integer to reproduce stochastic parameter generation and repeated runs. Leave Fix seed disabled to use non-fixed randomization. |
Grid Start |
Starting value simulated for this parameter. |
Grid Step |
Amount added to the parameter between simulations. Use a positive step when End is above Start and a negative step when End is below Start. |
Grid End |
Final target value for the parameter exploration. It is included only when repeated Step increments land on it; otherwise the last simulated value is the final stepped value before End. |
Sim Repetitions |
Number of times each simulation configuration is run. Use multiple repetitions to characterize stochastic variability. |
Hagen model parameters13 entries
| Page, option, or parameter | Detailed information |
|---|---|
X |
Population labels used across all population-indexed parameters. Changing them here updates the labels shown in all other parameters. |
N X |
Number of neurons in each population. Use positive integers; larger populations increase runtime and memory use. |
C M X |
Membrane capacitance for each population, in pF. Use positive values; larger values make membrane voltage respond more slowly to current. |
Tau M X |
Membrane time constant for each population, in ms. Use positive values; larger values make membrane voltage decay more slowly. |
E L X |
Resting or leak reversal potential for each population, in mV. It defines the voltage approached without synaptic or injected input. |
Model |
Neuron model fixed by the selected simulation template. Read-only values cannot be changed from this form. |
C Yx |
Connection-probability matrix from source populations X to target populations Y. Use values from 0 to 1; larger values create denser recurrent connectivity. |
J Yx |
Synaptic-weight matrix from source populations X to target populations Y, in nA. Sign determines excitatory or inhibitory effect, and larger absolute values strengthen connections. |
Delay Yx |
Synaptic transmission-delay matrix from source populations X to target populations Y, in ms. Use non-negative values; larger values make activity arrive later. |
Tau Syn Yx |
Synaptic-current decay time constants for each source-target connection type, in ms. Use positive values; larger values produce longer-lasting postsynaptic effects. |
N Ext |
Effective number of external input connections received by each neuron. Use non-negative integers; larger values increase external input. |
Nu Ext |
Rate of each external Poisson input, in Hz. Use a non-negative value; larger values increase external input activity and generally raise network firing. |
J Ext |
Strength of each external synaptic input, in nA. Sign determines excitatory or inhibitory effect, and larger absolute values strengthen the external input. |
Cavallari model parameters32 entries
| Page, option, or parameter | Detailed information |
|---|---|
X |
Population labels used across all population-indexed parameters. Changing them here updates the labels shown in all other parameters. |
N X |
Number of neurons in each population. Use positive integers; larger populations increase runtime and memory use. |
C M X |
Membrane capacitance for each population, in pF. Use positive values; larger values make membrane voltage respond more slowly to current. |
Tau M X |
Membrane time constant for each population, in ms. Use positive values; larger values make membrane voltage decay more slowly. |
E L X |
Resting or leak reversal potential for each population, in mV. It defines the voltage approached without synaptic or injected input. |
Model |
Neuron model fixed by the selected simulation template. Read-only values cannot be changed from this form. |
P |
Probability of each recurrent source-target neuron pair being connected. Use a value from 0 to 1; larger values create denser connectivity and increase recurrent input. |
Extent |
Spatial size of the modeled network. Configure it using the units expected by the selected simulation model. |
OU Sigma |
Standard deviation of the Ornstein-Uhlenbeck process that generates cortical external-input fluctuations, in spikes/ms. Use a non-negative value; 0 disables fluctuations and larger values increase their magnitude. |
OU Tau |
Time constant of the Ornstein-Uhlenbeck process that generates cortical external-input fluctuations, in ms. Use a positive value; larger values produce slower, more persistent fluctuations. |
V Th X |
Membrane-potential threshold at which each population's neurons emit a spike, in mV. It should be above the reset and leak reversal potentials; lower values make neurons easier to activate. |
V Reset X |
Membrane potential assigned after a spike for each population, in mV. It should be below the spike threshold; lower values generally delay the next spike. |
T Ref X |
Absolute refractory period after a spike for each population, in ms. Use a non-negative value; larger values reduce the maximum possible firing rate. |
G L X |
Leak conductance for each population, in nS. Use a positive value; larger values pull membrane voltage toward the leak reversal potential more strongly. |
E Ex X |
Excitatory synaptic reversal potential for each population, in mV. It should normally be above resting and threshold potentials. |
E In X |
Inhibitory synaptic reversal potential for each population, in mV. It should normally be below resting and threshold potentials. |
Tau Rise Ampa X |
AMPA conductance rise time for each population, in ms. Use a positive value; larger values make excitatory conductance rise more slowly. |
Tau Decay Ampa X |
AMPA conductance decay time for each population, in ms. Use a positive value greater than the AMPA rise time; larger values prolong excitatory input. |
Tau Rise GABA A X |
GABA-A conductance rise time for each population, in ms. Use a positive value; larger values make inhibitory conductance rise more slowly. |
Tau Decay GABA A X |
GABA-A conductance decay time for each population, in ms. Use a positive value greater than the GABA-A rise time; larger values prolong inhibitory input. |
I E X |
Constant current injected into each population's neurons, in pA. Positive values depolarize neurons and negative values hyperpolarize them. |
Exc Exc Recurrent |
Recurrent synaptic conductance from an excitatory source neuron to an excitatory target neuron, in nS. Use a positive value; larger values strengthen recurrent excitation of excitatory neurons. |
Exc Inh Recurrent |
Recurrent synaptic conductance from an excitatory source neuron to an inhibitory target neuron, in nS. Use a positive value; larger values strengthen excitation of inhibitory neurons. |
Inh Exc Recurrent |
Recurrent synaptic conductance from an inhibitory source neuron to an excitatory target neuron, in nS. Use a negative value; larger absolute values strengthen inhibition of excitatory neurons. |
Inh Inh Recurrent |
Recurrent synaptic conductance from an inhibitory source neuron to an inhibitory target neuron, in nS. Use a negative value; larger absolute values strengthen recurrent inhibition of inhibitory neurons. |
Th Exc External |
Synaptic conductance from the thalamic external-input generator to excitatory neurons, in nS. Use a non-negative value; larger values strengthen thalamic drive to excitatory neurons. |
Th Inh External |
Synaptic conductance from the thalamic external-input generator to inhibitory neurons, in nS. Use a non-negative value; larger values strengthen thalamic drive to inhibitory neurons. |
Cc Exc External |
Synaptic conductance from the cortical external-input generator to excitatory neurons, in nS. Use a non-negative value; larger values strengthen fluctuating cortical input to excitatory neurons. |
Cc Inh External |
Synaptic conductance from the cortical external-input generator to inhibitory neurons, in nS. Use a non-negative value; larger values strengthen fluctuating cortical input to inhibitory neurons. |
V 0 |
Constant baseline component of the thalamic external-input signal, in spikes/ms. Use a non-negative value; larger values increase the baseline thalamic input rate. |
A Ext |
Amplitude of the sinusoidal component added to the thalamic external-input signal, in spikes/ms. Use a non-negative value; 0 disables the oscillatory component and larger values increase its modulation depth. |
F Ext |
Frequency of the sinusoidal component added to the thalamic external-input signal, in Hz. Use a non-negative value; it has no effect when the oscillatory amplitude is 0. |
Four-area model parameters21 entries
| Page, option, or parameter | Detailed information |
|---|---|
Areas |
Area labels used across all area-indexed parameters. Changing them here updates the labels shown in all other parameters and the area selector. |
X |
Population labels used across all population-indexed parameters. Changing them here updates the labels shown in all other parameters. |
N X |
Number of neurons in each population. Use positive integers; larger populations increase runtime and memory use. |
C M X |
Membrane capacitance for each population, in pF. Use positive values; larger values make membrane voltage respond more slowly to current. |
Tau M X |
Membrane time constant for each population, in ms. Use positive values; larger values make membrane voltage decay more slowly. |
E L X |
Resting or leak reversal potential for each population, in mV. It defines the voltage approached without synaptic or injected input. |
Model |
Neuron model fixed by the selected simulation template. Read-only values cannot be changed from this form. |
C Yx |
Connection-probability matrix from source populations X to target populations Y. Use values from 0 to 1; larger values create denser recurrent connectivity. |
J Yx |
Synaptic-weight matrix from source populations X to target populations Y, in nA. Sign determines excitatory or inhibitory effect, and larger absolute values strengthen connections. |
Delay Yx |
Synaptic transmission-delay matrix from source populations X to target populations Y, in ms. Use non-negative values; larger values make activity arrive later. |
Tau Syn Yx |
Synaptic-current decay time constants for each source-target connection type, in ms. Use positive values; larger values produce longer-lasting postsynaptic effects. |
N Ext |
Effective number of external input connections received by each neuron. Use non-negative integers; larger values increase external input. |
Nu Ext |
Rate of each external Poisson input, in Hz. Use a non-negative value; larger values increase external input activity and generally raise network firing. |
J Ext |
Strength of each external synaptic input, in nA. Sign determines excitatory or inhibitory effect, and larger absolute values strengthen the external input. |
Four Area Local Editor |
Configure the model's four brain-area names and the neuronal-population names shared by every area. Then use the Area selector to choose which area's local Network and recurrent connectivity parameters are displayed and edited. Simulation parameters and inter-area connectivity remain shared across all areas. |
Inter Area C Yx |
Connection-probability matrix from source area-population nodes to target area-population nodes. Use values from 0 to 1; larger values create denser inter-area connectivity. Same-area entries are ignored (these connections are configured in the Recurrent connectivity section). |
Inter Area J Yx |
Synaptic-weight matrix from source area-population nodes to target area-population nodes, in nA. Sign determines excitatory or inhibitory effect, and larger absolute values strengthen connections. Same-area entries are ignored (these connections are configured in the Recurrent connectivity section). |
Inter Area Delay Yx |
Transmission-delay matrix from source area-population nodes to target area-population nodes, in ms. Use non-negative values; larger values make activity arrive later. Same-area entries are ignored (these connections are configured in the Recurrent connectivity section). |
Area labels |
Names of the four modeled brain areas. Each area contains its own neuronal populations and has independently configurable Network and recurrent connectivity parameters. Changing an area label updates the Area selector and all area references throughout the configuration. |
Population labels X |
Names of the neuronal populations contained within each brain area. The same population labels and ordering are shared by all four areas and are used throughout population-indexed and connectivity parameters. Changing a label updates all population references throughout the configuration. |
Area selector frontal parietal temporal occipital |
Select the brain area whose area-local Network and recurrent connectivity parameters are displayed and edited below. Changing the selection does not modify shared simulation parameters, population labels, area labels, or inter-area connectivity. |
WebUI module
34 entries
Field Potential
Proxy signals, biophysical kernels, CDM/LFP computation, and M/EEG forward models.
Module overview and available workflows7 entries
| Page, option, or parameter | Detailed information |
|---|---|
Field Potential module |
Convert simulated neural activity into field-potential signals, including proxy and kernel-based forward-model outputs. |
Load data |
Load existing field-potential outputs, such as current dipole moments, LFPs, M/EEG signals, and proxy signals. |
Kernel |
Compute current dipole moments and field potentials (LFP, MEG, and EEG) from kernels. |
Proxy |
Estimate field potentials from simulated neural activity using computationally efficient proxy signals. |
/field_potential/load |
Load precomputed field-potential outputs such as current dipole moments, LFPs, M/EEG signals, or proxy signals. |
/field_potential/kernel |
Configure biophysical kernels, convolve simulation spikes into current dipole moments or LFPs, and project dipoles to EEG or MEG sensors. |
/field_potential/proxy |
Compute efficient field-potential proxy signals from simulation outputs such as spikes, membrane voltages, and synaptic currents. |
Proxy-signal configuration5 entries
| Page, option, or parameter | Detailed information |
|---|---|
Proxy Method |
Field-potential proxy formula to compute from simulation outputs. Available methods require different combinations of spikes, voltages, or synaptic currents. |
Sim Step |
Sampling interval of the simulation inputs. It is used to construct the output time axis and must match the source data. |
Proxy Decimation Factor |
Integer downsampling factor applied to the proxy output. Larger values reduce temporal resolution and output size. |
Bin Size |
Time-bin width used when converting spikes into firing rates. Larger bins smooth activity more strongly. |
Excitatory Only |
When enabled, calculate the selected proxy using only the excitatory population. |
Biophysical kernel construction8 entries
| Page, option, or parameter | Detailed information |
|---|---|
Dt Kernel |
Temporal resolution used for kernel computation. Smaller values improve resolution but increase runtime and memory use. |
T X |
Time in ms at which presynaptic populations are activated when generating kernels. It defines the activation onset used to align the kernel response. Leave empty to use KernelParams.transient from the selected kernel parameters module. |
Tau |
Kernel time lag in ms defining the duration or lag window represented by the generated kernels. Larger values retain responses over a longer interval but increase computation and output size. Leave empty to use KernelParams.tau from the selected kernel parameters module. |
Mean Nu X |
Mean firing rate assumed for each presynaptic population during kernel construction. |
Vrest Value |
Resting membrane potential used by the biophysical kernel calculation. |
G Eff |
Include effective conductance corrections when constructing kernels. Enable when the selected kernel model supports this approximation. |
Kernel Population Size E |
Number of excitatory neurons represented by the spike data. Use a non-negative integer matching the simulation. |
Kernel Population Size I |
Number of inhibitory neurons represented by the spike data. Use a non-negative integer matching the simulation. |
CDM and LFP convolution4 entries
| Page, option, or parameter | Detailed information |
|---|---|
CDM Component |
Select which spatial component of dipole kernels is retained during convolution. Choose z to compute only the z-oriented current dipole moment, which is commonly used for vertically aligned cortical populations, or xyz (all) to preserve all three Cartesian components for later vector analysis or M/EEG projection. This setting applies only to dipole probes; scalar LFP probes such as GaussCylinderPotential retain all electrode channels. |
CDM Mode |
Controls how the finite spike-rate signal and kernel overlap during convolution. same returns the centered portion with the length of the longer input and is usually appropriate for direct comparison with the simulated time series. full includes every partial overlap and therefore extends the output at both ends. valid keeps only positions where the signals overlap completely, producing a shorter output without edge contributions. |
CDM Scale |
Multiplicative factor applied after convolution to set the numerical scaling of every computed CDM/LFP signal. The default dt * 10^-3 converts the kernel sampling interval from milliseconds to seconds so firing rates expressed in Hz are integrated consistently over time. Change it only when a different normalization or unit conversion is required. |
CDM Decimation Factor |
Integer downsampling factor applied after CDM/LFP computation. A value of N keeps one sample every N time points, reducing output size and sampling frequency by that factor while preserving the represented duration. Use 1 to disable decimation; larger values reduce temporal resolution and may discard fast signal changes. |
M/EEG forward modelling2 entries
| Page, option, or parameter | Detailed information |
|---|---|
M/EEG Model |
Select the physical volume-conductor model used to transform current dipole moments into EEG potentials or MEG fields. NYHeadModel computes EEG with a realistic New York head model and its built-in cortical and 10-20-aligned electrode geometry; it automatically controls locations and forward mode and is unavailable for four-area simulations. FourSphereVolumeConductor computes EEG in four concentric spherical tissue layers. InfiniteVolumeConductor computes EEG in an unbounded homogeneous conductor using each sensor's position relative to the dipole. InfiniteHomogeneousVolCondMEG computes MEG in an unbounded homogeneous conductor, while SphericallySymmetricVolCondMEG computes MEG with spherical symmetry. The selected model determines whether the output is EEG or MEG, which locations are editable, and the default dipole and sensor geometry. |
M/EEG Forward Mode |
Controls how multiple dipoles contribute to the configured sensors. Simulate all dipoles simultaneously projects every dipole to every sensor and sums their contributions; ordinary Hagen and Cavallari inputs replicate the same CDM across configured dipoles, while four-area inputs use fixed frontal, parietal, temporal, and occipital dipoles with their corresponding area CDMs. Per-sensor independent simulation computes sensor i only from dipole i, requiring equal numbers of explicit sensors and dipoles for non-NYHead models. NYHeadModel always uses per-sensor independent mode automatically, and four-area simulations always use simultaneous mode. |
Kernel workflow and data-source guidance8 entries
| Page, option, or parameter | Detailed information |
|---|---|
Multicompartment neuron model folder |
Required folder containing the multicompartment neuron resources used to construct cells for kernel computation. It must contain the cell templates and morphologies referenced by the selected Kernel parameters module, together with compatible NEURON mechanism files under mod/*.mod. |
Multicompartment network simulation outputs |
Optional folder containing outputs from a compatible multicompartment network simulation. spikes.h5 is used to estimate mean firing rates and somav.h5 is used to estimate Vrest. The outputs should match the selected Kernel parameters module. If this folder is omitted, provide both Mean firing rates (mean_nu_X) and Resting membrane potential (Vrest) manually. |
Kernel parameters module |
Python module defining KernelParams and the multicompartment network specification required to construct kernels, including populations, cell parameters, morphologies, connectivity, synapses, and related settings. Select a compatible local or server Python file, or load the predefined module for the detected Hagen, Cavallari, or four-area model. |
Biophysical membrane properties (biophys) |
Biophysical setup functions applied when constructing each multicompartment neuron for kernel computation. Select functions provided by ncpi.neuron_utils to configure membrane mechanisms and properties, such as active conductances or uniform membrane parameters. Functions are applied in the listed order, so later properties may modify settings established by earlier ones. |
Population sizes |
Optional neuron counts for the excitatory (E) and inhibitory (I) populations represented by the spike-time data. During CDM/LFP computation, spike counts in each time bin are converted to rates in Hz and divided by the corresponding population size, producing a per-neuron population firing rate before convolution with the kernels. Enter values that match the simulated populations. Manual values override population sizes loaded from the simulation output; leave both empty to use available simulation population sizes or proceed without population-size normalization. |
Probes |
Select the kernel output quantities to compute from the spike data. KernelApproxCurrentDipoleMoment produces an approximate current dipole moment, CurrentDipoleMoment produces the exact current dipole moment available from the kernels, and GaussCylinderPotential produces local field potentials at the electrode locations defined by KernelParams. You may compute a dipole probe together with GaussCylinderPotential, but KernelApproxCurrentDipoleMoment and CurrentDipoleMoment are alternative dipole representations and cannot be selected together. |
Dipole locations |
Spatial positions of the current dipoles used by the selected forward model. Add one X, Y, Z coordinate triplet per dipole; non-NYHead models interpret coordinates in micrometers. For ordinary Hagen or Cavallari inputs, the same CDM is replicated across all configured dipole locations. NYHeadModel ignores manual coordinates and automatically assigns dipoles to built-in cortical targets aligned with its 10-20 electrode system. For four-area simulations, four fixed model-specific positions represent the frontal, parietal, temporal, and occipital areas, and each position receives its corresponding area CDM. |
Sensor locations |
Spatial positions where the selected forward model evaluates the EEG potential or MEG field. Add one X, Y, Z coordinate triplet per sensor or electrode; non-NYHead models interpret coordinates in micrometers. In simultaneous mode, every configured dipole contributes to every sensor. In per-sensor independent mode, sensor i is paired only with dipole i, so non-NYHead models require equal numbers of sensors and dipoles. NYHeadModel ignores manual sensor coordinates and uses its built-in 10-20-aligned electrode set automatically. |
WebUI module
123 entries
Features
Feature methods, computation settings, data loading, and electrophysiology parsing.
Module overview and available workflows4 entries
| Page, option, or parameter | Detailed information |
|---|---|
Features module |
Compute or load quantitative descriptors (features) from simulated or empirical neural signals for inference and analysis workflows. |
Load data |
Load precomputed feature datasets for inference or analysis. |
Compute new features |
Compute new features from simulated or empirical data signals. |
/features/load_data |
Load precomputed feature dataframes |
Feature-computation settings4 entries
| Page, option, or parameter | Detailed information |
|---|---|
Features N Jobs |
Number of worker processes used to compute features across dataframe rows. Use 1 for sequential execution and easier debugging. Larger values can reduce runtime when many signals are processed, but each worker consumes CPU and memory; do not exceed the resources available to the runtime. |
Features Chunksize |
Optional number of dataframe rows sent to each worker per multiprocessing task. Small chunks improve load balancing when signals vary in cost, while larger chunks reduce scheduling overhead. Leave empty to let the multiprocessing backend choose. |
Features Start Method |
Process-creation strategy used for parallel feature computation. spawn starts clean worker processes and is the most portable option. fork is faster on supported Unix systems but can inherit unsafe library state. forkserver creates workers from a dedicated server process and is available only on supported platforms. |
Features Subsample Percent |
Percentage of parsed dataframe rows retained before feature computation. Use 100 to process every row. Values below 100 select a deterministic random subset, which is useful for quick tests but produces an intentionally incomplete feature dataframe. |
catch22 parameters1 entry
| Page, option, or parameter | Detailed information |
|---|---|
Catch22 Normalize |
Standardize each signal before computing the 22 catch22 descriptors by removing its mean and scaling its variance. Enable this when descriptors should be less sensitive to absolute offset and amplitude. Leave disabled when signal magnitude is scientifically meaningful. |
Spectral parameterization30 entries
| Page, option, or parameter | Detailed information |
|---|---|
Specparam Fs |
Sampling frequency in Hz used to build the Welch power spectrum and frequency axis. Leave empty only when the parsed dataframe already contains a valid sampling frequency. An incorrect value shifts all reported peak frequencies and frequency-range boundaries. |
Specparam Select Peak |
Controls which fitted oscillatory peak is exposed through the selected peak outputs. max_pw chooses the peak with greatest power, max_cf_in_range chooses the highest center-frequency peak inside the fitted range, and all preserves all fitted peak values where supported. |
Specparam Freq Min |
Lower frequency bound in Hz of the spectrum passed to the spectral model. Frequencies below this value are excluded from fitting. Choose a bound above 0 and below Frequency range max. |
Specparam Freq Max |
Upper frequency bound in Hz of the spectrum passed to the spectral model. It must exceed Frequency range min and remain below the Nyquist frequency, which is half the sampling frequency. |
Specparam Welch N per segment |
Number of time samples in each Welch segment. Larger segments improve frequency resolution but provide fewer segments to average and require sufficiently long signals. The default shown by the WebUI is derived from the detected sampling frequency when available. |
Specparam Welch N overlap |
Number of samples shared by consecutive Welch segments. Increasing overlap provides more spectral averages but increases computation and correlation between segments. It must be smaller than Welch nperseg. |
Specparam Welch NFFT |
FFT length used for every Welch segment. It must be at least as large as the segment length. Values above Welch nperseg zero-pad the segment and create a denser frequency grid, but do not add true spectral resolution. |
Specparam Welch Window |
Window function applied to every Welch segment before the FFT to control spectral leakage. Hann is a common general-purpose choice. Other windows trade main-lobe width, amplitude accuracy, and side-lobe suppression. |
Specparam Welch Detrend |
Detrending applied independently to every Welch segment before spectral estimation. constant removes each segment mean, linear removes a fitted linear trend, and none preserves the segment unchanged. |
Specparam Welch Scaling |
Controls the units of the Welch result. density returns power spectral density per Hz, while spectrum returns power per frequency bin. Use density for comparisons that should remain stable across frequency resolution. |
Specparam Welch Average |
Method used to combine periodograms from Welch segments. mean is efficient for stable data; median is more robust to transient high-power segments and outliers. |
Specparam Model Peak Threshold |
Relative peak-detection threshold, expressed in standard deviations above the modeled aperiodic background. Larger values accept only more prominent oscillatory peaks and generally reduce the number of fitted peaks. |
Specparam Model Min Peak Height |
Minimum absolute height above the aperiodic fit required for a candidate oscillatory peak. Use it together with Peak threshold to suppress weak fitted peaks; 0 disables an additional absolute-height restriction. |
Specparam Model Max N Peaks |
Maximum number of oscillatory peaks fitted within the selected frequency range. Use 0 to prevent peak fitting. Larger values permit more complex spectra but can increase overfitting. |
Specparam Model Peak Width Min |
Minimum accepted oscillatory peak bandwidth in Hz. Narrower candidate peaks are rejected. It must be positive and lower than Peak width max. |
Specparam Model Peak Width Max |
Maximum accepted oscillatory peak bandwidth in Hz. Broader candidate peaks are rejected. It must exceed Peak width min and should be appropriate for the fitted frequency range. |
Specparam Model Aperiodic Mode |
Shape used for the aperiodic spectral component. fixed fits offset and exponent as a straight line in log-log space. knee adds a bend parameter and is appropriate when the fitted spectrum visibly changes slope. |
Specparam Model Verbose |
Enable or disable messages produced by the spectral-model fitting backend. Enable for diagnosis of fitting problems; disable for routine batch processing. |
Specparam Model Metric Gof Adjrsquared |
Request adjusted R-squared as an additional model-fit metric. It measures explained variance while accounting for model complexity and can be selected for quality thresholds or saved output. |
Specparam Model Metric Error MSE |
Request mean squared error as an additional model-fit metric. Lower values indicate smaller residual error and the metric can be used for quality thresholds or saved output. |
Specparam Metric Policy |
Controls how fits that fail configured quality thresholds are represented. reject marks failing fits as invalid for downstream filtering, while flag retains the result and records its validity status for later review. |
Specparam Threshold Gof Rsquared |
Minimum accepted model R-squared from 0 to 1. Fits below this threshold fail the quality policy. Increase it for stricter goodness-of-fit requirements. |
Specparam Threshold Metric 1 Name |
Optional additional fit metric used as a quality threshold. Select adjusted R-squared or mean squared error, then provide its limit in Additional threshold value. The selected metric must also be computed by the model. |
Specparam Threshold Metric 1 Value |
Threshold applied to the selected additional fit metric. Its interpretation follows the metric: adjusted R-squared generally requires a minimum value, while mean squared error generally requires a maximum value. |
Specparam Output Key |
Select the value stored in the output dataframe Features column. Choose the full dictionary to preserve all fitted results, a named scalar for analysis or model training, or Custom path to extract another nested result. |
Specparam Output Path |
Nested dictionary path extracted when Saved output value is Custom path, for example metrics.gof_rsquared or aperiodic_params.1. The resolved value should be numeric; missing paths produce missing feature values. |
Specparam Debug |
Enable additional diagnostic behavior and messages during specparam computation. Use it to investigate failed or unexpected fits; leave disabled for normal batch processing. |
Specparam Normalize |
Standardize each input signal before Welch spectral estimation. This reduces differences caused by absolute signal amplitude while preserving relative spectral shape. Disable it when absolute power or amplitude-dependent spectral values are important. |
Specparam Drop Invalid Rows |
Remove output dataframe rows whose spectral fit is invalid or whose selected output value is missing. Disable this to preserve row alignment and inspect invalid results explicitly. |
Specparam Reject Nonpositive Exponent |
Treat zero or negative aperiodic exponents as invalid. When the selected output is aperiodic exponent, invalid values become missing; with row dropping enabled, affected rows are removed. |
Detrended fluctuation analysis (DFA)18 entries
| Page, option, or parameter | Detailed information |
|---|---|
DFA Fs |
Sampling frequency in Hz used to convert DFA windows, trimming, and filter ranges into samples. Leave empty only when the parsed dataframe contains a valid sampling frequency. |
DFA Normalize |
Standardize each signal before DFA preprocessing. Enable to reduce sensitivity to absolute offset and scale; disable when amplitude differences should remain part of the analysis. |
DFA Input Is Envelope |
Describe the supplied signal type. Select false for raw time series that must be band-pass filtered and Hilbert-transformed into amplitude envelopes. Select true only when every input is already the intended band-limited amplitude envelope; filtering settings are then ignored. |
DFA Trim Seconds |
Number of seconds removed from both edges after filtering and envelope extraction to reduce boundary artifacts. Use 0 to keep all samples. Excessive trimming can leave too little data for the requested DFA windows. |
DFA Overlap |
Use 50% overlap between consecutive DFA windows at each evaluated scale. Overlap provides more fluctuation estimates but increases computation and dependence between windows. |
DFA Fit Interval Min |
Smallest window duration in seconds included when fitting the log-log slope reported as DFA. It must be below Fit interval max and, when a compute interval is provided, lie inside it. |
DFA Fit Interval Max |
Largest window duration in seconds included when fitting the log-log slope reported as DFA. It must exceed Fit interval min, lie inside the optional compute interval, and remain feasible for the signal length. |
DFA Compute Interval Min |
Optional smallest DFA window duration in seconds evaluated by the algorithm. It may extend below the fit interval to retain diagnostic fluctuation values. Leave the compute pair empty to use method defaults. |
DFA Compute Interval Max |
Optional largest DFA window duration in seconds evaluated by the algorithm. It must exceed Compute interval min and contain the complete fit interval. |
DFA Frequency Min |
Lower cutoff in Hz of the single band used to filter raw signals before DFA. Provide it with Band frequency max. This single-band mode cannot be combined with Spectrum range and is ignored for envelope inputs. |
DFA Frequency Max |
Upper cutoff in Hz of the single band used to filter raw signals before DFA. It must exceed Band frequency min and remain below Nyquist. |
DFA Spectrum Min |
Lower bound in Hz used to generate multiple analysis bands across a spectrum range. Provide it with Spectrum range max. This mode cannot be combined with Band frequency and is ignored for envelope inputs. |
DFA Spectrum Max |
Upper bound in Hz used to generate multiple analysis bands across a spectrum range. It must exceed Spectrum range min and remain within the supported frequency range. |
DFA Bad Idxes |
Optional comma-separated zero-based channel indexes excluded before DFA computation, for example 0,2,5. Use indexes matching the channel order of the input sample. |
DFA Hilbert N FFT |
Optional FFT length used by the Hilbert-transform step when converting filtered raw signals into amplitude envelopes. Leave empty for the backend default. It is ignored when Input is envelope is true. |
DFA Filter Kwargs |
Optional Python dictionary of keyword arguments passed to the filtering operation before Hilbert envelope extraction, for example {"fir_design":"firwin"}. Use valid backend filter arguments only. It is ignored for envelope inputs. |
DFA Output Key |
Select the DFA result stored in the Features column. DFA value stores the fitted scaling exponent, intercept stores the fitted log-log intercept, full dictionary preserves diagnostics, and Custom path extracts another result. |
DFA Output Path |
Dictionary path extracted when Saved output value is Custom path, for example DFA or dfa_intercept. The resolved value is converted to a numeric scalar for the Features column. |
Functional excitation-inhibition ratio (fEI)21 entries
| Page, option, or parameter | Detailed information |
|---|---|
fEI Fs |
Sampling frequency in Hz used for fEI windows, DFA scales, trimming, and filtering. Leave empty only when a valid sampling frequency is present in the parsed dataframe. |
fEI Normalize |
Standardize each signal before fEI preprocessing. Enable to reduce differences caused by absolute offset and scale; disable when amplitude magnitude must remain meaningful. |
fEI Input Is Envelope |
Describe the supplied signal type. Select false for raw signals that must be filtered and Hilbert-transformed. Select true only when every input already contains the intended band-limited amplitude envelope; frequency and filtering settings are then ignored. |
fEI Trim Seconds |
Number of seconds removed from both edges after filtering and envelope extraction to reduce boundary artifacts. Use 0 to disable trimming. Ensure enough data remains for fEI and DFA windows. |
fEI Window Size Sec |
Required duration in seconds of each amplitude window used to estimate fEI. Larger windows provide more stable local amplitude and fluctuation estimates but reduce the number of windows and temporal detail. |
fEI Window Overlap |
Fraction of each fEI amplitude window shared with the next window. Use a value from 0 inclusive to 1 exclusive: 0 creates non-overlapping windows, while larger values increase window count and computation. |
fEI DFA Threshold |
Minimum DFA exponent used to consider the fEI estimate interpretable under the method’s scale-free criterion. Windows or results below the threshold are handled according to the fEI implementation and reported diagnostics. |
fEI DFA Overlap |
Use 50% overlap between consecutive windows used by the internal DFA calculation. Overlap increases the number of fluctuation estimates at each scale but also increases computation. |
fEI DFA Fit Interval Min |
Smallest DFA window duration in seconds used to fit the scaling exponent calculated alongside fEI. It must be below DFA fit interval max and lie inside the optional DFA compute interval. |
fEI DFA Fit Interval Max |
Largest DFA window duration in seconds used to fit the scaling exponent calculated alongside fEI. It must exceed the minimum, fit inside the optional compute interval, and be feasible for the signal length. |
fEI DFA Compute Interval Min |
Optional smallest window duration in seconds evaluated by the internal DFA calculation. It may extend below the fit interval to preserve diagnostic fluctuation values. |
fEI DFA Compute Interval Max |
Optional largest window duration in seconds evaluated by the internal DFA calculation. It must exceed the minimum and contain the complete DFA fit interval. |
fEI Frequency Min |
Lower cutoff in Hz of the single band used to filter raw signals before fEI. Provide it with Band frequency max. It cannot be combined with Spectrum range and is ignored for envelope inputs. |
fEI Frequency Max |
Upper cutoff in Hz of the single band used to filter raw signals before fEI. It must exceed Band frequency min and remain below Nyquist. |
fEI Spectrum Min |
Lower bound in Hz used to generate multiple analysis bands for fEI. Provide it with Spectrum range max. It cannot be combined with Band frequency and is ignored for envelope inputs. |
fEI Spectrum Max |
Upper bound in Hz used to generate multiple analysis bands for fEI. It must exceed Spectrum range min and remain within the supported frequency range. |
fEI Bad Idxes |
Optional comma-separated zero-based channel indexes excluded before fEI computation, for example 0,2,5. Use indexes matching the channel order of the input sample. |
fEI Hilbert N FFT |
Optional FFT length used by the Hilbert-transform step when converting filtered raw signals into amplitude envelopes. Leave empty for the backend default. It is ignored for envelope inputs. |
fEI Filter Kwargs |
Optional Python dictionary of keyword arguments passed to filtering before Hilbert envelope extraction, for example {"fir_design":"firwin"}. Use valid backend filter arguments only. It is ignored for envelope inputs. |
fEI Output Key |
Select the fEI result stored in the Features column. Options include the primary scalar, outlier-aware variants, DFA, diagnostic arrays, outlier count, the full result dictionary, or a custom nested path. |
fEI Output Path |
Dictionary path extracted when Saved output value is Custom path, for example fEI_outliers_removed, DFA, or wAmp. Scalar outputs are stored directly; diagnostic arrays are preserved when selected. |
Custom feature functions2 entries
| Page, option, or parameter | Detailed information |
|---|---|
Custom Normalize |
Standardize each signal before passing it to custom_feature(sample, params). Enable when the custom feature should be independent of absolute offset and scale. The function receives the normalized sample only when this option is selected. |
Custom Feature Script |
Python source code defining custom_feature(sample, params). The function runs once per parsed signal and must return a numeric scalar or numeric array; arrays must have equal length for every sample. Raise clear errors for invalid inputs and avoid relying on state that is unavailable in worker processes. |
Electrophysiology dataset parser37 entries
| Page, option, or parameter | Detailed information |
|---|---|
Parser Data Locator |
Select the field, dataframe column, nested object path, or detected source value that contains the electrophysiological signal to parse. The resolved value should be a numeric time series or array. For arrays, use the axis mapping controls to identify channels, samples, IDs, and existing trials/epochs. This value becomes the canonical data column used by feature extraction. |
Parser Array Axes Enabled |
Enable explicit array-axis mapping when automatic orientation detection is uncertain or incorrect. The mapping tells the parser what each dimension of the selected data array represents and overrides heuristic axis detection. Assign each role to a different dimension and verify the selected dimensions against the inspected array shape. |
Parser Axis Channels |
Select the array dimension containing sensors or channels. The parser splits this dimension into separate canonical sensor rows. Choose None only when the data has no channel dimension or already represents one signal per parsed item. |
Parser Axis Samples |
Select the array dimension containing consecutive time samples. This is the signal dimension used for temporal segmentation, z-scoring, epoching, and feature computation. It must identify the time-series axis rather than channels, subjects, or trials. |
Parser Axis Ids |
Optionally select the dimension containing independent IDs or subjects. The parser treats entries along this axis as distinct observations. Choose None when IDs are supplied through metadata, filenames, folders, or are not represented as an array dimension. |
Parser Axis Epochs |
Optionally select a dimension containing trials or epochs already present in the source array. Entries along this axis receive separate epoch identifiers. Parser-driven epoching can still be enabled later to divide each existing trial into shorter windows. |
Parser Fs Source |
Choose how the parser obtains sampling frequency in Hz. Select Numeric value to apply one manually entered frequency to the parsed signals, choose a detected field or nested locator when frequency is stored in the source data, or choose None only when downstream operations do not require time-to-sample conversion. Correct sampling frequency is required for temporal segmentation, epoching, and frequency-based features. |
Parser Fs Manual |
Sampling frequency in Hz applied when Sampling frequency source is Numeric value. Enter samples per second, not the simulation time step. For example, a 0.0625 ms time step corresponds to 16000 Hz. The value must match the actual data to produce correct epoch lengths, time bounds, and spectral frequencies. |
Parser Ch Names Source |
Choose where channel names come from. Autocomplete creates generic sequential names, such as ch0, ch1, and ch2. Select a detected field when the dataset already stores channel names, or choose Manual list to enter comma-separated names below. Ensure the number and order of names match the channels in the data. |
Parser Sensor Names |
Comma-separated sensor or channel labels used when Channel names source is Manual list. Enter names in the same order as channels appear along the configured Channels axis, with one label per channel, for example Fz, Cz, Pz. |
Parser Recording Type Source |
Choose whether recording modality is assigned from one constant value, read from a detected source field, or left unset. Recording type becomes canonical metadata used to distinguish signals such as LFP, CDM, EEG, MEG, and ECoG in downstream feature and analysis workflows. |
Parser Recording Type |
Constant recording modality assigned to every parsed row when Recording type source uses a custom value. Select the physical signal type represented by the data; choose Unknown only when the modality cannot be determined. |
Parser Metadata Mode |
Choose how canonical metadata is populated. Empirical mode lets you map subject ID, group, species, and condition from source fields, filenames, token values, or constants. Simulated mode creates synthetic simulation metadata and uses available trial or repetition information for conditions. |
Parser Metadata Subject Id Source |
Select the source used to populate canonical subject_id for empirical data. Use a detected field or filename-derived value when each file contains different subjects, Custom value when all parsed rows belong to one subject, or None when subject identity is unavailable. Subject IDs are also required for joining subject-level additional metadata. |
Parser Metadata Subject Id |
Constant subject identifier assigned to every parsed row when Subject ID source is Custom value. Use a stable identifier that can also match the selected link field in any additional metadata table. |
Parser Metadata Group Source |
Select the source used to populate canonical group metadata, such as control, treatment, cohort, or diagnosis. The value may come from source data, filenames, filename-format tokens, or a constant. Choose None when no meaningful group classification exists. |
Parser Metadata Group |
Constant group label assigned to every parsed row when Group source is Custom value, for example control or treatment. |
Parser Metadata Species Source |
Select the source used to populate canonical species metadata. Use a source field, filename-derived value, or constant that describes the organism represented by each recording; choose None when species is unknown or irrelevant. |
Parser Metadata Species |
Constant species label assigned to every parsed row when Species source is Custom value, for example human, mouse, or rat. |
Parser Metadata Condition Source |
Select the source used to populate canonical experimental condition metadata, such as rest, task, baseline, or stimulation. Conditions can come from source fields, filenames, filename-format tokens, or a constant and are commonly used for grouping feature outputs. |
Parser Metadata Condition |
Constant experimental-condition label assigned to every parsed row when Condition source is Custom value, for example rest or baseline. |
Parser Subject Id Locator |
Select the source field or filename-derived value that becomes canonical subject_id for each empirical recording. This identifier distinguishes subjects and is used as the key when joining additional subject-level metadata. |
Parser Group Locator |
Select the source field or filename-derived value that becomes canonical group metadata for each empirical recording, such as cohort, treatment, or diagnosis. |
Parser Species Locator |
Select the source field or filename-derived value that becomes canonical species metadata for each empirical recording. |
Parser Condition Locator |
Select the source field or filename-derived value that becomes canonical condition metadata for each empirical recording, such as rest, task, baseline, or stimulation. |
Parser Zscore |
Enable z-score normalization by subtracting the mean and dividing by the population standard deviation. Then use Z-score timing to choose whether the selected continuous signal is standardized once before epoching or each generated epoch is standardized independently after epoching. |
Parser Zscore After Epoch |
Choose when enabled z-score normalization is applied. Before epoching standardizes the selected continuous signal once, so all generated epochs share one normalization reference. After epoching standardizes every generated epoch independently. |
Parser Segment T0 S |
Optional non-negative start time in seconds for cropping each time-domain signal before normalization, epoching, and aggregation. Set only this value to keep data from the selected time to the end. Leave both segment times empty to use the full signal. The parser uses sampling frequency and existing time bounds to convert this time to samples. |
Parser Segment T1 S |
Optional end time in seconds for cropping each time-domain signal before normalization, epoching, and aggregation. Set only this value to keep data from the beginning to the selected time. It must be greater than the start time when both are provided. Leave both segment times empty to use the full signal; when epoching is enabled, the selected segment must be at least one epoch long. |
Additional File Link Field |
Select the column in the additional metadata table whose values match canonical subject_id in the parsed dataset. The parser uses this key to join subject-level annotations such as group, condition, species, and recording type. Choose a column with stable identifiers and compatible values; unmatched subjects retain their existing metadata. |
Parser Enable Epoching |
Split each continuous time-domain sensor row into fixed-length sliding windows before feature extraction. Epoching requires a valid sampling frequency. Existing trials or epochs remain distinct and can each be subdivided further. Complete windows are emitted and epoch counts are aligned across comparable series. |
Parser Enable Aggregate |
Combine parsed rows across selected categorical fields after segmentation, normalization, and epoching. Aggregation reduces multiple sensors, epochs, subjects, or metadata groups into fewer signals using the selected reduction method. Only aggregate signals that have compatible array shapes and meaningful units. |
Parser Aggregate Over |
Select one or more canonical fields to collapse during aggregation. For example, selecting sensor combines channels while preserving other metadata; selecting epoch combines epochs and removes epoch-specific time bounds. All non-selected metadata fields remain grouping keys. |
Parser Aggregate Method |
Reduction applied element-by-element to aligned signal arrays in each aggregation group. Sum preserves total contribution, mean produces the arithmetic average, and median provides a robust central signal. Input arrays within a group must have compatible shapes. |
Parser Aggregate Label Value |
Optional replacement label written into each aggregated field, such as all or aggregate, so output rows clearly indicate that multiple original categories were combined. |
Parser Epoch Length S |
Duration in seconds of each fixed-length epoch generated from continuous time-domain signals. Sampling frequency converts this duration to samples. The value must be positive and cannot exceed the selected temporal segment; signals too short for one complete window remain unepoched. |
Parser Epoch Step S |
Time shift in seconds between consecutive epoch starts. Use the same value as epoch length for adjacent non-overlapping windows, a smaller positive value for overlapping windows, or a larger value to leave gaps. When omitted, the parser uses the epoch length. |
Data loading and parser workflow guidance6 entries
| Page, option, or parameter | Detailed information |
|---|---|
Data folder for feature extraction |
Select one or more folders containing the signals from which features will be computed. The folder may contain empirical recordings, simulation outputs, numeric arrays, or tabular datasets in supported formats such as MAT, NWB, NPY, CSV, TSV, Parquet, pickle, Excel, Feather, EEGLAB SET, FIF, EDF, BrainVision, or CTF DS. Nested folders are supported up to six levels. The application inspects representative files to detect candidate signal fields, sampling frequency, channel names, array axes, and metadata, then uses the parser configuration shown below to convert the selected data into a common dataframe before feature extraction. Files processed together within each folder should use the same structure, field names, dimensions, and units; inconsistent files may fail parsing or produce incorrect results. |
Additional metadata files |
Optionally select individual files that describe or annotate the dataset selected in Data folder for feature extraction. These files are inspected together with the main data and can provide fields that are not stored in each recording, such as channel names, subject identifiers, experimental groups, species, conditions, or recording types. Tabular formats such as CSV, TSV, Excel, Parquet, and Feather are recommended: use one row per subject, channel, or other mapping item and clear column names. For subject-level enrichment, the parsed data must contain subject_id and the selected link-field column in the metadata file must contain matching subject identifiers. Metadata columns can then be mapped to canonical parser fields; a selected channel-name column can also supply channel labels. Additional metadata files complement the signal data and are not themselves treated as the primary signals for feature extraction. |
Filename format (optional) |
Optional pattern used to select files during folder inspection and extract metadata values from their names. Build the format from literal text, which must appear exactly, and variable tokens enclosed between dollar signs, such as $id$, $group$, or $condition$. Token names must start with a letter, may contain letters, numbers, and underscores, and may appear only once in a format. The pattern must contain at least one token. It is matched against each candidate file name rather than its folder path, including files inside nested datasets. Include the extension as literal text, for example .pkl, when only that complete filename form should match; when the format omits an explicit extension, matching can also use the filename stem. Files that do not match are excluded from inspection and feature extraction. Values captured by tokens become available as metadata sources, so a format such as $id$-$group$_$condition$.pkl can extract subject, group, and condition values from matching file names. Select Inspect to apply the current format and reinspect the data source. Select Use automatic detection to clear the format and inspect supported files without filename filtering. |
Configure EphysDatasetParser |
Configure how heterogeneous electrophysiology files are converted into the canonical dataframe used by feature extraction. Map the signal, sampling frequency, channels, array dimensions, recording modality, and metadata to their source fields; then optionally crop time ranges, normalize signals, create fixed-length epochs, and aggregate rows. Processing is applied in this order: parse source fields, crop the temporal segment, z-score before epoching when selected, create epochs, z-score each epoch when selected, and aggregate last. Review detected defaults carefully, especially array axes and sampling frequency, because incorrect mappings can produce plausible but invalid features. |
Data origin |
Choose how canonical metadata is populated for the parsed dataset. Select Empirical when processing measured recordings: this mode lets you map subject ID, group, species, and condition from detected source fields, filename-derived values, filename-format tokens, or constants. Select Simulated when processing generated neural activity: this mode creates metadata for one simulated subject and uses available trial or repetition information to populate conditions. Data origin changes metadata handling only; it does not change the selected signal data or recording type. |
Z-score timing |
Choose when enabled z-score normalization is applied. Before epoching standardizes the selected continuous signal once, so all generated epochs share one normalization reference. After epoching standardizes every generated epoch independently. |
WebUI module
37 entries
Inference
Inverse-model training, model assets, prediction settings, and SBI controls.
Module overview and available workflows5 entries
| Page, option, or parameter | Detailed information |
|---|---|
Inference module |
Train inverse models from simulated features and parameters, or use trained models to estimate parameters from feature data. |
Load data |
Load precomputed parameter predictions. |
New training |
Train a new inverse model from paired simulation parameters and features. |
Compute predictions |
Use a trained inverse model to estimate parameters from feature data. |
/inference/load_data |
Load precomputed predictions |
Inverse-model training13 entries
| Page, option, or parameter | Detailed information |
|---|---|
Training Model Name |
Select the inverse model trained to predict neural-circuit parameters from feature vectors. Scikit-learn regressors produce point predictions and suit standard supervised regression. NPE, NLE, and NRE use simulation-based inference to estimate posterior information and require SBI prior bounds. Changing the model refreshes the example hyperparameters and parameter grid. |
Training Hyperparams Json |
Base model configuration provided as a valid JSON object. For scikit-learn models, use constructor arguments accepted by the selected estimator. For SBI models, configure estimator_kwargs, inference_kwargs, and build_posterior_kwargs. These values are used directly in Single trial mode and serve as the base configuration during hyperparameter search. |
Training Param Grid Json |
Candidate hyperparameter configurations evaluated in Hyperparameter search mode. Provide a JSON object whose values are candidate lists, or a JSON list of complete parameter objects. Every resulting configuration is evaluated with repeated cross-validation; larger grids multiply training time. |
Training SBI Train Params Json |
Arguments passed to the SBI training procedure, such as max_num_epochs, training_batch_size, learning_rate, and show_train_summary. Use valid JSON keys supported by the installed SBI backend. These settings control optimization of each SBI density estimator. |
Training SBI Eval Sampling Kwargs Json |
Posterior-sampling arguments used to evaluate SBI candidates during hyperparameter search. sample_shape controls the number of posterior samples generated per validation observation. NLE and NRE may also require MCMC-related settings such as method, thin, num_chains, or num_workers. |
Training N Splits |
Number of cross-validation folds used for each candidate in Hyperparameter search mode. It must be greater than 1 and should not exceed the number of paired training rows. More folds train on more data per fold but increase runtime. |
Training N Repeats |
Number of times the cross-validation procedure is repeated with different seeded splits in Hyperparameter search mode. More repeats provide a more stable estimate of model performance but multiply computation. |
Training Seed |
Random seed used for deterministic row subsampling, cross-validation splitting, and supported model randomization. Reuse the same seed and configuration to improve reproducibility. |
Training Scaler Type |
Transformation fitted only on training features when Use scaler is enabled and saved with the trained model. StandardScaler centers and scales variance; MinMaxScaler maps ranges; RobustScaler uses robust statistics; MaxAbsScaler scales by maximum absolute value. |
Training Use Scaler |
Fit and apply the selected feature scaler before model training, then save it with the trained assets for consistent prediction preprocessing. Scaling is usually important for neural networks, SVR, Ridge, and other magnitude-sensitive models, but often unnecessary for random forests. |
Training Sklearn Verbose |
Non-negative verbosity level passed to supported scikit-learn training and validation procedures. Use 0 for minimal output and larger values for more progress information. It does not apply to SBI models. |
Training Subsample Percent |
Percentage of paired feature and parameter rows randomly retained before training. Use 100 or leave empty to use the complete dataset. Subsampling uses Seed and preserves X/Y row pairing; lower percentages reduce runtime but discard training information. |
SBI Prior |
Lower and upper bounds of the BoxUniform prior for each inferred theta parameter. Add one ordered pair per target dimension, ensure low is strictly below high, and choose bounds that cover plausible values and the simulation support. |
Prediction data and model assets3 entries
| Page, option, or parameter | Detailed information |
|---|---|
Features Source Mode |
Choose where feature data is loaded from. The selected data must match the feature structure expected by the trained model. |
Inference Model Assets Source |
Choose the source of trained model assets. Include the model and any scaler used during training. |
Inference Scaler |
Scaler fitted during model training. Supply it when training used scaling so prediction inputs receive the same transformation. |
Prediction and posterior-sampling controls9 entries
| Page, option, or parameter | Detailed information |
|---|---|
SBI Sample Shape |
Number or shape of posterior samples generated per observation. More samples improve posterior summaries but increase runtime. |
Inference Model Name |
Select the prediction backend associated with the uploaded model artifact. Auto is recommended because it inspects the artifact and initializes the matching scikit-learn or SBI model. Choose a model manually only when automatic detection fails and you know the artifact type; selecting an incompatible model causes loading or prediction errors. |
Use Scaler |
Apply the uploaded fitted scaler to feature vectors before prediction. Enable this only when the selected model was trained with that exact scaler. The option is unavailable until a scaler artifact is provided; omitting a required scaler or applying the wrong one produces predictions from incompatible inputs. |
Inference N Jobs |
Number of worker processes used for scikit-learn prediction across feature rows. Use 1 for sequential execution and easier debugging. Larger values can reduce runtime for large inputs but consume additional CPU and memory. This setting does not apply to SBI prediction. |
Inference Chunksize |
Optional number of feature rows assigned to each scikit-learn worker task. Smaller chunks improve load balancing, while larger chunks reduce multiprocessing overhead. Leave empty to use backend defaults. This setting does not apply to SBI prediction. |
Inference Start Method |
Process-creation strategy used for parallel scikit-learn prediction. spawn is portable and starts clean workers; fork can be faster on supported Unix systems but inherits process state; forkserver uses a dedicated worker server where supported. This setting does not apply to SBI prediction. |
Inference SBI Eval Sampling Kwargs Json |
Valid JSON arguments controlling posterior sampling for SBI prediction. sample_shape sets how many posterior samples are drawn per feature row. NLE and NRE may also use MCMC settings such as method, thin, num_chains, or num_workers. More samples improve summary stability but increase runtime and memory use. |
SBI Summary Mode |
Statistic used to convert posterior samples for each feature row into the value stored in Predictions. Posterior mean averages samples and is sensitive to skew and outliers; posterior median is more robust and may better represent asymmetric posterior distributions. |
Inference Subsample Percent |
Percentage of input feature rows used for prediction. Use 100 to predict every row. Values below 100 select a deterministic random subset using seed 0, and the saved output contains predictions only for that retained subset. |
Training workflow guidance4 entries
| Page, option, or parameter | Detailed information |
|---|---|
Features Data * |
Select the feature dataset used as model inputs X. Supported files are loaded as numeric matrices or dataframes; when a dataframe contains a Features column, that column is converted into the input matrix. Each row must correspond to the same observation or simulation as the matching row in Parameters Data, and all feature vectors must have a consistent numeric shape. |
Parameters Data * |
Select the target neural-circuit parameter dataset used as training outputs Y or theta. It may contain one target or multiple parameter dimensions. Its rows must be ordered consistently with Features Data and the number of rows must match exactly, because row i in the feature dataset is paired with row i in the parameter dataset. |
Training strategy |
Choose how models and hyperparameters are evaluated. Single trial trains one model using Model Hyperparameters on the available training rows. Hyperparameter search evaluates every configuration from Parameter Grid using repeated cross-validation, then selects and trains the best configuration. |
BoxUniform Prior Bounds (per theta parameter) |
Define the lower and upper bounds of the independent uniform prior used by SBI for every inferred theta parameter. Add one row per target dimension, keep the row order consistent with Parameters Data, and ensure low is strictly smaller than high. Priors should cover scientifically plausible parameter values and the support represented by the simulations. |
Prediction workflow guidance3 entries
| Page, option, or parameter | Detailed information |
|---|---|
Features Data * |
Select the feature dataframe used as prediction input. It must contain a Features column whose rows are numeric feature vectors compatible with the selected trained model: feature count, order, preprocessing, and units must match the data used during training. The resulting Predictions column is attached to the selected or subsampled rows. |
Sklearn Model / SBI Posterior * |
Select the trained prediction artifact. For a scikit-learn workflow, provide the serialized fitted model. For SBI, provide the serialized posterior object produced during training. Auto model detection inspects this artifact to determine the backend and model type; the artifact must be compatible with the ncpi and dependency versions used for prediction. |
Scaler (optional) |
Optionally select the fitted feature scaler saved during model training. Supply the exact scaler associated with the selected model whenever training used scaling; a different or newly fitted scaler changes the feature representation and can invalidate predictions. |
WebUI module
39 entries
Analysis
Boxplots, topographic maps, and simulation-result visualization controls.
Module overview and available workflows2 entries
| Page, option, or parameter | Detailed information |
|---|---|
Analysis module |
Explore, visualize, and statistically analyze generated data, extracted features, and inferred parameter results. |
/analysis |
Configure visualization and statistical analysis of dataframes or simulation outputs, including boxplots, topographic maps, and simulation-result plots. |
Boxplot configuration6 entries
| Page, option, or parameter | Detailed information |
|---|---|
Boxplot Group By |
Categorical column used to divide values into boxplot groups. |
Boxplot Value Col |
Numeric column summarized by the boxplot. |
Boxplot Showfliers |
Display observations beyond the whiskers as individual outlier markers. |
Boxplot Width |
Relative width of each box. Enter a positive numeric value. |
Boxplot Linewidth |
Width of boxplot outlines and whiskers. |
Boxplot Control Group |
Reference category used when computing effect sizes against other groups. |
Topographic-map configuration20 entries
| Page, option, or parameter | Detailed information |
|---|---|
Topomap Signal Type |
Select EEG or MEG so the appropriate sensor geometry and plotting conventions are used. |
Topomap MEG Atlas |
Atlas or sensor layout used to position MEG values on the topographic map. |
Topomap Grouping Mode |
Choose whether maps summarize each sensor grouping or compare categories within a selected column. |
Topomap Compare Method |
Method used to compare categories: raw subtraction preserves units, while Cohen's d expresses standardized effect size. |
Topomap Cohend Abs Threshold |
Minimum absolute Cohen's d displayed. Increase it to hide weak effects. |
Topomap Group By |
Categorical column defining the groups or conditions displayed in topographic maps. |
Topomap Control Group |
Reference category used for category comparisons. |
Topomap Value Col |
Numeric measurement mapped to sensor positions. |
Topomap Sensor Col |
Column containing sensor or channel names. Names must match the selected montage or atlas. |
Topomap EEG Montage |
EEG electrode montage used to obtain standard sensor coordinates. |
Topomap EEG Ch Type |
MNE channel type used when constructing EEG sensor information. |
Topomap Cmap |
Matplotlib colormap used to encode values. Choose a sequential map for magnitudes or a diverging map for signed contrasts. |
Topomap Vmin |
Lower color-scale limit. Leave as auto to derive it from the plotted data. |
Topomap Vmax |
Upper color-scale limit. Leave as auto to derive it from the plotted data. |
Topomap Res |
Image resolution of the interpolated topographic map. Higher values improve smoothness but increase rendering time. |
Topomap Contours |
Number or mode of contour lines drawn over the topographic map. |
Topomap Extrapolate |
Controls interpolation outside the sensor convex hull. |
Topomap Image Interp |
Interpolation method used when rendering the topographic image. |
Topomap Show Sensors |
Show sensor locations on top of the interpolated map. |
Topomap Scale Mode |
Controls whether maps share a common color scale or use separate scales. |
Simulation-result plots11 entries
| Page, option, or parameter | Detailed information |
|---|---|
Sim Plot Type |
Type of simulation result visualization to generate. |
Sim Trial Start |
First trial index included in the plot. Indices are zero-based. |
Sim Trial End |
Last trial boundary included in the plot. Leave empty where supported to include remaining trials. |
Sim Time Start |
Beginning of the plotted time interval. |
Sim Time End |
End of the plotted time interval. |
Sim Freq Min |
Lowest frequency included in spectral plots. |
Sim Freq Max |
Highest frequency included in spectral plots. |
Sim CDM Psd Mode |
Method used to combine or display current-dipole-moment power spectra. |
Sim Welch N per segment |
Number of samples per Welch segment used for simulation-result spectra. |
Sim Welch N overlap |
Number of overlapping samples between adjacent Welch segments. |
Sim Welch NFFT |
FFT length used by Welch spectral estimation. |