some traversal speedups
updated documentation
fixed documentation
added derived files