llama.files.i3.txt module

FileHandler for making a nicely-formatted ascii table of IceCube neutrinos including their reconstructed properties and their joint significance when combined with a gravitational wave. Can also be used as a stand-alone command-line script to generate a human-readable table with neutrinos for this event from an input JSON file. Used for GCN circulars.

class llama.files.i3.txt.IceCubeNeutrinoListCoincTxt

Bases: llama.filehandler.FileHandler

digraph "llama.files.i3.txt.IceCubeNeutrinoListCoincTxt" { charset="utf-8" splines=ortho bgcolor=none margin=0 rankdir=LR "llama.files.coinc_significance.CoincSignificanceI3Lvc" [label=<{{<B>CoincSignificanceI3Lvc</B>|<I>significance_lvc-i3.json</I>|JSONFile}}>, shape="record", style=filled, target=_top, URL="/llama.files.coinc_significance.html#llama.files.coinc_significance.CoincSignificanceI3Lvc", fillcolor="#cccccc"]; "llama.files.gracedb.LVCGraceDbEventData" [label=<{{<B>LVCGraceDbEventData</B>|<I>lvc_gracedb_event_data.json</I>|JSONFile<BR/>OnlineVetoMixin}}>, shape="record", style=filled, target=_top, URL="/llama.files.gracedb.html#llama.files.gracedb.LVCGraceDbEventData", fillcolor="#cccccc"]; "llama.files.gracedb.PAstro" [label=<{{<B>PAstro</B>|<I>p_astro.json</I>|GraceDBPollingFileHandler<BR/>JSONFile}}>, shape="record", style=filled, target=_top, URL="/llama.files.gracedb.html#llama.files.gracedb.PAstro", fillcolor="#cccccc"]; "llama.files.i3.json.IceCubeNeutrinoList" [label=<{{<B>IceCubeNeutrinoList</B>|<I>icecube_neutrino_list.json</I>|JSONFile<BR/>HEALPixPSF}}>, shape="record", style=filled, target=_top, URL="/llama.files.i3.json.html#llama.files.i3.json.IceCubeNeutrinoList", fillcolor="#cccccc"]; "llama.files.i3.txt.IceCubeNeutrinoListCoincTxt" [label=<{{<B>IceCubeNeutrinoListCoincTxt</B>|<I>icecube_neutrino_list_coinc.txt</I>|FileHandler}}>, shape="record", style=filled, target=_top, URL="/llama.files.i3.txt.html#llama.files.i3.txt.IceCubeNeutrinoListCoincTxt", fillcolor="#cccccc"]; "llama.files.lvc_skymap.LvcDistancesJson" [label=<{{<B>LvcDistancesJson</B>|<I>lvc_skymap_distances.json</I>|JSONFile}}>, shape="record", style=filled, target=_top, URL="/llama.files.lvc_skymap.html#llama.files.lvc_skymap.LvcDistancesJson", fillcolor="#cccccc"]; "llama.files.lvc_skymap.LvcSkymapFits" [label=<{{<B>LvcSkymapFits</B>|<I>lvc_skymap.fits.gz</I>|LvcHEALPixSkyMapFileHandler<BR/>GenerateOnceMixin<BR/>ObservingVetoMixin}}>, shape="record", style=filled, target=_top, URL="/llama.files.lvc_skymap.html#llama.files.lvc_skymap.LvcSkymapFits", fillcolor="#cccccc"]; "llama.files.lvc_skymap.LvcSkymapHdf5" [label=<{{<B>LvcSkymapHdf5</B>|<I>lvc_skymap.hdf5</I>|HEALPixSkyMapFileHandler}}>, shape="record", style=filled, target=_top, URL="/llama.files.lvc_skymap.html#llama.files.lvc_skymap.LvcSkymapHdf5", fillcolor="#cccccc"]; "llama.files.skymap_info.SkymapInfo" [label=<{{<B>SkymapInfo</B>|<I>skymap_info.json</I>|EventTriggeredFileHandler<BR/>JSONFile}}>, shape="record", style=filled, target=_top, URL="/llama.files.skymap_info.html#llama.files.skymap_info.SkymapInfo", fillcolor="#cccccc"]; "llama.files.coinc_significance.CoincSignificanceI3Lvc" -> "llama.files.i3.txt.IceCubeNeutrinoListCoincTxt" [arrowtail="none", color="red", ]; "llama.files.gracedb.LVCGraceDbEventData" -> "llama.files.coinc_significance.CoincSignificanceI3Lvc" [arrowtail="none", color="red", ]; "llama.files.gracedb.PAstro" -> "llama.files.coinc_significance.CoincSignificanceI3Lvc" [arrowtail="none", color="red", ]; "llama.files.i3.json.IceCubeNeutrinoList" -> "llama.files.coinc_significance.CoincSignificanceI3Lvc" [arrowtail="none", color="red", ]; "llama.files.i3.json.IceCubeNeutrinoList" -> "llama.files.i3.txt.IceCubeNeutrinoListCoincTxt" [arrowtail="none", color="red", ]; "llama.files.lvc_skymap.LvcDistancesJson" -> "llama.files.coinc_significance.CoincSignificanceI3Lvc" [arrowtail="none", color="red", ]; "llama.files.lvc_skymap.LvcSkymapFits" -> "llama.files.lvc_skymap.LvcDistancesJson" [arrowtail="none", color="red", ]; "llama.files.lvc_skymap.LvcSkymapFits" -> "llama.files.lvc_skymap.LvcSkymapHdf5" [arrowtail="none", color="red", ]; "llama.files.lvc_skymap.LvcSkymapHdf5" -> "llama.files.coinc_significance.CoincSignificanceI3Lvc" [arrowtail="none", color="red", ]; "llama.files.skymap_info.SkymapInfo" -> "llama.files.coinc_significance.CoincSignificanceI3Lvc" [arrowtail="none", color="red", ]; "llama.files.skymap_info.SkymapInfo" -> "llama.files.gracedb.LVCGraceDbEventData" [arrowtail="none", color="red", ]; "llama.files.skymap_info.SkymapInfo" -> "llama.files.gracedb.PAstro" [arrowtail="none", color="red", ]; "llama.files.skymap_info.SkymapInfo" -> "llama.files.i3.json.IceCubeNeutrinoList" [arrowtail="none", color="red", ]; "llama.files.skymap_info.SkymapInfo" -> "llama.files.i3.txt.IceCubeNeutrinoListCoincTxt" [arrowtail="none", color="red", ]; "llama.files.skymap_info.SkymapInfo" -> "llama.files.lvc_skymap.LvcSkymapFits" [arrowtail="none", color="red", ]; }

Required input files for llama.files.i3.txt.IceCubeNeutrinoListCoincTxt (located on the far right of the graph). For a typical trigger, the leftmost files will be generated as triggers become available. They will be used as input for files to their right, eventually allowing llama.files.i3.txt.IceCubeNeutrinoListCoincTxt to be generated.

A space-delimited, table-formatted list of neutrinos meant for human consumption in GCN Circulars. Contains coincidence significance measures in addition to the base neutrino properties.

DEPENDENCIES = (<class 'llama.files.i3.json.IceCubeNeutrinoList'>, <class 'llama.files.skymap_info.SkymapInfo'>, <class 'llama.files.coinc_significance.CoincSignificanceI3Lvc'>)
FILENAME = 'icecube_neutrino_list_coinc.txt'
MANIFEST_TYPES = (<class 'llama.files.i3.txt.IceCubeNeutrinoListCoincTxt'>,)
UR_DEPENDENCIES = (<class 'llama.files.skymap_info.SkymapInfo'>, <class 'llama.files.lvc_skymap.LvcSkymapFits'>, <class 'llama.files.gracedb.PAstro'>, <class 'llama.files.lvc_skymap.LvcDistancesJson'>, <class 'llama.files.gracedb.LVCGraceDbEventData'>, <class 'llama.files.lvc_skymap.LvcSkymapHdf5'>, <class 'llama.files.i3.json.IceCubeNeutrinoList'>, <class 'llama.files.coinc_significance.CoincSignificanceI3Lvc'>)
UR_DEPENDENCY_TREE = ImmutableDict({<class 'llama.files.i3.json.IceCubeNeutrinoList'>: ImmutableDict({<class 'llama.files.skymap_info.SkymapInfo'>: ImmutableDict({})}), <class 'llama.files.coinc_significance.CoincSignificanceI3Lvc'>: ImmutableDict({<class 'llama.files.i3.json.IceCubeNeutrinoList'>: ImmutableDict({<class 'llama.files.skymap_info.SkymapInfo'>: ImmutableDict({})}), <class 'llama.files.skymap_info.SkymapInfo'>: ImmutableDict({}), <class 'llama.files.lvc_skymap.LvcSkymapHdf5'>: ImmutableDict({<class 'llama.files.lvc_skymap.LvcSkymapFits'>: ImmutableDict({<class 'llama.files.skymap_info.SkymapInfo'>: ImmutableDict({})})}), <class 'llama.files.gracedb.LVCGraceDbEventData'>: ImmutableDict({<class 'llama.files.skymap_info.SkymapInfo'>: ImmutableDict({})}), <class 'llama.files.lvc_skymap.LvcDistancesJson'>: ImmutableDict({<class 'llama.files.lvc_skymap.LvcSkymapFits'>: ImmutableDict({<class 'llama.files.skymap_info.SkymapInfo'>: ImmutableDict({})})}), <class 'llama.files.gracedb.PAstro'>: ImmutableDict({<class 'llama.files.skymap_info.SkymapInfo'>: ImmutableDict({})})}), <class 'llama.files.skymap_info.SkymapInfo'>: ImmutableDict({})})
class llama.files.i3.txt.IceCubeNeutrinoListTxt

Bases: llama.filehandler.FileHandler

digraph "llama.files.i3.txt.IceCubeNeutrinoListTxt" { charset="utf-8" splines=ortho bgcolor=none margin=0 rankdir=LR "llama.files.i3.json.IceCubeNeutrinoList" [label=<{{<B>IceCubeNeutrinoList</B>|<I>icecube_neutrino_list.json</I>|JSONFile<BR/>HEALPixPSF}}>, shape="record", style=filled, target=_top, URL="/llama.files.i3.json.html#llama.files.i3.json.IceCubeNeutrinoList", fillcolor="#cccccc"]; "llama.files.i3.txt.IceCubeNeutrinoListTxt" [label=<{{<B>IceCubeNeutrinoListTxt</B>|<I>icecube_neutrino_list.txt</I>|FileHandler}}>, shape="record", style=filled, target=_top, URL="/llama.files.i3.txt.html#llama.files.i3.txt.IceCubeNeutrinoListTxt", fillcolor="#cccccc"]; "llama.files.skymap_info.SkymapInfo" [label=<{{<B>SkymapInfo</B>|<I>skymap_info.json</I>|EventTriggeredFileHandler<BR/>JSONFile}}>, shape="record", style=filled, target=_top, URL="/llama.files.skymap_info.html#llama.files.skymap_info.SkymapInfo", fillcolor="#cccccc"]; "llama.files.i3.json.IceCubeNeutrinoList" -> "llama.files.i3.txt.IceCubeNeutrinoListTxt" [arrowtail="none", color="red", ]; "llama.files.skymap_info.SkymapInfo" -> "llama.files.i3.json.IceCubeNeutrinoList" [arrowtail="none", color="red", ]; "llama.files.skymap_info.SkymapInfo" -> "llama.files.i3.txt.IceCubeNeutrinoListTxt" [arrowtail="none", color="red", ]; }

Required input files for llama.files.i3.txt.IceCubeNeutrinoListTxt (located on the far right of the graph). For a typical trigger, the leftmost files will be generated as triggers become available. They will be used as input for files to their right, eventually allowing llama.files.i3.txt.IceCubeNeutrinoListTxt to be generated.

A space-delimited, table-formatted list of neutrinos formatted for human consumption in GCN Circulars.

DEPENDENCIES = (<class 'llama.files.i3.json.IceCubeNeutrinoList'>, <class 'llama.files.skymap_info.SkymapInfo'>)
FILENAME = 'icecube_neutrino_list.txt'
MANIFEST_TYPES = (<class 'llama.files.i3.txt.IceCubeNeutrinoListTxt'>,)
UR_DEPENDENCIES = (<class 'llama.files.skymap_info.SkymapInfo'>, <class 'llama.files.i3.json.IceCubeNeutrinoList'>)
UR_DEPENDENCY_TREE = ImmutableDict({<class 'llama.files.i3.json.IceCubeNeutrinoList'>: ImmutableDict({<class 'llama.files.skymap_info.SkymapInfo'>: ImmutableDict({})}), <class 'llama.files.skymap_info.SkymapInfo'>: ImmutableDict({})})
class llama.files.i3.txt.RctGwaIceCubeNeutrinoListTxt

Bases: llama.files.gwastro.GWAstroReceipt

digraph "llama.files.i3.txt.RctGwaIceCubeNeutrinoListTxt" { charset="utf-8" splines=ortho bgcolor=none margin=0 rankdir=LR "llama.files.i3.json.IceCubeNeutrinoList" [label=<{{<B>IceCubeNeutrinoList</B>|<I>icecube_neutrino_list.json</I>|JSONFile<BR/>HEALPixPSF}}>, shape="record", style=filled, target=_top, URL="/llama.files.i3.json.html#llama.files.i3.json.IceCubeNeutrinoList", fillcolor="#cccccc"]; "llama.files.i3.txt.IceCubeNeutrinoListTxt" [label=<{{<B>IceCubeNeutrinoListTxt</B>|<I>icecube_neutrino_list.txt</I>|FileHandler}}>, shape="record", style=filled, target=_top, URL="/llama.files.i3.txt.html#llama.files.i3.txt.IceCubeNeutrinoListTxt", fillcolor="#cccccc"]; "llama.files.i3.txt.RctGwaIceCubeNeutrinoListTxt" [label=<{{<B>RctGwaIceCubeNeutrinoListTxt</B>|<I>rct_gwa_icecube_neutrino_list.txt.log</I>|GWAstroReceipt}}>, shape="record", style=filled, target=_top, URL="/llama.files.i3.txt.html#llama.files.i3.txt.RctGwaIceCubeNeutrinoListTxt", fillcolor="#cccccc"]; "llama.files.skymap_info.SkymapInfo" [label=<{{<B>SkymapInfo</B>|<I>skymap_info.json</I>|EventTriggeredFileHandler<BR/>JSONFile}}>, shape="record", style=filled, target=_top, URL="/llama.files.skymap_info.html#llama.files.skymap_info.SkymapInfo", fillcolor="#cccccc"]; "llama.files.i3.json.IceCubeNeutrinoList" -> "llama.files.i3.txt.IceCubeNeutrinoListTxt" [arrowtail="none", color="red", ]; "llama.files.i3.txt.IceCubeNeutrinoListTxt" -> "llama.files.i3.txt.RctGwaIceCubeNeutrinoListTxt" [arrowtail="none", color="red", ]; "llama.files.skymap_info.SkymapInfo" -> "llama.files.i3.json.IceCubeNeutrinoList" [arrowtail="none", color="red", ]; "llama.files.skymap_info.SkymapInfo" -> "llama.files.i3.txt.IceCubeNeutrinoListTxt" [arrowtail="none", color="red", ]; "llama.files.skymap_info.SkymapInfo" -> "llama.files.i3.txt.RctGwaIceCubeNeutrinoListTxt" [arrowtail="none", color="red", ]; }

Required input files for llama.files.i3.txt.RctGwaIceCubeNeutrinoListTxt (located on the far right of the graph). For a typical trigger, the leftmost files will be generated as triggers become available. They will be used as input for files to their right, eventually allowing llama.files.i3.txt.RctGwaIceCubeNeutrinoListTxt to be generated.

DEPENDENCIES = (<class 'llama.files.i3.txt.IceCubeNeutrinoListTxt'>, <class 'llama.files.skymap_info.SkymapInfo'>)
FILENAME = 'rct_gwa_icecube_neutrino_list.txt.log'
MANIFEST_TYPES = (<class 'llama.files.i3.txt.RctGwaIceCubeNeutrinoListTxt'>,)
RSYNC_DEST = 'gwhen@gw-astronomy.org:/home/gwhen/content/events/'
UPLOAD

alias of IceCubeNeutrinoListTxt

UR_DEPENDENCIES = (<class 'llama.files.skymap_info.SkymapInfo'>, <class 'llama.files.i3.json.IceCubeNeutrinoList'>, <class 'llama.files.i3.txt.IceCubeNeutrinoListTxt'>)
UR_DEPENDENCY_TREE = ImmutableDict({<class 'llama.files.i3.txt.IceCubeNeutrinoListTxt'>: ImmutableDict({<class 'llama.files.i3.json.IceCubeNeutrinoList'>: ImmutableDict({<class 'llama.files.skymap_info.SkymapInfo'>: ImmutableDict({})}), <class 'llama.files.skymap_info.SkymapInfo'>: ImmutableDict({})})})
llama.files.i3.txt.convert_json_neutrinos_to_txt(infilename, outfilename, gpstime=None, p_values=None)

Take a json-formatted input filename and an output filename (both full paths) as arguments. Convert the neutrino list in the infile into a space-delimited, table-formatted list of neutrinos intended for human readability and saved to the path specified in outfilename. If an optional gpstime is given, then the time column will be given as the time difference in seconds between the neutrino’s arrival and the GPS time provided, i.e. the neutrino detection time with t=0 defined as the GPS time.

llama.files.i3.txt.main()

Can also use this module as a command-line script to make this file conversion.