Corpsmet95
Contact Information
Contact Information element entry (7K)
Projection parameter entry
Parameter entry for the projection of a grid coordinate system (8K)
Free text entry form
Free text entry form (19K)
Keyword and thesaurus
Keyword and Thesaurus entry (6K)
Sample output
Sample output
   
Name/Version Reviewed: Corpsmet95 version 1.2
Reviewer / Date: Hugh Phillips / October 1997
Version and Date of last known release: Version 1.3, September 1, 1999
Other relevant information and tips:
The latest version comes with a thirteen page manual. If you want to look at it without having to install the software, here it is (Microsoft Word document, 1.5MB zip file).
Function: CSDGM metadata creation tool
Software (version 1.3)
Platform: Windows 95, NT
Principal Contact:
Status:Available
Metadata Storage Structure: Discrete
Brief Description:
Corpsmet95 is a CSDGM metadata creation tool originally developed for the U.S. Army Corps of Engineers (USACE) by Coastal Oceanographics, Incorporated. Initially it was a version of, or probably identical to, the commercial product Metagen32. Since that initial version, it has been updated by USACE.

Like tkme, the interface to this tool provides multiple panes for the user. The left hand pane displays a tree view of the metadata elements, and the right hand pane is used for metadata entry.

The depth of the metadata element tree displayed in the left hand pane can be increased by mouse clicking an element, similar to opening successively deeper folders in File Manager or Windows Explorer. A very nice feature of the tree view is the use of icons to indicate which elements are mandatory (a key key icon), mandatory if applicable (a key with a superimposed question mark key question mark icon), optional (a question mark question mark icon), one of a choice (radio buttons on the branch radio button icon), and modifiers to these elements to indicate sections that are partially complete (an orange blob with exclamation point key exclamation point icon), or complete (a check mark key checkmark icon). The degree-of-completion modifiers propogate correctly up the tree, so partially complete child elements are reflected as a partially complete parent as well. These modifiers only become visible when a subsection has been modified from its original blank state. Elements which can be repeated are sometimes indicated with a page symbol page ... icon and a number following the element name, however such elements are not indicated consistently. To add additional instances of these elements which may repeat, right mouse button click on the element above the element indicated with a page symbol (e.g. Distribution_Information above Distribution_Information_1). This will cause a small popup menu with an 'Add' option to surface and which on selection would add something like Distribution_Information_2 to the metadata element tree. Right mouse button clicking on repeatable elements of instance number 2 or higher will allow them to be removed. A triple dot modifier to the base symbols (e.g. key ... icon) is used to indicate that the particular element can display deeper elements in the metadata tree (i.e. it is a compound element). When the lowest element in a branch of the tree does not have the triple dot modifier, it can be double clicked to open that element in the right hand window for metadata entry.

The right hand pane provides the means the enter metadata information by typing it into text boxes (or pasting in from other Windows applications), or by selecting from pick lists. This pane may be for the entry of a single element, or for several elements in which case the pane is 'tabbed' for each element. Additional 'tabs' may be added into the right hand pane depending the selection for a 'choice' element. Selecting the "Apply' button button in the right hand pane saves changes to the section currently being edited. Selecting the 'OK' button saves the section and closes the metadata entry pane for the current element.

When sections 1 and 7 (Identification Information and Metadata Reference Information) are complete (checked in the tree view), the user can 'Build a Metadata File,' that is, create an output file in ASCII form. This output metadata file breezes right through mp. Any sections which are only partially complete (according to the CSDGM production rules) are not transmitted to the output file. That last characteristic is good is you just want to output the squeaky clean parts of your metadata, but it is frustrating if you knowingly want to bend the rules a little.
Cost: None
Notable Plus:
This tool has one of the most intutive and informative interfaces of all the metadata tools. It is also one of the few tools that can deal with complex polygon bounding ring and exclusion ring descriptions.
Notable Minus:
Metadata Exchange:
The output file from Corpsmet95 is a hierarchically tab indented ASCII file which readily passes mp. It would appear to only import its own .gen files, but some experimentation demonstrates that it may be more flexible than that.

The tool stores its metadata in discrete ASCII .gen files which are hierarchically indented (with tabs) as mp would expect. In fact, the major difference between the .gen file that Corpsmet uses internally and the .met file that that tool produces as output, is that the output process strips out all sections that are only partially complete. A .gen file complete for sections 1 and 7 also posesses some empty structural framework for sections 2-6. With this in mind, the text output files from some files that passed mp (with space indents converted to tabs) were renamed with .gen extensions and opened without problem in Corpsmet (and subsequently built (as .met files). The major cosmetic issue for the import was that Corpsmet wraps free text lines at about 45 characters in its metadata entry pane; longer lines than 45 characters in the original are broken at about 45 characters, and then again on the subsequent line, wherever the hard return occured in the original non-Corpsmet document.

Although in general, Corpsmet is very true to the production rules, it falls short on several elements. It is not possible to create multiple Enumerated_Domain_Value, Enumerated_Domain_Value_Definition, Enumerated_Domain_Value_Definition_Source triplets under a single Enumerated_Domain element. As a result, attribute metadata which passes mp may be become garbled when imported into Corpsmet. This was noted to occur when more than one enumeration (Enumerated_Domain_Value) was present under an Enumerated_Domain element. As a result, all the enumerations were combined into a single enumeration in Corpsmet. This is a serious limitation for this tool. Corpsmet also does not allow multiple address types, you can select 'mailing,' 'physical,' or 'mailing and physical,' but not both 'mailing' and 'physical.' Similar to the enumeration problem listed above, if both address types are present in an imported file, the two address types are combined into a single confusing record.

Use of Corpsmet95 to open and edit metadata files which pass mp but which are not Corpsmet generated .gen files is not a documented function of this tool. Use this information and capability at your own risk!
Useability:
As already mentioned, Corpsmet95 provides a very intuitive and effective interface. The following represent some of the additional features and rough edges not mentioned in the Brief Description.

Although it appears possible to enter paragraph breaks as blank lines in free text elements, and those blank lines will be transmitted through to the .met output file created during that editing session, the next time that metadata file is opened in Corpsmet95, the blank line paragraph breaks will be gone, and any output file produced from it will not have them either. Other paragraph breaking tricks like <cntrl><ret> don't help. This can make for very long paragraphs in output metadata for extensively doumented datasets... A work-around for this characteristic is to insert a standard string of characters where you want the paragraph break to occur (like ---), then perform a global search and replace on the output .met document before passing it through mp.

Corpsmet does not like colons in free text fields; all the text on the line containing the colon which precedes the colon, and the colon itself are deleted when the document is saved, closed and reopened (like the disappearing paragraph break above). Again, a work around is to replace the colon with a character string which is unlikely to appear in regular text and which can be changed back again later, before passing through mp.

For grid coordinate systems as common as State Plane and UTM it would be nice if this tool could provide the projection parameters appropriate to the zone for common datums.

Date entry forces you to go through a calendar to select year, month, and day, even though a text entry box is provided (nothing can be typed into it) and it could be typed in much more quickly than using the 'calendar.'

Any metadata (.gen) file currently being edited can be saved as another name which gives the ability to clone a base metadata document or to quickly document closely related data sets. The tool does not have is a good way to clear the metadata elements for a subsection (or an entire major section) of metadata. In fact, I found that I could never blank out the Format_Name for a Digital_Transfer_Information section once a format was selected, thus I could never blank out a Standard Order Process (it would always show partial completion, even if I wanted to get rid of it).

The bounding box default is East longitude; making it West longitude would save a step for U.S. users.

The tool seems to be unlimited in the length allowed for free text fields. For example, a 65 K file was pasted into Use_Constraints without problem. Metadata can be written in stages. The tool (available via ftp from the Corps of Engineers) has no written documentation for its use. The tool provides on-line help for metadata in the form of the CSDGM, but on-line help about itself is limited to annnouncing its build number. The tool has no spell checking capabilities. Notably missing from its File menu is a Close option; Save or Exit may not be what you had in mind.
Administrative:
The tool installed quickly and easily with its Setup program and occupies about 1.5 Mb of disk space. No source code is provided with this tool and there isn't any mechanism to modify the tool or its output.

Although it is possible to associate a .gen file with Corpsmet, double clicking on the filename only launches Corpsmet with an empty file; it doesn't launch Corpsmet with the selected file. This is unusual behavior for a Windows application.

Tool Reliability:
The tool seems very stable. Existing .gen and .met files will be overwritten without warning. Closing the metadata entry pane or the Corpsmet application without first selecting the 'Apply' or the 'OK' buttons in the entry pane and Save from the File menu results in the loss of any edits since the last Save.
Sample of Interface:

Select edited email concerning tool (reverse chronological order)

Back to Metadata Tools

Last updated on February 19, 2000
Links checked December 18, 2004
Hugh Phillips, hphillips@attglobal.net