Configure File Locations Dialog Box
Overview
This dialog box allows the user to view and choose the paths of the configuration
files for the current project, the file containing the musical taxonomy used,
the list of recordings to train and/or classify, the features of these recordings,
the trained classifiers, the preferences file and the current directory. This
dialog box can be used to load projects and set the configuration files making
up projects.
This is the first part of the interface that is presented to the user upon
running Bodhidharma. The default project is loaded from the default_file_locations.xml
file. Hard coded defaults are loaded and used to generate this file if
it is not available. This file is actually a project_file, but the
only field that is used from it is its pointer to another project file, which
is used to set the startup defaults for the configuration files.
Each path may be chosen by typing them in (except for the Project File)
or by pressing on the accompanying Browse button, which brings up a
file chooser.
Only XML files are made available in the file choosers accessible through this
dialog box. When files are saved, a .xml extension is automatically added if
it is not already present.
If a given path is left blank, then the project will be loaded with hard coded
defaults for the corresponding aspect of the project.
Fields
- Project file: The path of the project_file file holding
the paths of the configuration files used for the corresponding project.
- File holding musical taxonomy: The path of the taxonomy_file that
sets the taxonomy for the current project.
- File holding feature settings: The path of the features_file that
sets the feature settings (but not actually feature values) for the current
project.
- File holding training and/or testing recordings: The path of the
recordings_file that holds the meta-data associated with recordings as well
as a link to another file holding the values of extracted features.
- File holding trained classifiers: The path of the classifiers_file
that holds the details of the trained classifiers used for the current project.
- Preferences file: The path of the preferences_file that holds the
preferences of the current project.
- Current directory: The path of the directory used as the default
directory for this project.
Buttons
- Load Project: Gives the user a file chooser with which to choose
a project_file file. All of the fields of the Configure File Locations
Dialog Box are then set based on the contents of this file.
- Browse: These buttons provide the user with a file chooser with
which to choose the file which the field to the left of the Browse
button refers to.
- Clear Paths: Sets all fields to blank.
- Clear Categories: Disassociates the recording from all categories
and assigns it an label of "Unknown."
- Restore Original Defaults: Sets all of the fields based on the
hard coded defaults.
- Save As Startup Defaults: Saves the current contents of the fields to the
default_file_locations.xml file that is loaded as the default whenever
Bodhidharma is run.
- Cancel: Closes the dialog box and discards any changes. Quits Bodhidharma
if no project has been opened yet.
- Start New Project: Provides the user with a file chooser dialog
box with which to choose the location of a new project_file. This
file is saved with the current contents of the fields of the Configure File
Locations Dialog Box. A directory with the same name is also created that
can be used to store configuration files (although the configuration files
can in fact be stored anywhere). The user is asked if s/he wishes to copy
existing configuration files referred to in the fields of the Configure File
Locations Dialog Box to this new directory. If the user chooses yes, then
the files are automatically copied (with the exception of trained classifiers)
and the fields are updated to show their new location. If the user chooses
no, then all fields are reset to blank.
- OK: Closes the dialog box and loads all configuration files referred
to in the fields of the dialog box. Any previously loaded information is discarded.
Buttons
- Add Category: Adds the currently selected leaf category in the associated
combo box to the Leaf Categories field. The ancestors of this leaf
category in the currently loaded taxonomy are also automatically added to
the Ancestor Categories field. Repetitions of categories are removed.
- Clear Categories: Disassociates the recording from all categories
and assigns it an label of "Unknown."
- Play: Plays the recording with the operating system's default media
player. This only works with Windows 2000 or above in the current version
of the software.
- Cancel: Closes the dialog box and discards any changes.
- OK: Closes the dialog box and preserves any changes.
Screen Shot