another shot at describing the file structure

may try a d3.js next:

http://bl.ocks.org/mbostock/4339083