ACE Project File

Overview

The ACE XML project file is one of the ACE XML file formats. Its main purpose is to provide the user with an easy, single step way of loading a previously saved ACE project. Without this project file, the user would have to individually load each the taxonomy file, feature vectors file, feature definitions file, and classifications file. The ACE XML project file format is designed to contain references to all component ACE XML files of an ACE project. Thus the user can simply load an ACE project file, and ACE can load each of the individual component files internally without the user ever having to explicitly specify them. For a detailed explanation of how to load an ACE project from an ACE project file, see the ACE command line manual. This project file is also used in the context of an ACE Zip File. In this case, the project file contains reference to the ACE XML files compressed in the zipfile. Note that with an ACE project file, only reference to the component ACE XML files are stored, not the actual files themselves, therefore the files themselves must be stored in a location that ACE can access.

NOTE: This page describes the ACE XML 1.1 version of the project file. This version will eventually be deprecated in favor of the ACE XML 2.0 version of the project file. Details are available on the ACE XML 2.0 Development Page.

Details of ACE XML Project File

The specifications of the ACE XML project file reflect those of an ACE project. Only one taxonomy path can be specified in the file, just as an ACE project may only have one taxonomy. However, multiple paths may be specified for each the feature definitions, feature vectors, and model classifications. There exist plans to expand ACE to be able to accept multiple feature definitions files, feature vectors files, and model classifications files, however, at this point, only one of each may be loaded.

<!ELEMENT ace_project_file (comments, taxonomy_path, feature_definitions_path, feature_vectors_path, model_classifications_path, gui_preferences_path, classifier_settings_path, trained_classifiers_path, weka_arff_path)>
<!ELEMENT comments (#PCDATA)>
<!ELEMENT taxonomy_path (#PCDATA)>
<!ELEMENT feature_definitions_path (path*)>
<!ELEMENT feature_vectors_path (path*)>
<!ELEMENT model_classifications_path (path*)>
<!ELEMENT gui_preferences_path (#PCDATA)>
<!ELEMENT classifier_settings_path (#PCDATA)>
<!ELEMENT trained_classifiers_path (#PCDATA)>
<!ELEMENT weka_arff_path (#PCDATA)>
<!ELEMENT path (#PCDATA)>

<ace_project_file>
   <comments>this is a comment</comments>
   <taxonomy_path>TestFiles/Taxonomy.xml</taxonomy_path>
   <feature_definitions_path>
      <path>TestFiles/FeatureKey.xml</path>
   </feature_definitions_path>
   <feature_vectors_path>
      <path>TestFiles/FeatureVectors.xml</path>
   </feature_vectors_path>
   <model_classifications_path>
      <path>TestFiles/Classifications.xml</path>
   </model_classifications_path>
   <gui_preferences_path></gui_preferences_path>
   <classifier_settings_path></classifier_settings_path>
   <trained_classifiers_path></trained_classifiers_path>
   <weka_arff_path></weka_arff_path>
</ace_project_file>

Figure 1: Example of the ACE XML project file format.

Related Publications

McKay, C., R. Fiebrink, D. McEnnis, B. Li, and I. Fujinaga. 2005. ACE: A framework for optimizing music classification. Proceedings of the International Conference on Music Information Retrieval. 42–9.

Questions and Comments

cory.mckay@mail.mcgill.ca

DOWNLOAD FROM SOURCEFORGE

-top of page-