# 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.