CLASS ndi.gui.app.stimulusResponse

  NDI.GUI.APP.STIMULUSRESPONSE - GUI to compute stimulus responses for elements

    OBJ = ndi.gui.app.stimulusResponse(SESSION)

    Opens a window (in the NDI Cloud colour scheme) that drives
    ndi.app.stimulus.tuning_response.stimulus_responses for the ndi.session
    SESSION. It lets you:

      * Choose a stimulator probe from a dropdown of the session's
        'stimulator'-type probes.
      * Choose one or more element types to compute responses for, from a
        multi-select listbox (currently just "spikes").
      * Tick "Replace existing responses" to rebuild responses from scratch.

    When run, for each element of the chosen type(s):

      * If "Replace existing responses" is ticked, a single (OR) database
        search first finds all stimulus_response documents for the chosen
        stimulator and the elements of the chosen type(s); those documents
        (and their scalar-parameter documents) are removed, then responses are
        recomputed for every element.
      * If it is not ticked, one search first lists the stimulus_response
        documents that already exist for the chosen stimulator. Any element
        that already has a response is left untouched; responses are computed
        only for elements that do not yet have one.

    Responses require that the stimuli have already been decoded and their
    control stimuli labeled (see ndi.gui.app.stimulusDecoder); without the
    'stimulus_presentation' and 'control_stimulus_ids' documents no responses
    are produced.

    Progress is shown in an NDI progress bar (ndi.gui.component.ProgressBarWindow),
    which docks into an open navigator's Progress pane when one is present.

    This is a session GUI app (see ndi.gui.app.sessionApp): its constructor
    takes the ndi.session as its first argument, so it can be launched from the
    ndi.gui.navigator "Apps" menu.

    Example:
        S = ndi.session.dir('/path/to/session');
        ndi.gui.app.stimulusResponse(S);

    See also: ndi.gui.app.sessionApp, ndi.gui.app.stimulusDecoder,
              ndi.app.stimulus.tuning_response, ndi.gui.component.ProgressBarWindow

Superclasses

ndi.gui.app.sessionApp, handle

Properties

Property	Description
Name
Category

Methods

Method	Description
addlistener	Create event listener bound to event source
defaultPackages	DEFAULTPACKAGES Packages scanned for session apps by default.
delete	Delete handle object
eq	Determine equality
findobj	Find handle objects
findprop	Find matlab.metadata.Property object
ge	Determine greater than or equal to
gt	Determine greater than
isvalid	Determine valid handles
launch	LAUNCH Construct a session GUI app uniformly from its name.
le	Determine less than or equal to
list	LIST Discover concrete session GUI apps on the path.
listener	Create event listener without binding to event source
lt	Determine less than
ne	Determine inequality
notify	Notify listeners that event is occurring
stimulusResponse	GUI to compute stimulus responses for elements

Methods help

addlistener - Create event listener bound to event source

Syntax
      el = addlistener(hSource,EventName,callback)
      el = addlistener(hSource,PropertyName,EventName,callback)
      addlistener(___)

    Input Arguments
      hSource - Event source
        handle array
      EventName - Name of event
        character vector | string scalar
      PropertyName - Name of property
        character vector | string | matlab.metadata.Property object
      callback - Listener callback
        function handle

    Output Arguments
      el - Listener object
        event.listener or event.proplistener

    Examples
      web /opt/hostedtoolcache/MATLAB/2026.2.999/x64/help/matlab/ref/handle.addlistener.html#d127e840757

    See also notify, event.listener, listener

    Introduced in MATLAB in R2008a

Help for ndi.gui.app.stimulusResponse/addlistener is inherited from superclass handle

    Documentation for addlistener
       doc addlistener

---

defaultPackages - DEFAULTPACKAGES Packages scanned for session apps by default.

The built-in ndi.gui.app and ndi.app packages plus any user
    packages registered in the preference
    GUI.Navigator.SessionAppPackages.

Help for ndi.gui.app.stimulusResponse.defaultPackages is inherited from superclass ndi.gui.app.sessionApp

---

delete - Delete handle object

Syntax
      delete(H)

    Input Arguments
      H - Handle object
        handle object or array of handle objects

    See also isvalid

    Introduced in MATLAB

Help for ndi.gui.app.stimulusResponse/delete is inherited from superclass handle

    Documentation for handle/delete
       doc handle/delete

---

eq - Determine equality

Syntax
      A == B
      eq(A,B)

    Input Arguments
      A - Operands
        scalars | vectors | matrices | multidimensional arrays | tables |
        timetables
      B - Operands
        scalars | vectors | matrices | multidimensional arrays | tables |
        timetables

    Examples
      openExample('matlab/EqualityOfTwoVectorsExample')
      openExample('matlab/FindCharactersInStringExample')
      openExample('matlab/FindValuesInCategoricalArrayExample')
      openExample('matlab/CompareFloatingPointNumbersExample')
      openExample('matlab/CompareDatetimeValuesExample')
      openExample('matlab/CompareTablesExample')

    See also isapprox, ge, gt, le, lt, ne

    Introduced in MATLAB before R2006a
    Documentation for eq
       doc eq

---

findobj - Find handle objects

Syntax
      Hmatch = findobj(H)
      Hmatch = findobj(H,property,value,...,property,value)
      Hmatch = findobj(H,'-not',property,value)
      Hmatch = findobj(H,'-regexp',property,expression)
      Hmatch = findobj(H,property,value,logicaloperator,property,value)
      Hmatch = findobj(H,'-function',fh)
      Hmatch = findobj(H,'-function',property,fh)
      Hmatch = findobj(H,'-class',class)
      Hmatch = findobj(H,'-isa',class)
      Hmatch = findobj(H,'-property',property)
      Hmatch = findobj(H,'-method',methodname)
      Hmatch = findobj(H,'-event',eventname)
      Hmatch = findobj(H,'-depth',d,___)

    Input Arguments
      H - Objects to search from
        handle array
      property - Property name
        character vector | string scalar
      class - Class of object to find
        character vector | string scalar | matlab.metadata.Class instance
      value - Property value
        any value
      methodname - Method name
        character vector | string scalar
      eventname - Event name
        character vector | string scalar
      d - Depth of search
        integer >= 0
      fh - Function handle
        function handle

    Output Arguments
      Hmatch - Objects found by search
        handle array

    Examples
      web /opt/hostedtoolcache/MATLAB/2026.2.999/x64/help/matlab/ref/handle.findobj.html#mw_17437b0f-a588-40bf-bae5-dcdd410a410e

    See also findprop

    Introduced in MATLAB in R2008a

Help for ndi.gui.app.stimulusResponse/findobj is inherited from superclass handle

    Documentation for handle/findobj
       doc handle/findobj

---

findprop - Find matlab.metadata.Property object

Syntax
      mp = findprop(h,property)

    Input Arguments
      h - handle object
        scalar handle
      property - Name of property
        character vector | string scalar

    Output Arguments
      mp - matlab.metadata.Property object
        matlab.metadata.Property | matlab.metadata.DynamicProperty

    Examples
      openExample('matlab/DisplayPropertyAttributesExample')

    See also matlab.metadata.Property, findobj,
      matlab.metadata.DynamicProperty

    Introduced in MATLAB

Help for ndi.gui.app.stimulusResponse/findprop is inherited from superclass handle

    Documentation for handle/findprop
       doc handle/findprop

---

ge - Determine greater than or equal to

Syntax
      A >= B
      ge(A,B)

    Input Arguments
      A - Operands
        scalars | vectors | matrices | multidimensional arrays | tables |
        timetables
      B - Operands
        scalars | vectors | matrices | multidimensional arrays | tables |
        timetables

    Examples
      openExample('matlab/TestVectorElementsExample')
      openExample('matlab/ReplaceElementsofMatrixExample')
      openExample('matlab/CompareValuesinCategoricalArrayExample')
      openExample('matlab/TestComplexNumbersExample')
      openExample('matlab/TestDurationValuesGeExample')
      openExample('matlab/CompareTablesGEExample')

    See also eq, lt, gt, le, ne

    Introduced in MATLAB before R2006a
    Documentation for ge
       doc ge

---

gt - Determine greater than

Syntax
      A > B
      gt(A,B)

    Input Arguments
      A - Operands
        scalars | vectors | matrices | multidimensional arrays | tables |
        timetables
      B - Operands
        scalars | vectors | matrices | multidimensional arrays | tables |
        timetables

    Examples
      openExample('matlab/TestVectorElementsGreaterThanExample')
      openExample('matlab/ReplaceElementsofMatrixGreaterExample')
      openExample('matlab/CompareValuesinCategoricalArrayGreaterExample')
      openExample('matlab/TestComplexNumbersGreaterExample')
      openExample('matlab/CompareDatesExample')
      openExample('matlab/CompareTablesGTExample')

    See also eq, ge, lt, le, ne

    Introduced in MATLAB before R2006a
    Documentation for gt
       doc gt

---

isvalid - Determine valid handles

Syntax
      B = isvalid(H)

    Input Arguments
      H - Input array
        handle array

    Output Arguments
      B - Result of validity test
        logical

    See also delete

    Introduced in MATLAB

Help for ndi.gui.app.stimulusResponse/isvalid is inherited from superclass handle

    Documentation for handle/isvalid
       doc handle/isvalid

---

launch - LAUNCH Construct a session GUI app uniformly from its name.

NDI.GUI.APP.SESSIONAPP.LAUNCH(CLASSNAME, SESSION) calls the
    CLASSNAME constructor with SESSION as its first argument.

Help for ndi.gui.app.stimulusResponse.launch is inherited from superclass ndi.gui.app.sessionApp

---

le - Determine less than or equal to

Syntax
      A <= B
      le(A,B)

    Input Arguments
      A - Operands
        scalars | vectors | matrices | multidimensional arrays | tables |
        timetables
      B - Operands
        scalars | vectors | matrices | multidimensional arrays | tables |
        timetables

    Examples
      openExample('matlab/TestVectorElementsLessThanOrEqualExample')
      openExample('matlab/ReplaceElementsOfMatrixLessThanOrEqualExample')
      openExample('matlab/CompareValuesInCategoricalArrayLessThanOrEqualExample')
      openExample('matlab/TestComplexNumbersLessThanEqualExample')
      openExample('matlab/TestDurationValuesExample')
      openExample('matlab/CompareTablesLEExample')

    See also eq, ge, gt, lt, ne

    Introduced in MATLAB before R2006a
    Documentation for le
       doc le

---

list - LIST Discover concrete session GUI apps on the path.

APPS = NDI.GUI.APP.SESSIONAPP.LIST() returns a struct array
    with fields:
        Name     - the app's display label (string)
        Class    - the fully-qualified class name (string)
        Category - an optional grouping label (string, "" if the
                     app declares no Category constant). The
                     navigator groups apps that share a non-empty
                     Category into a submenu of the same name.
    for every concrete subclass of ndi.gui.app.sessionApp found
    in the default packages.

    APPS = NDI.GUI.APP.SESSIONAPP.LIST(PACKAGES) scans the given
    packages (string array) instead of the defaults.

Help for ndi.gui.app.stimulusResponse.list is inherited from superclass ndi.gui.app.sessionApp

---

listener - Create event listener without binding to event source

Syntax
      eL = listener(hSource,EventName,callback)
      eL = listener(hSource,PropertyName,EventName,callback)

    Input Arguments
      hSource - Handle object that is the source of the event
        handle array
      EventName - Name of the event that is triggered on the source objects
        character vector or string scalar
      PropertyName - Name of property
        character vector | string | matlab.metadata.Property object
      callback - Listener callback
        function handle

    Output Arguments
      el - Listener object
        event.listener or event.proplistener

    Examples
      web /opt/hostedtoolcache/MATLAB/2026.2.999/x64/help/matlab/ref/handle.listener.html#d127e841088

    See also notify, event.listener

    Introduced in MATLAB in R2017b

Help for ndi.gui.app.stimulusResponse/listener is inherited from superclass handle

    Documentation for handle/listener
       doc handle/listener

---

lt - Determine less than

Syntax
      A < B
      lt(A,B)

    Input Arguments
      A - Operands
        scalars | vectors | matrices | multidimensional arrays | tables |
        timetables
      B - Operands
        scalars | vectors | matrices | multidimensional arrays | tables |
        timetables

    Examples
      openExample('matlab/TestVectorElementsLessThanExample')
      openExample('matlab/ReplaceElementsofMatrixLessThanExample')
      openExample('matlab/CompareValuesinCategoricalArrayLessThanExample')
      openExample('matlab/TestComplexNumbersLessThanExample')
      openExample('matlab/CompareDatesLessThanExample')
      openExample('matlab/CompareTablesLTExample')

    See also eq, ge, gt, le, ne

    Introduced in MATLAB before R2006a
    Documentation for lt
       doc lt

---

ne - Determine inequality

Syntax
      A ~= B
      ne(A,B)

    Input Arguments
      A - Operands
        scalars | vectors | matrices | multidimensional arrays | tables |
        timetables
      B - Operands
        scalars | vectors | matrices | multidimensional arrays | tables |
        timetables

    Examples
      openExample('matlab/InequalityOfTwoVectorsExample')
      openExample('matlab/FindCharactersInStringNotEqualExample')
      openExample('matlab/FindValuesInCategoricalArrayNotEqualExample')
      openExample('matlab/CompareFloatingPointNumbersNotEqualExample')
      openExample('matlab/InequalityOfTwoDatetimeArraysExample')
      openExample('matlab/CompareTablesNEExample')

    See also ge, gt, le, lt, eq

    Introduced in MATLAB before R2006a
    Documentation for ne
       doc ne

---

notify - Notify listeners that event is occurring

Syntax
      notify(H,EventName)
      notify(H,EventName,data)

    Input Arguments
      H - Event source
        handle array
      EventName - Name of event
        character vector | string scalar
      data - User-defined event data
        subclass of event.EventData

    See also addlistener, listener

    Introduced in MATLAB in R2008a

Help for ndi.gui.app.stimulusResponse/notify is inherited from superclass handle

    Documentation for handle/notify
       doc handle/notify

---

stimulusResponse - GUI to compute stimulus responses for elements

OBJ = ndi.gui.app.stimulusResponse(SESSION)

    Opens a window (in the NDI Cloud colour scheme) that drives
    ndi.app.stimulus.tuning_response.stimulus_responses for the ndi.session
    SESSION. It lets you:

      * Choose a stimulator probe from a dropdown of the session's
        'stimulator'-type probes.
      * Choose one or more element types to compute responses for, from a
        multi-select listbox (currently just "spikes").
      * Tick "Replace existing responses" to rebuild responses from scratch.

    When run, for each element of the chosen type(s):

      * If "Replace existing responses" is ticked, a single (OR) database
        search first finds all stimulus_response documents for the chosen
        stimulator and the elements of the chosen type(s); those documents
        (and their scalar-parameter documents) are removed, then responses are
        recomputed for every element.
      * If it is not ticked, one search first lists the stimulus_response
        documents that already exist for the chosen stimulator. Any element
        that already has a response is left untouched; responses are computed
        only for elements that do not yet have one.

    Responses require that the stimuli have already been decoded and their
    control stimuli labeled (see ndi.gui.app.stimulusDecoder); without the
    'stimulus_presentation' and 'control_stimulus_ids' documents no responses
    are produced.

    Progress is shown in an NDI progress bar (ndi.gui.component.ProgressBarWindow),
    which docks into an open navigator's Progress pane when one is present.

    This is a session GUI app (see ndi.gui.app.sessionApp): its constructor
    takes the ndi.session as its first argument, so it can be launched from the
    ndi.gui.navigator "Apps" menu.

    Example:
        S = ndi.session.dir('/path/to/session');
        ndi.gui.app.stimulusResponse(S);

    See also: ndi.gui.app.sessionApp, ndi.gui.app.stimulusDecoder,
              ndi.app.stimulus.tuning_response, ndi.gui.component.ProgressBarWindow

    Documentation for ndi.gui.app.stimulusResponse
       doc ndi.gui.app.stimulusResponse

---