documentation more detailled

added description of spat_comps and spec_comps, for potential
extensions of the framework