added new script

this performs basic metadata addition, but doesn't perform any special handling of taxonomy. we want this to split taxonomy on semi-colons, and eventually we'll want the user to be able to specify more complex processing of each metadata entry.
added new script

this performs basic metadata addition, but doesn't perform any special handling of taxonomy. we want this to split taxonomy on semi-colons, and eventually we'll want the user to be able to specify more complex processing of each metadata entry.
parse_mapping takes process_fns variable

parse_mapping now takes a new value, process_fns. process_fns is a dictionary of functions to apply to metadata categories. The keys should be the column headings, and the values should be functions which take a single value. For example, if the values in a column called "taxonomy" should be split on semi-colons before being added as metadata, and all other columns should be left as-is, process_fns should be:
      {'taxonomy': lambda x: x.split(';')}

This is being added specifically for the taxonomy use-case, but could also be useful in the future for type-casting values, etc.
added special handling of taxonomy

first pass for testing - will want to generalize this functionality a bit before merge.
generalized semi-colon splitting functionality

users can now pass the list of fields with data that should be split on semi-colons, and defaults to 'taxonomy', if provided.
updated documentation.
parse_mapping allows users to override column headers

Users can now optionally pass a header list to parse_mapping. This is useful if a header line is not provided with the metadata, if users want to rename the fields, or if users want to include only the first n-1 fields where n is the number of headers provided (and the 1 is the first column header - typically either "SampleID" or "ObservationID").
expanded support for metadata processing

connected header renaming to script interface, and added more complex processing options for metadata categories. users can now process metadata by splitting on semi-colons (for hierarchical data), or casting to a float or an int.
adding new documentation page

which covers the add_metadata.py script.
fixed minor errors in sphinx build
adding example files

corresponding to the new adding_metadata document.
updated input biom table filename ...

... to correspond to the filename in the examples directory
Merge branch 'issue-66' of github.com:gregcaporaso/biom-format into issue-66

Conflicts:
	scripts/add_metadata.py
added new script

this performs basic metadata addition, but doesn't perform any special handling of taxonomy. we want this to split taxonomy on semi-colons, and eventually we'll want the user to be able to specify more complex processing of each metadata entry.
parse_mapping takes process_fns variable

parse_mapping now takes a new value, process_fns. process_fns is a dictionary of functions to apply to metadata categories. The keys should be the column headings, and the values should be functions which take a single value. For example, if the values in a column called "taxonomy" should be split on semi-colons before being added as metadata, and all other columns should be left as-is, process_fns should be:
      {'taxonomy': lambda x: x.split(';')}

This is being added specifically for the taxonomy use-case, but could also be useful in the future for type-casting values, etc.
added special handling of taxonomy

first pass for testing - will want to generalize this functionality a bit before merge.
generalized semi-colon splitting functionality

users can now pass the list of fields with data that should be split on semi-colons, and defaults to 'taxonomy', if provided.
updated documentation.
parse_mapping allows users to override column headers

Users can now optionally pass a header list to parse_mapping. This is useful if a header line is not provided with the metadata, if users want to rename the fields, or if users want to include only the first n-1 fields where n is the number of headers provided (and the 1 is the first column header - typically either "SampleID" or "ObservationID").
expanded support for metadata processing

connected header renaming to script interface, and added more complex processing options for metadata categories. users can now process metadata by splitting on semi-colons (for hierarchical data), or casting to a float or an int.