added a lot of documentation, removed a couple methods
that were no longer needed. Improved the handling of
data arrays so that they are more often cached.