params.json Config file documentation

Full documentation of the params.json configuration file

---

Simulator_params: Simulation parameters

working_directory:    Path where results will be saved 
                      format: str
                      e.g: "/scratch/users/thatomanamela/Results/testing/"

trecs_params_file:  simuCLASS congfig file being used
                    format: str
                    e.g: "stackingdepth2.ini"

msfile_name:       Simulated measurement set name
                   format: str
                   e.g: "MeerKAT_3GHz_TRECS_srcs_RA0deg_Dec-30deg.MS"

ra_deg0:         Right Ascension at the phase centre of the observation in units of degrees
                 format: float   
                 e.g: 0
 
dec_deg0:      Declination at the phase centre of the observation in units of degrees
                 format: float 
                 e.g: 30

obs_length_hr:   Observation length in hours
                 format: int
                 e.g: 1

nchan:          Number of channels
                format: int
                e.g: 16

dtime_s:       Intergration time in seconds
               format: int
               e.g: 8 

freq0_MHz:    Observational frequency 
              format: str
              e.g: "3000MHz"

dfreq_MHz:   Integration frequency
             format: str
             e.g: "0.209MHz"

SEFD_Jy:      The system equivalent flux density in Jy
              format: int
              e.g: 450

---

Stacking_params: Parameters when stacking a certain number of sources to avoid confusion

stacking_depth?:    Specify whether stacking density should be considered, 
                    should be kept false when No._of_srcs_of_choice? is true
                    e.g: false
                    format: boolean

res_element_per_source:  The number of resolution elements per source
                         format: int
                         e.g: 100, for this case 100 sources are allowed per MeerKAT beam

im_noise_Jy:       MeerKAT's Full image noise 
                   format: float
                   e.g: 3e-6 


stacking_depth_skymodel_name: Name of trecs cata
                              format: str
                              e.g: "stack_auto/trecs-simu_truthcat.txt"

FOV_size_cut?:     Specify whether to cut the FoV size in order## ### #  to reduce time and frequency smearing
                  format: boolean
                  e.g: false
  
FOV_size_sqdeg:     Simulated S-Band MeerKAT's FOV size in sq-deg
                    format: float
                    e.g: 0.84

FOV_size_cut_value:   FoV cut value
                     format: float
                     e.g: 0.5, for this case sources will be generated within 50% of the full FOV
  
No._of_srcs_of_choice?:  Specify whether stacking density should be considered and the number of sources of choice, 
                         should be kept false when No._of_srcs_of_choice? is true
                         format: boolean
                         e.g: true

                            
No._of_srcs:  Number of sources of choice to be simulated and stacked
              format: int
              e.g: 10     
 
flux_density_Jy:   flux density of choice in Jy
                   format: float
                   e.g: 1e-6

src_size_arcsec:  Size of soources in arcsecs
                  format: float
                  e.g: 0.01,  and when 0 TRECS source sizes are used

---

Imaging_params: Imaging parameters when removing bright sources before stacking

stack_msfile_name:   Name of the visibility stacked measurement set
                     format: str
                     e.g: "uvstacked.ms"

imagename:   Name the full image of the observation simulation when removing bright sources
             format: str
             e.g: "fullimage"

niter:       CLEAN number of iterations
             format: int
             e.g: 1000

threshold:     Maximum flux density to CLEANout
               format: str
               e.g: "0.01mJy"

imsize:    Size of the full image
           format: int
           e.g: 3136


stampsize:   Size of uv stacked image
             format: int
              e.g: 64   

cell:        pixel size
             format: str
            e.g: "1arcsec"  

stack_clean?:  Specify whether to remove bright sources within the observation before stacking
              format: boolean
              e.g: true  
              
weighting:  CLEAN weighting
            format: str
            e.g: "briggs" 
 
robust:     Weighting robust parameter
            format: float
            e.g: -0.5