Source Catalogs API

soxs.cosmology.make_cosmological_sources_file(simput_prefix, phlist_prefix, exp_time, fov, sky_center, cat_center=None, absorb_model='wabs', nH=0.05, area=40000.0, append=False, overwrite=False, output_sources=None, prng=None)[source]

Make a SIMPUT catalog made up of contributions from galaxy clusters, galaxy groups, and galaxies.

Parameters:
  • simput_prefix (string) – The filename prefix for the SIMPUT file.
  • phlist_prefix (string) – The filename prefix for the photon list file.
  • exp_time (float, (value, unit) tuple, or Quantity) – The exposure time of the observation in seconds.
  • fov (float, (value, unit) tuple, or Quantity) – The field of view in arcminutes.
  • sky_center (array-like) – The center RA, Dec of the field of view in degrees.
  • cat_center (array-like) – The center of the field in the coordinates of the halo catalog, which range from -5.0 to 5.0 degrees along both axes. If None is given, a center will be randomly chosen.
  • absorb_model (string, optional) – The absorption model to use, “wabs” or “tbabs”. Default: “wabs”
  • nH (float, (value, unit) tuple, or Quantity, optional) – The hydrogen column in units of 10**22 atoms/cm**2. Default: 0.05
  • area (float, (value, unit) tuple, or Quantity, optional) – The effective area in cm**2. It must be large enough so that a sufficiently large sample is drawn for the ARF. Default: 40000.
  • append (boolean, optional) – If True, append a new source an existing SIMPUT catalog. Default: False
  • overwrite (boolean, optional) – Set to True to overwrite previous files. Default: False
  • output_sources (string, optional) – If set to a filename, output the properties of the sources within the field of view to a file. Default: None
  • prng (RandomState object, integer, or None) – A pseudo-random number generator. Typically will only be specified if you have a reason to generate the same set of random numbers, such as for a test. Default is None, which sets the seed based on the system time.
soxs.background.point_sources.make_point_sources_file(simput_prefix, phlist_prefix, exp_time, fov, sky_center, absorb_model='wabs', nH=0.05, area=40000.0, prng=None, append=False, overwrite=False, input_sources=None, output_sources=None)[source]

Make a SIMPUT catalog made up of contributions from point sources.

Parameters:
  • simput_prefix (string) – The filename prefix for the SIMPUT file.
  • phlist_prefix (string) – The filename prefix for the photon list file.
  • exp_time (float, (value, unit) tuple, or Quantity) – The exposure time of the observation in seconds.
  • fov (float, (value, unit) tuple, or Quantity) – The field of view in arcminutes.
  • sky_center (array-like) – The center RA, Dec of the field of view in degrees.
  • absorb_model (string, optional) – The absorption model to use, “wabs” or “tbabs”. Default: “wabs”
  • nH (float, (value, unit) tuple, or Quantity, optional) – The hydrogen column in units of 10**22 atoms/cm**2. Default: 0.05
  • area (float, (value, unit) tuple, or Quantity, optional) – The effective area in cm**2. It must be large enough so that a sufficiently large sample is drawn for the ARF. Default: 40000.
  • prng (RandomState object, integer, or None) – A pseudo-random number generator. Typically will only be specified if you have a reason to generate the same set of random numbers, such as for a test. Default is None, which sets the seed based on the system time.
  • append (boolean, optional) – If True, append a new source an existing SIMPUT catalog. Default: False
  • overwrite (boolean, optional) – Set to True to overwrite previous files. Default: False
  • input_sources (string, optional) – If set to a filename, input the source positions, fluxes, and spectral indices from an ASCII table instead of generating them. Default: None
  • output_sources (string, optional) – If set to a filename, output the properties of the sources within the field of view to a file. Default: None
soxs.background.point_sources.make_point_source_list(output_file, exp_time, fov, sky_center, area=40000.0, prng=None)[source]

Make a list of point source properties and write it to an ASCII table file.

Parameters:
  • output_file (string) – The ASCII table file to write the source properties to.
  • exp_time (float, (value, unit) tuple, or Quantity) – The exposure time of the observation in seconds.
  • fov (float, (value, unit) tuple, or Quantity) – The field of view in arcminutes.
  • sky_center (array-like) – The center RA, Dec of the field of view in degrees.
  • area (float, (value, unit) tuple, or Quantity, optional) – The effective area in cm**2. It must be large enough so that a sufficiently large sample is drawn for the ARF. Default: 40000.
  • prng (RandomState object, integer, or None) – A pseudo-random number generator. Typically will only be specified if you have a reason to generate the same set of random numbers, such as for a test. Default is None, which sets the seed based on the system time.