filtering:Optional[str]=Field(None,description="""Filtering applied to all channels of the data. For example, if this ElectricalSeries represents high-pass-filtered data (also known as AP Band), then this value could be \"High-pass 4-pole Bessel filter at 500 Hz\". If this ElectricalSeries represents low-pass-filtered LFP data and the type of filter is unknown, then this value could be \"Low-pass filter at 300 Hz\". If a non-standard filter type is used, provide as much detail about the filter properties as possible.""")
data:ElectricalSeriesData=Field(...,description="""Recorded voltage data.""")
electrodes:ElectricalSeriesElectrodes=Field(...,description="""DynamicTableRegion pointer to the electrodes that this time series was generated from.""")
channel_conversion:Optional[List[float]]=Field(default_factory=list,description="""Channel-specific conversion factor. Multiply the data in the 'data' dataset by these values along the channel axis (as indicated by axis attribute) AND by the global conversion factor in the 'conversion' attribute of 'data' to get the data values in Volts, i.e, data in Volts = data * data.conversion * channel_conversion. This approach allows for both global and per-channel data conversion factors needed to support the storage of electrical recordings as native values generated by data acquisition systems. If this dataset is not present, then there is no channel-specific conversion factor, i.e. it is 1 for all channels.""")
description:Optional[str]=Field(None,description="""Description of the time series.""")
comments:Optional[str]=Field(None,description="""Human-readable comments about the TimeSeries. This second descriptive field can be used to store additional information, or descriptive information if the primary description field is populated with a computer-readable string.""")
starting_time:Optional[TimeSeriesStartingTime]=Field(None,description="""Timestamp of the first sample in seconds. When timestamps are uniformly spaced, the timestamp of the first sample can be specified and all subsequent ones calculated from the sampling rate attribute.""")
timestamps:Optional[List[float]]=Field(default_factory=list,description="""Timestamps for samples stored in data, in seconds, relative to the common experiment master-clock stored in NWBFile.timestamps_reference_time.""")
control:Optional[List[int]]=Field(default_factory=list,description="""Numerical labels that apply to each time point in data for the purpose of querying and slicing data by these values. If present, the length of this array should be the same size as the first dimension of data.""")
control_description:Optional[List[str]]=Field(default_factory=list,description="""Description of each control value. Must be present if control is present. If present, control_description[0] should describe time points where control == 0.""")
sync:Optional[TimeSeriesSync]=Field(None,description="""Lab-specific time and sync information as provided directly from hardware devices and that is necessary for aligning all acquired time information to a common timebase. The timestamp array stores time in the common timebase. This group will usually only be populated in TimeSeries that are stored external to the NWB file, in files storing raw data. Once timestamp data is calculated, the contents of 'sync' are mostly for archival purposes.""")
classElectricalSeriesData(ConfiguredBaseModel):
"""
Recordedvoltagedata.
"""
name:Literal["data"]=Field("data")
unit:Optional[str]=Field(None,description="""Base unit of measurement for working with the data. This value is fixed to 'volts'. Actual stored values are not necessarily stored in these units. To access the data in these units, multiply 'data' by 'conversion', followed by 'channel_conversion' (if present), and then add 'offset'.""")
timestamps:List[float]=Field(default_factory=list,description="""Timestamps for samples stored in data, in seconds, relative to the common experiment master-clock stored in NWBFile.timestamps_reference_time. Timestamps are required for the events. Unlike for TimeSeries, timestamps are required for SpikeEventSeries and are thus re-specified here.""")
filtering:Optional[str]=Field(None,description="""Filtering applied to all channels of the data. For example, if this ElectricalSeries represents high-pass-filtered data (also known as AP Band), then this value could be \"High-pass 4-pole Bessel filter at 500 Hz\". If this ElectricalSeries represents low-pass-filtered LFP data and the type of filter is unknown, then this value could be \"Low-pass filter at 300 Hz\". If a non-standard filter type is used, provide as much detail about the filter properties as possible.""")
electrodes:ElectricalSeriesElectrodes=Field(...,description="""DynamicTableRegion pointer to the electrodes that this time series was generated from.""")
channel_conversion:Optional[List[float]]=Field(default_factory=list,description="""Channel-specific conversion factor. Multiply the data in the 'data' dataset by these values along the channel axis (as indicated by axis attribute) AND by the global conversion factor in the 'conversion' attribute of 'data' to get the data values in Volts, i.e, data in Volts = data * data.conversion * channel_conversion. This approach allows for both global and per-channel data conversion factors needed to support the storage of electrical recordings as native values generated by data acquisition systems. If this dataset is not present, then there is no channel-specific conversion factor, i.e. it is 1 for all channels.""")
description:Optional[str]=Field(None,description="""Description of the time series.""")
comments:Optional[str]=Field(None,description="""Human-readable comments about the TimeSeries. This second descriptive field can be used to store additional information, or descriptive information if the primary description field is populated with a computer-readable string.""")
starting_time:Optional[TimeSeriesStartingTime]=Field(None,description="""Timestamp of the first sample in seconds. When timestamps are uniformly spaced, the timestamp of the first sample can be specified and all subsequent ones calculated from the sampling rate attribute.""")
control:Optional[List[int]]=Field(default_factory=list,description="""Numerical labels that apply to each time point in data for the purpose of querying and slicing data by these values. If present, the length of this array should be the same size as the first dimension of data.""")
control_description:Optional[List[str]]=Field(default_factory=list,description="""Description of each control value. Must be present if control is present. If present, control_description[0] should describe time points where control == 0.""")
sync:Optional[TimeSeriesSync]=Field(None,description="""Lab-specific time and sync information as provided directly from hardware devices and that is necessary for aligning all acquired time information to a common timebase. The timestamp array stores time in the common timebase. This group will usually only be populated in TimeSeries that are stored external to the NWB file, in files storing raw data. Once timestamp data is calculated, the contents of 'sync' are mostly for archival purposes.""")
classSpikeEventSeriesData(ConfiguredBaseModel):
"""
Spikewaveforms.
"""
name:Literal["data"]=Field("data")
unit:Optional[str]=Field(None,description="""Unit of measurement for waveforms, which is fixed to 'volts'.""")
description:List[str]=Field(default_factory=list,description="""Description of features (eg, ''PC1'') for each of the extracted features.""")
features:FeatureExtractionFeatures=Field(...,description="""Multi-dimensional array of features extracted from each event.""")
times:List[float]=Field(default_factory=list,description="""Times of events that features correspond to (can be a link).""")
electrodes:FeatureExtractionElectrodes=Field(...,description="""DynamicTableRegion pointer to the electrodes that this time series was generated from.""")
detection_method:str=Field(...,description="""Description of how events were detected, such as voltage threshold, or dV/dT threshold, as well as relevant values.""")
source_idx:List[int]=Field(default_factory=list,description="""Indices (zero-based) into source ElectricalSeries::data array corresponding to time of event. ''description'' should define what is meant by time of event (e.g., .25 ms before action potential peak, zero-crossing time, etc). The index points to each event from the raw data.""")
times:List[float]=Field(default_factory=list,description="""Timestamps of events, in seconds.""")
Electrophysiologydatafromoneormorechannelsthathasbeensubjectedtofiltering.ExamplesoffiltereddataincludeThetaandGamma(LFPhasitsowninterface).FilteredEphysmodulespublishanElectricalSeriesforeachfilteredchannelorsetofchannels.ThenameofeachElectricalSeriesisarbitrarybutshouldbeinformative.Thesourceofthefiltereddata,whetherthisisfromanalysisofanothertimeseriesorasacquiredbyhardware,shouldbenotedineach's TimeSeries::description field. There is no assumed 1::1 correspondence between filtered ephys signals and electrodes, as a single signal can apply to many nearby electrodes, and one electrode may have different filtered (e.g., theta and/or gamma) signals represented. Filter properties should be noted in the ElectricalSeries 'filtering' attribute.
electrical_series:List[ElectricalSeries]=Field(default_factory=list,description="""ElectricalSeries object(s) containing LFP data for one or more channels.""")
description:Optional[str]=Field(None,description="""Description of this electrode group.""")
location:Optional[str]=Field(None,description="""Location of electrode group. Specify the area, layer, comments on estimation of area/layer, etc. Use standard atlas names for anatomical regions when possible.""")
position:Optional[Any]=Field(None,description="""stereotaxic or common framework coordinates""")
waveform_filtering:str=Field(...,description="""Filtering applied to data before generating mean/sd""")
waveform_mean:ClusterWaveformsWaveformMean=Field(...,description="""The mean waveform for each cluster, using the same indices for each wave as cluster numbers in the associated Clustering module (i.e, cluster 3 is in array slot [3]). Waveforms corresponding to gaps in cluster sequence should be empty (e.g., zero- filled)""")
waveform_sd:ClusterWaveformsWaveformSd=Field(...,description="""Stdev of waveforms for each cluster, using the same indices as in mean""")
description:str=Field(...,description="""Description of clusters or clustering, (e.g. cluster 0 is noise, clusters curated using Klusters, etc)""")
num:List[int]=Field(default_factory=list,description="""Cluster number of each event""")
peak_over_rms:List[float]=Field(default_factory=list,description="""Maximum ratio of waveform peak to RMS on any channel in the cluster (provides a basic clustering metric).""")
times:List[float]=Field(default_factory=list,description="""Times of clustered events, in seconds. This may be a link to times field in associated FeatureExtraction module.""")
