[0.2.dev2] Template for saving data

[smmaurer]

This PR adds a template for saving data to local files; see issue #94.

New template: urbansim_templates.data.SaveTable()

Template for saving an Orca table (or subset of a table) to disk as csv or hdf file. See docstrings and sphinx file for full documentation, which will appear online after this PR is merged.

Basic usage: Create an instance of the template class and set some properties (table, columns, output type, path, etc). Registering with ModelManager saves the settings to disk and creates an Orca step with instructions for saving the data. Running the object/step saves the current contents of the Orca table to disk.

Supports dynamic insertions into the filename string at runtime: run number, iteration, timestamp.

Other changes

Renames the data loading template for consistency: urbansim_templates.io.TableFromDisk() –> urbansim_templates.data.LoadTable().

Also changes some behavior in the LoadTable() template:

• adds a model step name that's distinct from the table name
• requires Unix-formatted file paths (too hard to reliably normalize)

Versioning

0.2.dev2

To do before merging

• implement dynamic info in filenames
• add column filters
• update LoadTable() template to require Unix-formatted paths
• update LoadTable() template to separate model step name from table name
• finish tests and documentation
• update changelog
• finalize versioning

[coveralls]

Coverage increased (+0.6%) to 91.601% when pulling da826b3 on save-data into 1c6c649 on master.

[coveralls]

Coverage increased (+0.6%) to 91.601% when pulling da826b3 on save-data into 1c6c649 on master.