attachment:NIKA2_Time_Estimator.py of Continuum/TimeEstimatorScriptGuideS2020

   1 #!/usr/bin/env python
   2 ##############################################################################################
   3 ### Created by: P. Garcia                                                                  ###
   4 ### Revised by: A. Ritacco                                                                 ###
   5 ### Revised by: B. Ladjelate                                                               ###
   6 ### Title: NIKA2_Time_Estimator.py                                                         ###
   7 ### Purpose: Calculation of the total integration time for observing proposals             ###
   8 ### Creation Date: 2016.JULY.28                                                            ###
   9 ### Date of last revision: 2018.JAN.20                                                     ###
  10 ### Revision history:                                                                      ###
  11 ###   - 2016.JULY.29: comments from C. Kramer & A. Sievers implemented                     ###
  12 ###   - 2016.AUG.03 : changed formula to N. Billot expression                              ###
  13 ###   - 2017.JAN.29 : - fpix set to 0.75 (commisi. results)                                ###
  14 ###                   - NEFD0 @ 2 mm set to 15 mJy/sqrt(hz) (commisi. results)             ###
  15 ###                   - overhead set as used defined parameter between 1.5 - 2.0           ###
  16 ###   - 2017.JULY.28: - According to the NIKA2 technical paper submitted on July, 3rd 2017 ###
  17 ###                   - fpix @1mm, 2mm set to 0.84 and 0.90, respectively                  ###
  18 ###                   - NEFD0 @1mm, 2mm set to 20 and 6 mJy/sqrt(hz), respectively         ###
  19 ###                   - FWHM set to 11.2 @1mm and 17.7 @2mm                                ###
  20 ###   - 2017.SEPT.28  - An error in the data software led sensitivities too optimistics    ###
  21 ###                   - NEFD0 @1mm, 2mm set to 40 and 10 mJy/sqrt(hz), respectively        ###
  22 ###   - 2018.JAN.20:  - NEFD0 @1mm, 2mm set to 33 and 8 mJy/sqrt(hz), respectively         ###
  23 ###   - 2019.FEB.18:  - Corrected a mistake in the calculation of the mapping speed        ###
  24 ###   - 2020.JUL.22:  - Implemented a warning regarding the scan size                      ###
  25 ##############################################################################################
  26 import numpy as np, sys
  27 import math
  28 import sys
  29 import os
  30 os.system("rm -f *.py~")
  31 
  32 #version = 'v 2017.JAN.29'
  33 #version = 'v 2017.JULY.28'
  34 #version = 'v 2017.SEPT.28'
  35 #version = 'v 2018.JAN.20'
  36 #version = 'v 2019.FEB.18'
  37 version = 'v 2020.JUL.22'
  38 
  39 
  40 class bcolors:
  41     HEADER = '\033[95m'
  42     OKBLUE = '\033[94m'
  43     OKGREEN = '\033[92m'
  44     WARNING = '\033[93m'
  45     FAIL = '\033[91m'
  46     ENDC = '\033[0m'
  47     BOLD = '\033[1m'
  48     UNDERLINE = '\033[4m'
  49 
  50 print ''
  51 print bcolors.UNDERLINE + bcolors.HEADER + bcolors.BOLD + 'Time-estimator-NIKA2 '+version+' '+bcolors.ENDC
  52 print ''
  53 print bcolors.HEADER + bcolors.BOLD + ' See the "Guidelines for observing time estimates with the NIKA2 continuum camera' + bcolors.ENDC
  54 print bcolors.HEADER + bcolors.BOLD + ' at the IRAM-30m Telescope" for details on used parameters and calculations.\n' + bcolors.ENDC
  55 
  56 ################################
  57 ##### CONVERSION FACTORS #######
  58 ################################
  59 
  60 ##########  K_cmb ############
  61 def b_v_cmb(freq,tcmb):
  62     h    = 6.626070040*10**(-34) # (J.s) Planck constant
  63     k    = 1.38064852*10**(-23)  # (J/K) Boltzmann constant
  64     c    = 299792458             # (m/s^2) light speed
  65     freq = freq*10**9            # Hz    
  66     bv = 1.0/(((2*h*freq**3)/((c**2)*(np.e**((h*freq)/(k*tcmb)) - 1)))*(np.e**((h*freq)/(k*tcmb))/(np.e**((h*freq)/(k*tcmb)) - 1))*(h*freq/(k*tcmb**2))) / 10**20
  67     return bv
  68 
  69 ##########  Ysz ##############
  70 def y_sz(freq,tcmb):
  71     h    = 6.626070040*10**(-34) # (J.s) Planck constant
  72     k    = 1.38064852*10**(-23)  # (J/K) Boltzmann constant
  73     c    = 299792458             # (m/s^2) light speed
  74     freq = freq*10**9            # Hz    
  75     Ysz  = 1.0
  76     bv   = 1.0/(((2*h*freq**3)/((c**2)*(np.e**((h*freq)/(k*tcmb)) - 1)))*(np.e**((h*freq)/(k*tcmb))/(np.e**((h*freq)/(k*tcmb)) - 1))*(h*freq/(k*tcmb**2)))
  77     bv   = 1.0/bv
  78     y_sz = (bv*tcmb)*(((h*freq/(k*tcmb))*((np.e**((h*freq)/(k*tcmb)) + 1)/(np.e**((h*freq)/(k*tcmb)) -1))) -4)*Ysz /10**(-20)
  79     y_sz = 1.0/y_sz
  80     return y_sz
  81 
  82 #%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
  83 #%%%%%%%%%%%%%%%%%%%%% FIXED GENERAL PARAMETERS %%%%%%%%%%%%%%%%%%%%%%  
  84 #%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
  85 
  86 ################################################
  87 ##### BEAM SIZES AND CONVERSION TO RADIANS #####
  88 ################################################
  89 res_band1_spec        = 11.2  #From NIKA2 1st paper #MEMO # 12.0  # [arcsec]
  90 res_band2_spec        = 17.7  #From NIKA2 1st paper #MEMO # 20.0  # [arcsec]
  91 teta_band1_spec       = res_band1_spec*math.pi/180.0/3600.0 # in sr units 
  92 teta_band2_spec       = res_band2_spec*math.pi/180.0/3600.0 # in sr units 
  93 area_teta_band1_spec  = ((teta_band1_spec/2.0)**2)*math.pi  # in sr units 
  94 area_teta_band2_spec  = ((teta_band2_spec/2.0)**2)*math.pi  # in sr units 
  95 ############################
  96 ##### OTHER PARAMETERS #####
  97 ############################
  98 #fpix_spec             = 0.75
  99 fpix_spec_1mm         = 0.84    # As presented at the NIKA2 consortium meeting
 100 fpix_spec_2mm         = 0.90    # As presented at the NIKA2 consortium meeting
 101 bv_1                  = 0.075   # band1, do not change
 102 cv_1                  = 0.001   # band1, do not change
 103 bv_2                  = 0.025   # band2, do not change
 104 cv_2                  = 0.001   # band2, do not change
 105 tiempo                = 1.0     # [hours]
 106 FoV                   = 6.5     # [arcmin] diameter
 107 FoVArea               = ((FoV/2.0)**2)*math.pi # [arcmin^2]
 108 narrays1              = 2
 109 narrays2              = 1
 110 verbose_flag          = 0
 111 #foverhead             = 2.0 # value fixed for all proposals in 2016
 112 ##########################################
 113 ##### NEFDo VALUES FROM OBSERVATIONS #####
 114 ##########################################
 115 NEFD_band1_spec       = 33 #Changed in Jan. 20 #From NIKA2 1st paper arXiv:1707.00908  #MEMO 
 116 NEFD_band2_spec       = 8  #Changed in Jan. 20 #From NIKA2 1st paper arXiv:1707.00908  #comissioning results 2017
 117 
 118 #######################################
 119 ##### SAMPLING ANGULAR VELOCITIES #####
 120 #######################################
 121 sampl_vel_fast = 48.0    # [arcsec/second] 
 122 sampl_vel_mid  = 24.0    # [arcsec/second] 
 123 sampl_vel_slow = 12.0    # [arcsec/second] 
 124 sampl_rate     = 23.84   # [hz]
 125 sampl_rate_pol = 2*23.84 # [hz]
 126 slewing_loss   = 1.0     # to account for slewing of single OTF line
 127 ##########################################
 128 ##########################################
 129 ##########################################
 130 
 131 rango = len(sys.argv)
 132 for i in range(rango):
 133 
 134     if sys.argv[i] == ("--help") or rango == 1:
 135 
 136         print ' USAGE:\n'
 137         print '   python NIKA2_Time_Estimator.py --help '
 138         print '   python NIKA2_Time_Estimator.py --band 1 --rms 2.00 --pwv 2 --elevation 40 --Xsize 6.5 --Ysize 6.5 --filter 1.0 --overhead 1.5'
 139         print '   python NIKA2_Time_Estimator.py --band 2 --rms 1.00 --pwv 4 --elevation 50 --Xsize 15  --Ysize 15  --filter 2.0 --overhead 2.0 --verbose '
 140         print '\n'
 141         print ' OPTIONS:\n'
 142         print '          help =>  This help.'
 143         print '          band =>  Set 1 or 2 for the 1 mm or the 2 mm bands, respectively.'
 144         print '           rms =>  Wanted flux density per beam. Any value above the confusion limit in [mJy/beam].'
 145         print '           pwv =>  Precipitable water vapor in [mm].'
 146         print '     elevation =>  Values from 15 to < 83 [deg].'
 147         print '   Xsize Ysize =>  Map lengths. Xsize and Ysize are in [arcmin]. Minimum map size is 6.5x6.5 [arcmin^2] for homogeneous RMS noise distribution.'
 148         print '        filter =>  Factor for post-processing noise filtering. Values from 1.0 (point-like source) to 2.0 (extended bright emission).'
 149         print '      overhead =>  Factor for telescope overheads between 1.5 and 2.0 (slewing, pointing, focusing, calibration), i.e. all telescope time which is not spend integrating on-source.'
 150         print '       verbose =>  Set to get list of parameters used in the calculations, RMS noise unit conversion, and allowed OTF scan speeds.\n'
 151         sys.exit()
 152 
 153     if sys.argv[i] == ("--band"):
 154         band  = int(sys.argv[i+1]) 
 155         if band == 1:
 156             narrays = narrays1
 157             mili    = 1.2
 158         if band == 2:
 159             narrays = narrays2
 160             mili    = 2.0
 161         if band < 1 or band > 2:
 162             print '    %%%%%%%%%%%%%%%%%%%%%%%'
 163             print bcolors.BOLD +  bcolors.FAIL +'    Band %2i is not defined.' % (band) + bcolors.ENDC
 164             print '    %%%%%%%%%%%%%%%%%%%%%%%'
 165             print ''
 166             sys.exit()
 167 
 168     if sys.argv[i] == ("--rms"):
 169         rms = float(sys.argv[i+1])
 170 
 171     if sys.argv[i] == ("--pwv"):
 172         pwv = float(sys.argv[i+1])
 173 
 174     if sys.argv[i] == ("--elevation"):
 175         elevation = float(sys.argv[i+1])
 176         if elevation < 15 or elevation > 83:
 177             print '    %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%'
 178             print bcolors.BOLD +  bcolors.FAIL +'    Elevation %3i [degrees] is outside the telescope`s limits: 15 - 83 [degrees].' % (elevation) + bcolors.ENDC
 179             print '    %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%'
 180             print ''
 181             sys.exit()
 182 
 183     if sys.argv[i] == ("--Xsize"):
 184         dx = float(sys.argv[i+1])
 185 
 186     if sys.argv[i] == ("--Ysize"):
 187         dy = float(sys.argv[i+1])
 188 
 189     if sys.argv[i] == ("--filter"):
 190         filtering = float(sys.argv[i+1])
 191         if filtering < 1 or filtering > 2:
 192             print '    %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%'
 193             print bcolors.BOLD +  bcolors.FAIL +'    Filter value %2.1f is outside the standard limits: 1.0 - 2.0' % (filtering) + bcolors.ENDC
 194             print '    %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%'
 195             print ''
 196             sys.exit()
 197 
 198     if sys.argv[i] == ("--overhead"):
 199         foverhead = float(sys.argv[i+1])
 200         if foverhead < 1.5 or foverhead > 2:
 201             print '    %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%'
 202             print bcolors.BOLD +  bcolors.FAIL +'    Overhead value %2.1f is outside the standard limits: 1.5 - 2.0' % (foverhead) + bcolors.ENDC
 203             print '    %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%'
 204             print ''
 205             sys.exit()
 206 
 207     if sys.argv[i] == ("--verbose"):
 208         verbose_flag = 1
 209 
 210 area_obs        = dx*dy
 211 
 212 if area_obs < 4.0:
 213     print '    %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%'
 214     print bcolors.BOLD +  bcolors.FAIL +'    Introduced map size is %3.1f [arcmin^2]. Minimum value is 4.0 [arcmin^2]' % (area_obs) + bcolors.ENDC
 215     print '    %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%'
 216     print ''
 217     sys.exit()
 218 
 219 ###############################################################################################
 220 ### SIGMA ESTIMATION CALCULATION, EFFECTIVE NEFD FROM PWV GIVEN VALUES AND UNITS CONVERSION ###
 221 ###############################################################################################
 222         
 223 if band == 1: 
 224     tau = bv_1*pwv + cv_1
 225     NEFD_spec_eff      = NEFD_band1_spec*(np.e**(tau/np.sin(elevation*math.pi/180.)))
 226     rms_point_MJy_spec = rms/area_teta_band1_spec/10**9
 227     rms_point_cmb_spec = rms_point_MJy_spec*b_v_cmb(260,2.726)*10**6
 228     rms_point_ys_spec  = rms_point_MJy_spec*y_sz(260,2.726)*10**6
 229     rms_point_ys_spec  = np.abs(rms_point_ys_spec)
 230     #########################################
 231     ### ratio of areas with fraction of valid pixel in the 2mm band ###       
 232     #########################################
 233     factor_area_spec   = (1+(area_obs/(FoVArea*fpix_spec_1mm))) # from N. Billot Doc.
 234     ##########################################################
 235     ### Integration Time calculations for given conditions ###
 236     ##########################################################
 237     t_spec     = ((NEFD_spec_eff*filtering/rms)**2)*factor_area_spec*(foverhead)/3600.0 #hours
 238     s_map_spec = ((FoVArea*fpix_spec_1mm)/(((NEFD_spec_eff*filtering)**2)*foverhead))*3600.0            # arcmin^2 / hour^-1/ mJy^-2 
 239 if band == 2:
 240     tau = bv_2*pwv + cv_2
 241     NEFD_spec_eff      = NEFD_band2_spec*(np.e**(tau/np.sin(elevation*math.pi/180.)))
 242     rms_point_MJy_spec = rms/area_teta_band2_spec/10**9
 243     rms_point_cmb_spec = rms_point_MJy_spec*b_v_cmb(150,2.726)*10**6   
 244     rms_point_ys_spec  = rms_point_MJy_spec*y_sz(150,2.726)*10**6     
 245     rms_point_ys_spec  = np.abs(rms_point_ys_spec)
 246     #########################################
 247     ### ratio of areas with fraction of valid pixel in the 2mm band ###       
 248     #########################################
 249     factor_area_spec   = (1+(area_obs/(FoVArea*fpix_spec_2mm))) # from N. Billot Doc.
 250     ##########################################################
 251     ### Integration Time calculations for given conditions ###
 252     ##########################################################
 253     t_spec     = ((NEFD_spec_eff*filtering/rms)**2)*factor_area_spec*(foverhead)/3600.0 #hours
 254     s_map_spec = ((FoVArea*fpix_spec_2mm)/(((NEFD_spec_eff*filtering)**2)*foverhead))*3600.0            # arcmin^2 / hour^-1/ mJy^-2 
 255 
 256 #########################################
 257 #### TIME PER OTF LINE TO REACH TOTAL ###
 258 #########################################
 259 
 260 T_SLOW = slewing_loss*((dx*60.0)/sampl_vel_slow)/60.0  # [minutes] 
 261 T_MID  = slewing_loss*((dx*60.0)/sampl_vel_mid)/60.0   # [minutes] 
 262 T_FAST = slewing_loss*((dx*60.0)/sampl_vel_fast)/60.0  # [minutes] 
 263 
 264 if verbose_flag == 1:
 265 
 266     print ''
 267     print '%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%'
 268     print '%%%%%%%%%% General Parameters Used for the Calculations %%%%%%%%%%%'
 269     print '%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%'
 270     print ''
 271     print '------------------------------------------------------------------------'
 272     print '|      Parameters      |    Band 1 (1.2 mm)    |    Band 2 (2.0 mm)    |'
 273     print '------------------------------------------------------------------------'
 274     print '|      opacity         |  %6.3fxpwv + %6.3f  |  %6.3fxpwv + %6.3f  |' % (bv_1,cv_1,bv_2,cv_2)
 275     print '------------------------------------------------------------------------'
 276     print '| HPBW [arcsec]        |       %6.1f          |       %6.1f          |' % (res_band1_spec,res_band2_spec)
 277     print '------------------------------------------------------------------------'
 278     print '| NEFDo [mJy.s^0.5]    |       %6.1f          |       %6.1f          |' % (NEFD_band1_spec,NEFD_band2_spec) 
 279     print '------------------------------------------------------------------------'
 280     print '| fpix                 |       %6.2f          |       %6.2f          |' % (fpix_spec_1mm, fpix_spec_2mm)
 281     print '------------------------------------------------------------------------'
 282     if band  == 1:
 283         print '| rms [mJy/beam]       |       %6.2f          |                       |' % (rms)
 284     if band  == 2:
 285         print '| rms [mJy/beam]       |                       |       %6.2f          |' % (rms)
 286     print '------------------------------------------------------------------------'
 287     print '| FoV [arcmin]         |                   %6.1f                      |' % (FoV) 
 288     print '------------------------------------------------------------------------'
 289     print '| h-filtering          |                   %6.2f                      |' % (filtering) 
 290     print '------------------------------------------------------------------------'
 291     print '| h-overhead           |                   %6.2f                      |' % (foverhead) 
 292     print '------------------------------------------------------------------------'
 293     print '| OTF slow [arcsec/s]  |                    %4i                       |' % (sampl_vel_slow)
 294     print '------------------------------------------------------------------------'
 295     print '| OTF mid  [arcsec/s]  |                    %4i                       |' % (sampl_vel_mid)
 296     print '------------------------------------------------------------------------'
 297     print '| OTF fast [arcsec/s]  |                    %4i                       |' % (sampl_vel_fast)
 298     print '------------------------------------------------------------------------'
 299     print '| Dump [hz]            |                   %6.2f                      |' % (sampl_rate)
 300     print '------------------------------------------------------------------------'
 301     print '| Dump POL [hz]        |                   %6.2f                      |' % (sampl_rate_pol)
 302     print '------------------------------------------------------------------------'
 303     print ''
 304 
 305     print '     %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%'
 306     print '     %%%%%%%%%%%%%%%%%   Units Conversion   %%%%%%%%%%%%%%%%%'
 307     print '     %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%'
 308     print ''    
 309     print '     --------------------------------------------------------'
 310     print '     |         (User Defined)             |    Band %1i       |' % (band)
 311     print '     --------------------------------------------------------'
 312     print '     |rms [mJy/beam]                      |  %8.2f       |' % (rms) 
 313     print '     --------------------------------------------------------'
 314     print '     |rms point-like source [MJy/sr]      |     %6.2f      |'  % (rms_point_MJy_spec) 
 315     print '     |rms point-like source [K_CMB]x10^-6 |     %5i       |'  % (rms_point_cmb_spec) 
 316     print '     |*rms point.like source [Ysz]x10^-6  |     %5i       |'  % (rms_point_ys_spec) 
 317     print '     --------------------------------------------------------'
 318     print '     |* for Ysz = 1.0                                       |'
 319     print '     --------------------------------------------------------'
 320     print ''
 321 
 322 
 323 #############################
 324 #### TABLE FINAL RESULTS ####
 325 #############################
 326         
 327 print '     %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%'    
 328 print '     %%%%%%%%%%%%%%%%%%%%%%   Results  %%%%%%%%%%%%%%%%%%%%%%'    
 329 print '     %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%'    
 330 print ''    
 331 print '     for: El = %2i (deg), PWV = %1i (mm), tau = %4.2f, rms = %6.2f'  %  (elevation,pwv,tau,rms) 
 332 print '     Area = %4.1f (arcmin^2), Filter = %4.1f, Overhead = %4.1f'  %  (area_obs,filtering,foverhead) 
 333 print '  ---------------------------------------------------------------'
 334 print '  |    (User Defined)      |                          |         |'
 335 print '  ---------------------------------------------------------------'
 336 print '  | Band                   |                          |    %1i    |'  % (band) 
 337 print '  ---------------------------------------------------------------'
 338 if band  == 1:
 339     print '  | Total Integration Time at 1mm |         [hours]          | %6.1f  |'  % (t_spec)
 340     print '  ---------------------------------------------------------------'
 341     print '  | Mapping speed          | [arcmin^-2/hour/mJy^-2 ] | %6.1f  |'  % (s_map_spec) 
 342 if band  == 2:
 343     print '  | Total Integration Time at 2mm |         [hours]          | %6.1f  |'  % (t_spec)
 344     print '  ---------------------------------------------------------------'
 345     print '  | Mapping speed          | [arcmin^-2/hour/mJy^-2 ] | %6.1f  |'  % (s_map_spec) 
 346 print '  ---------------------------------------------------------------'
 347 print ' '
 348 
 349 if verbose_flag == 1:
 350 
 351     print bcolors.WARNING + '  WARNING1: For proposed maps taking longer than 40 minutes, the total' 
 352     print bcolors.WARNING + '  integration time should be split into several maps.\n' + bcolors.ENDC
 353     print ' '
 354     print bcolors.WARNING + '  WARNING2: Note that the confusion noise is not included in this Time' 
 355     print bcolors.WARNING + '  Estimator and it should be discussed in the proposal whether appro-'
 356     print bcolors.WARNING + '  priate. The RMS noise does not decrease indefinitely with integra- '
 357     print bcolors.WARNING + '  tion time but stops at the confusion limit caused by unresolved sour-'
 358     print bcolors.WARNING + '  ces within the beam. The exact threshold at which the RMS noise    '
 359     print bcolors.WARNING + '  reaches the confusion limit will vary with wavelength, beam size,  '
 360     print bcolors.WARNING + '  and the type of astronomical source (Galactic or Extra-Galactic). For' 
 361     print bcolors.WARNING + '  instance, for the GOODS-N field (part of the Deep Field GT Proposal),' 
 362     print bcolors.WARNING + '  a preliminary 1 sigma confusion limit around ~ 0.090 mJy and ~ 0.056' 
 363     print bcolors.WARNING + '  mJy at 1.2 mm and 2.0 mm, respectively, has been estimated (A. Beelen,'
 364     print bcolors.WARNING + '  private communication).\n' + bcolors.ENDC
 365 
 366     print ' '
 367     print '             Time per OTF line for allowed scanning speeds   '
 368     print '        -----------------------------------------------------'
 369     print '        |          | OTF Scan Velocity  | TIME PER OTF LINE |'
 370     print '        -----------------------------------------------------'
 371     print '        |          |     [arcsec/s]     |    [minutes]      |'
 372     print '        -----------------------------------------------------'
 373     print '        | OTF-SLOW |       %6.1f       |     %6.2f        |' % (sampl_vel_slow,T_SLOW)
 374     print '        | OTF-MID  |       %6.1f       |     %6.2f        |' % (sampl_vel_mid,T_MID)
 375     print '        | OTF-FAST |       %6.1f       |     %6.2f        |' % (sampl_vel_fast,T_FAST)
 376     print '        -----------------------------------------------------'
 377     print ' '
 378 
 379 ###############################
 380 #### CONVERSION TO MINUTES ####
 381 ###############################
 382 
 383 if t_spec >= 1.:
 384    time_str_spec=str(round(t_spec,1))+' hours'
 385 
 386 if t_spec < 1. and t_spec >= 1./60.:
 387    time_str_spec=str(round(t_spec*60,1))+' minutes'
 388 
 389 if t_spec < 1./60. and t_spec >= 0.1/3600.:
 390    time_str_spec=str(int(t_spec*3600))+' seconds'
 391 
 392 if t_spec < 0.1/3600.:
 393    time_str_spec='0.1 (seconds)'
 394 
 395 slew_overhe = str(int((slewing_loss-1.0)*100.0))
 396 
 397 ##############################
 398 #### OUTPUT FINAL RESULTS ####
 399 ##############################
 400     
 401 #if dx < 6.5 or dy < 6.5: 
 402 print bcolors.HEADER + bcolors.BOLD  + 'To optimize the correction of data instabilities, the size of scans along'
 403 print bcolors.HEADER + bcolors.BOLD  + 'the scan direction should be at least:'  
 404 print bcolors.HEADER + bcolors.BOLD  + 'NIKA2 FOV (6.5 arcminutes) + 2 * NIKA2 beam width (12 arcseconds at 1mm,' 
 405 print bcolors.HEADER + bcolors.BOLD  + '18 arcseconds at 2mm) + source size above the noise + 2s * scan speed'
 406 print bcolors.HEADER + bcolors.BOLD  +  bcolors.UNDERLINE + 'Please check your source size and your scanning speed to evaluate' 
 407 print bcolors.HEADER + bcolors.BOLD  +  bcolors.UNDERLINE + 'the correct map size fitting your needs.' + bcolors.ENDC
 408 
 409 print ''
 410 print bcolors.HEADER + '***********************************************'
 411 print '***  Total Integration Time => ' + time_str_spec + '   ***'
 412 print '***********************************************\n'    
 413 print ''
 414 
 415 print bcolors.HEADER +  bcolors.UNDERLINE + 'Please include the following text into your proposal:\n' + bcolors.ENDC
 416 
 417 print 'According to the published commissioning results of the NIKA2 instrument, the total observing time using the NIKA2 '+str(band)+' mm band to map a region of '+str(round(area_obs,1))+' [arcmin^2] to reach an rms of '+str(rms)+' [mJy/beam], assuming '+str(pwv)+' [mm] pwv, '+str(elevation)+' [deg] elevation, Filter = '+str(filtering)+', Overhead = '+str(foverhead)+', was estimated to be *'+time_str_spec+'*, using the time estimator '+version+'.\n'