Module pylal_exttrig_llutils

Makes an internal call to the shell (with the current set environment), wait for completion and returns the output and error of the command.

Parameters:

• command - command to be executed internally

Returns:

a tuple (status, output, error)

Computes the correct GPS time from the date and time as given in text strings.

Parameters:

• date_string - date in a string format, i.e. 090717
• time_string - time in a string format, i.e. 19:10:34

Returns the main directory of the analysis from the cp file. If that does not exist, returns the current directory.

Function to send an email to a certain adress

Parameters:

• subject - Subject line of the email
• msg - Message of the email
• email_addresses - list of email addresses to which the mail is sent
• extra_addresses - Extra adresses to which to send the email

Makes an email notification to all recipients listed in the config file.

Parameters:

• grb - grb dictionary for obtaining some informations
• message - the message of the notification

Checks if another instance of this code is running. See http://code.activestate.com/recipes/546512/

Gets the dag-name from the ini file. This might be non-robust, therefore it is coded as a complete function which can be changes easily.

Parameters:

• ini_file - the name of the ini-file
• return - the common part of any dag name

Check the existance of a file and that it is non-zero in size (which is useful for segment files...)

Parameters:

• filename - name of the file to check

Returns:

True or False

Calculate the minimum science segment that can be used with the data given in the actual ini-file. The procedure below is taken from trigger_hipe.

Function to download the latest segment lists.

Parameters:

• segdict - the names of the segment for each IFO
• timerange - the timerange the segments should cover
• tag - optional parameter indicating the tag (e.g. 'grb090802')
• outputdir - optional parameter indicating the output directory.

Function to update the veto files for a given time range

Parameters:

• tag - Tag for the output files [optional]

Function to check if the given timerange overlaps with some CAT veto

Parameters:

• used_ifos - A list of used ifos for which SCIENCE data is available
• list_cat - A list of numbers, specifying the categories that should be checked for
• timerange - The range of time that should be checked
• path - Output path for the segment files [optional]
• tag - Tag for the output files [optional]

Function to get the segment info for a timerange

Parameters:

• timerange - The range of time the SCIENCE segments should be checked
• minsciseg - The minimum time length (in seconds) for an analyzable consecutive segment
• plot_segments_file - Name of the output name for the plot [optional]
• path - Output path for the segment files (NOT the image) [optional]
• tag - Tag for the files [optional]
• segscat1 - CAT1 veto times to be considered when finding the best segment [optional]

Function to plot the segments around a 'centertime'

Parameters:

• segdict - dictionary containing the segments of the science data
• onsource - the onsource segment
• offsource - the offsource segment
• centertime - the time at which the origin is set
• output_filename - output filename of the plot
• plot_offet - additional times (in second) on either side of the range
• tag - full tag denoting e.g. the GRB (with the underscore before)

Function for a full scale check how many IFOs are available for a given time
Requires a CP to be set with the following fileds:
  'data','science_segment_[IFO]'
  'data','veto_definer'
  'analysis','onsource_left'
  'analysis','onsource_right'

Reads the adjusted onsource times for GRBs inspected manually. Uses the simple file format

Reads the adjusted onsource times for GRBs inspected manually. Uses the Jordi-type of file

This function parses the GRB list provided by Isabel and returns a list of new GRBs

Parameters:

• trigger_file - The name of the trigger file to parse
• processed - List of triggers already processed [optional]
• max_number - Returns at maximum this number of new triggers
• specific_name - Will return a list with only the trigger information for this specific item, if it is found [optional]

Returns an empty exttrig row

Returns:

empty exttrig table row

Returns the name of the monitor pickle filename

Returns:

name of the monitor pickle file

Opens the monitor pickle file (usually llmonitor.pickle) and return its contents.

Returns:

list of GRB instances from the pickle file

Writes the monitor list to file

Parameters:

• monitor_list - list to be written to file

Obtain the result, i.e the smallest p(c|0)

Parameters:

• grb - the grb stucture with all the infos in it

Generating summary page, with all sanity and/or openbox results properly linked.

Parameters:

• publish_path - Main path to where to copy the results and files
• publish_url - The url identifier of the same path

Returns the name of the tag currently stored in an environment variable

Returns:

name of the tag

template_trigger_hipe

Value:

"./lalapps_trigger_hipe" " --number-buffer-left 8 --number-buffer-righ t 8" " --verbose --skip-datafind " " --injection-config injectionsWI.i ni" " --user-tag onoff"

template_trigger_hipe_inj

Value:

"./lalapps_trigger_hipe" " --number-buffer-left 8 --number-buffer-righ t 8" " --verbose --skip-datafind " " --user-tag inj " " --overwrite-di r"

runtimes

Value:

{'A': [931035296, 935798487], 'B': [937800015, 947347215], 'C': [94900 3215, 961545615], 'D': [961545615, 971654415]}

total_summary_prefix

Value:

""" <body style="color: rgb(0, 0, 0); background-color: rgb(221, 255, 255) ;" alink="#000099" link="#000099" vlink="#990099"> <h1>Summary of Gamma Ray Burst low-latency results during S6</h1> <span style="font-weight: bold;"><br><br> The following table contain a list of Gamma Ray Bursts occured during ...