Add convenience check for saturation

[relleums]

the photon_stream class shall get a convenience function to check whether it is saturated or not. There are two types of saturation. First ADC saturation, Second, single pulse extractor iteration saturation.