fix and extend documentation on filter_spatial and