.. include:: subst.inc Event display ============= This page describes how the `Event display `_ works. With this web application you can see |hisparc| events occuring on a map. .. _event-display: .. figure:: images/event-display.png :align: center :width: 500 The event display for Science Park. Markers ------- The map will show two kinds of markers: - **events** are air showers detected by a single |hisparc| station - **coincidences** are air showers detected by multiple |hisparc| stations simultaneously Their respective colors are shown in the legend in the topright. .. _event-display_legend: .. figure:: images/event-display_legend.png :align: center :width: 134 Marker legend. Choose cluster -------------- In the bottom right of the page is a dropdown menu from which a subcluster can be selected. Events and coincidences from the chosen subcluster will be shown on the map. The chosen subcluster will be set as the location hash of the page. So if Amsterdam is chosen the url ends in ``#amsterdam``. If the page is loaded without a hash it will default to the Science Park cluster, automatically setting the hash to that value. .. _event-display_cluster: .. figure:: images/event-display_cluster.png :align: center :width: 178 Menu to choose the cluster. JSON data --------- The page works by loading pregenerated JSON data. - First a station JSON is loaded. This contains a list of stations and their locations, and the start and end timestamps of the dataset. The start and end timestamps are used to align the individual events and coincidences. - Then a JSON with a list of events is loaded for each of these stations. For each event the exact timestamp and number of particles is given. The timestamps are used to playback the events in real-time, since the time between consecutive events is known. The number of particles is used to determine the size of the marker. - Finally a JSON with coincidences between the stations is loaded. This contains similar data like the event JSONs, but then for each shower the number of particles for each participating station. In the `source code `_ the Python script that creates the JSONs can be found. The JSON data is loaded with relative paths, so if ran locally you can supply your own data. .. note:: If you want to use Chrome when running this page locally it needs to be started with the ``--allow-file-access-from-files`` option.