scalpel (version 1.0.3)

reviewNeurons: Manually classify the identified neurons from SCALPEL.

Description

We save plots that will be used to review the set of identified neurons that result from either Step 2 or 3 of SCALPEL in order to manually classify them according to whether they appear to be real neurons or not. To do this, the plot of the frame from which the dictionary element was derived is saved. The user can then sort these saved plot into folders indicating whether the neuron is real or not, or indicate that additional frames are needed to make the classification, in which case the reviewNeuronsMoreFrames function can subsequently be used. After finishing this sorting process, updateNeurons should be called. A similar manual classification can be done interactively using reviewNeuronsInteractive.

Usage

reviewNeurons(
  scalpelOutput,
  neuronSet,
  keepClusterSize = NULL,
  discardZeroedOut = FALSE
)

Arguments

scalpelOutput

An object returned by one of the SCALPEL functions: scalpel, scalpelStep2, or scalpelStep3.

neuronSet

The set of neurons that should be reviewed: use "A" for those resulting from scalpelStep2 and saved as scalpelOutput$A, or use "Afilter" for those resulting from scalpelStep3 and saved as scalpelOutput$Afilter. This argument is ignored if the class of scalpelOutput is scalpelStep2.

keepClusterSize

Neurons corresponding to clusters with at least keepClusterSize members will be automatically classified as real neurons. The default value is NULL, which means that none of the neurons will be automatically kept based on cluster size.

discardZeroedOut

Logical value indicating whether neurons zeroed out in the sparse group lasso problem should automatically be discarded. This argument is ignored when neuronSet is "A", and has a default value of FALSE.

Value

None

Details

Plots are saved for each of the neurons under consideration in a certain folder. Also within that folder, there will be folders called 'keep', 'discard', and 'unsure'. After running this function, the plots for each of the neurons should be moved into the appropriate folder. After completing this sorting, call updateNeurons in order to update the classification of the neurons. Any plots that are missing or that remain in the original folder will be classified as not having been sorted yet.

See Also

After sorting the plots saved by this function, the user should call updateNeurons. For other functions useful in the classification process, see reviewNeuronsMoreFrames and reviewOverlappingNeurons. Once classification is finished, the argument neuronsToOutline="kept" can be used with plotBrightest and plotVideoVariance, and the argument neuronsToDisplay="kept" can be used with plotResults, plotResultsAllLambda, plotTemporal, and plotSpatial. Finally, the argument excludeReps="discarded" allows the discarded dictionary elements to be excluded from the sparse group lasso model when running scalpelStep3.

Examples

# NOT RUN {
### many of the functions in this package are interconnected so the
### easiest way to learn to use the package is by working through the vignette,
### which is available at ajpete.com/software

#assumes you have run the example for the "scalpel" function

#we review the set of spatial components from Step 3,
#which are contained in scalpelOutput$Afilter
reviewNeurons(scalpelOutput = scalpelOutput, neuronSet = "Afilter")
# }