documented single image iterator