pynrc.nrc_utils.zodi_euclid

pynrc.nrc_utils.zodi_euclid(locstr, year, day, wavelengths=[1, 5.5], ido_viewin=0, **kwargs)[source]

IPAC Euclid Background Model

Queries the IPAC Euclid Background Model in order to get date and position-specific zodiacal dust emission.

The program relies on urllib3 to download the page in XML format. However, the website only allows single wavelength queries, so this program implements a multithreaded procedure to query multiple wavelengths simultaneously. However, due to the nature of the library, only so many requests are allowed to go out at a time, so this process can take some time to complete. Testing shows about 500 wavelengths in 10 seconds as a rough ballpark.

Recommended to grab only a few wavelengths for normalization purposes.

Parameters

  • locstr (str) – This input field must contain either coordinates (as string), or an object name resolveable via NED or SIMBAD.

  • year (string) – Year. Limited to 2018 to 2029 for L2 position.

  • day (string) – Day of year (1-366). Limited to 2018 Day 274 to 2029 Day 120 for L2 position and ido_viewin=0.

  • wavelength (array-like) – Wavelength in microns (0.5-1000).

  • ido_viewin (0 or 1) – If set to 0, returns zodiacal emission at specific location for input time. If set to 1, then gives the median value for times of the year that the object is in a typical spacecraft viewing zone. Currently this is set to solar elongations between 85 and 120 degrees.

References

See the Euclid Help Website for more details.