JAABA: Saving and Loading Results
Contents
As described in Creating a New Project, all
data associated with a given behavior classifier is stored in a JAABA
project file with the extension .jab, including the project
parameters, classifier, and training data labels and locations. These
can be saved to the current .jab file by selecting File->Save or
to a new .jab file by selecting File->Save As....
Creating Different Versions of a Behavior Classifier
We often find it useful to create different versions of a behavior
classifier. This can be thought of as creating a "restore point" that
we can go back to if we do not like the modifications to the classifier
we make. For example, we might do this if we have a classifier that is
working fairly well, but we want to see what happens if we add a new
type of data. To do this, we use the File->Save As... to create a
new .jab file. Then, we can go back to the previous .jab file if we are
unhappy with the changes we make.
After training a classifier, the whole trajectory of a animal, the whole
experiment, or all the experiments can be classified by selecting one of the options under
the Classifier -> Classify menu, see
Examining the Classifier's Predictions
for details. The classifier's predictions and raw output scores can be saved to a file for several
of the options under this menu. The saved predictions can also be used as input for other projects.
- Current animal: Predicts the behavior for all frames for the current animal and allows the
user to view these results within the current JAABA session, but does not save the predictions
to a file.
- Classifier -> Classify -> Current Experiment -> Don't Save: Classifies all animals for the
current experiment/video, and allows the user to view these results within the current JAABA session,
but does not save the predictions to file.
- Classifier -> Classify -> Current Experiment -> Save to default: Classifies all animals for the
current experiment/video and saves to the scores file within the corresponding
experiment directory. The name of the
scores file within the experiment directory is the same for all experiments, and is specified during the
project setup as Score/Output File Name.
- Classifier -> Classify -> Current Experiment -> Save to different: Classifies all animals for the
current experiment/video, then prompts the user for the location to save the scores to, and saves to this file.
Classifier -> Classify -> All Experiments -> Don't Save: Classifies all animals for all experiments/videos,
and allows the user to view these results within the current JAABA session, but does not save the
predictions to file.
- Classifier -> Classify -> All Experiments -> Save to default: Classifies all animals for
all experiments/videos, then saves to the scores file within each corresponding
experiment directory. The name of the
scores file within the experiment directory is the same for all experiments, and is specified during
the project setup by Score/Output File Name.
- Classifier -> Classify -> All Experiments -> Save to different: Classifies all animals for
all experiments/videos, then prompts the user for a filename that will be used for all experiments. The
classifier's predictions for each experment are stored into this selected filename within its
corresponding experiment directory.
Previously saved predictions can be loaded from file into the current JAABA session. These loaded scores will be
shown in the bottom portion of the Automatic Timeline if Loaded is selected from the pop-up menu
on the left. Predictions can be loaded by selecting any of the options under the menu File -> Load Scores:
- File -> Load Scores -> For current experiment from default location: Loads the scores for the current
experiment from the default scores file within its corresponding
experiment directory. The name of the
scores file within the experiment directory is the same for all experiments, and is specified
during project setup as Score/Output File Name.
- File -> Load Scores -> For current experiment from different location: Prompts the user
for a file location, and loads the scores for the current experiment from that file.
- File -> Load Scores -> For all experiments from default location: Loads the scores for all
experiments from the default scores file within each corresponding
experiment directory. The name of the
scores file within the experiment directory is the same for all experiments, and is specified
during project setup as Score/Output File Name.
Options not mentioned above should not be used, and are there for backwards compatability purposes.