Monitoring webpage help

From GlueXWiki
Jump to: navigation, search

The purpose of the various monitoring web-pages is to allow users to quickly and easily access the graphs produced from the launches. These graphs can be viewed by plot (the same plot from all of the different runs in a user selected range), by run (all of the plots from a user selected run), by version (all of a given plot from each version of a given run), and by time (extracted quantities graphed over time). Below are the monitoring web-pages with a quick guide on how to use them:

Plot Browser Plot Browser

After the page loads the user is prompter for the Run Period and Reconstruction Version. When a Run Period is selected from the drop-down the Version drop-down will auto-update to display only the valid versions for the chosen run period. The default run numbers for the given run period will also auto-complete. Next, the user picks the plot to be displayed. This drop-down menu contains a list of all possible plots (Note: just because a plot is in this list does not mean such a plot was produced for the given Run Period, Reconstruction Version, and/or range of run numbers). The range of run numbers to look at can be specified by typing in the starting and ending run number inclusively. It is important to note that, at present, these entries are not error protected. Thus supplying any non-numeric character or giving the range from high to low will result in the page crashing. Should this occur the session will need to be restarted and options reselected. The final two text fields are the MYSQL query, where users can enter additional querying statements demanded of the returned runs, and the additional RCDB query requirements, which have been defaulted to "@is_production and @status_approved" but can be modified at the users discretion.

After all options have been entered hit the "Display" button. The page will appear to refresh and the relevant plots will be displayed in a table on the bottom half of the page. The user can click on the "Run xxxxx" hyperlink and will be taken to the runBrowser page for the given run. Currently this link does not load the plots from the run and the user should consult the section on the run Browser for more information.

There are three possible states for the plots to be in:

1) A broken image link appears. This means the selected plot was not produced for the run.

2) A white image. This plot was supposed to be produced but something went wrong in the saving of the image file

3) The plot. The plot was found for the given options.

Run Browser Run Browser

The runBrowser has a few more nuances than some of the other Browsers. It contains, on the left panel, the familiar options of Run Period and Reconstruction Version. When selecting the RunPeriod the the list of possible versions will auto update. If you know the run number you are interested in and know that it IS a part of the Run Period and Version then select all three options and hit display. If you aren't sure then follow the commented steps below.

1) Choose a Run Period

2) Choose a valid version number from the second drop-down

3) Click display. The page will refresh and will list only those runs that belong to the given Run Period and Version.

4) Find the date with the run you would like to view and click the "+" which should flare out a list of runs.

5) Select the radio button next to the run number. The accompanying "ROOT" button will spawn a new browser tab/window where the root file associated with the run can be viewed. The "RCDB" button will open the Run Conditions DataBase entry of the associated run. Note: While selecting the various options the path the site will pull from will be updated in real time so that the user can see where the plots are coming from, this should help both with accuracy and in potential debugging situations.

6) Click display. This will refresh the page and load on the right pane a table of plots that can be viewed. If this table is not present you may see an error alerting the user that the selected run number is not a valid member of the Run Period/Version selected.

First, select a system by clicking on the associated header. You can then view a histogram by mousing over it in the table of plots. To freeze/unfreeze click the entry in the plots table. At any point the user may select a different run (by selecting the associated radio button on the left pane). This will automatically update the plots given by the table of plots. It, however, will NOT update the table of plots itself unless "Display" is clicked. This holds true for changes in the version and Run Period but again the list of run dates and the table of plots are currently fixed and can only be updated by refreshing the page or clicking "Display". Once again the plots can be in one of three states: broken, white, or visible.

Version Browser Version Browser

The version Browser is perhaps the simplest to use. Simply select a run period from the first drop-down, select a plot from the second drop-down and type in a run number (this entry MUST be a number). Finally, click "Display". This will show a table of the selected plot across the various versions of the run period and run number. Clicking the version hyperlink will take the user to the runBrowser for the given run period, run number, and selected version. The run browser options will already be entered and the user can begin browsing. The plots can be in one of three states: broken, white, or visible.

Reconstruction Test Browser Reconstruction Test Browser

The Reconstruction Test Browser is designed to give an intuitive way to look at the results from the various reconstruction tests. The web-page should load and display a default layout of plots. This table is dynamically generated and is refreshed on-the-fly whenever a user makes changes to the options. The user can begin by selecting the RunPeriod and associated run number from the first drop down. This action should load a default start date into the start date field, with the end date field defaulted to "today". To change either date simply click on the field and select the desired date from the pop-out calendar. Next, the user can select the plot to display from the associated drop down. Additionally the user can select how many columns are desired. All changes should automatically update the table of images in real time. The images themselves are click-able and will open up the image in a new window to be viewed at full scale. The dates above each image are also click-able and take you to the reconstruction test webpage for that specific date. The images will also rescale with window size dynamically and should provide for more convenient viewing of images in instances where there is limited screen space to use.