Physics Analysis Tools Group
Histo-Scope
Software Version: V4.0
Date:
Host System Support: VAX/VMS ALPHA/VMS DEC/ULTRIX DEC/OSF-1 SGI/IRIX Sun/Solaris IBM/AIXTable of ContentsGraphics Support: X-based workstation or X-Terminal
Prerequisite Software for VAX/VMS: TGV MultiNet Optional Software: HBOOK Version 4.22 (or later)
This software was produced by the Nirvana project of the Physics Analysis Tools Group. The Nirvana project goal is to provide visualization tools for Fermilab physicists that make effective use of computer workstations and Graphical User Interfaces. Histo-Scope is a pilot product for a suite of easy to use, Motif based tools for physics analysis.
Histo-Scope was written by: Mark Edel, project leader Konstantine Iourha Joy Kyriakopulos Jeff Kallenbach Paul Lebrun Baolin Ren
User's Guide Written by Joy Kyriakopulos and Donna Reid
Copyright (c) 1993, 1994, 1995 Universities Research Association, Inc.
All rights reserved.
This material resulted from work developed under a Government Contract and is subject to the following license: The Government retains a paid-up, nonexclusive, irrevocable worldwide license to reproduce, prepare derivative works, perform publicly and display publicly by or for the Government, including the right to distribute to other Government contractors. Neither the United States nor the United States Department of Energy, nor any of their employees, makes any warranty, express or implied, or assumes any legal liability or responsibility for the accuracy, completeness, or usefulness of any information apparatus, product, or process disclosed, or represents that its use would not infringe privately owned rights.
Introduction 6 New Features for Histo-Scope V4.0 8 Part I - Using the Histo-Scope Program Getting Started with Histo-Scope 10 User Interface Overview for Beginning Motif Users 12 Using Histo-Scope's Main Window 19 Create Multiple Plot Window 26 Connect to Process Window 28 Verifying Proper Setup of Permissions 29 Additional Setup for VMS Users 30 One-Dimensional Histograms 32 Two-Dimensional Histograms 34 Indicators, Controls, and Triggers 36 Indicator Window 36 Control Window 37 Trigger Window 37 Ntuple Window 39 Time Series Plots 42 XY Line Plot 44 XY Scatter Plot 46 XYZ Scatter Plot 48 Adaptive Histogram 50 Adaptive Two-Dimensional Histogram 52 Two-Dimensional Cell Plot 55 Overlay Plots 56 Adjusting Plot Settings 57 Getting Help 57 Getting Statistics on the Data 57 Setting Styles for Markers and Lines and Histograms 58 Showing/Hiding the Variables Legend 58 Sliders: Observing the Effect of Other Ntuple Variableson the Plot 59
Rebinning Ntuple Data Displayed as a Histogram 60 Labelling of Histogram Bin Edges 61 Altering Cell Size for Data Displayed as a Cell Plot 61 Other Views 62 Scaling and Panning the Plots 62 Showing/Hiding Backplanes for 2D Histograms 63 Showing/Hiding Errors for Histograms 64 Thickening/Lightening Scatter Plot Points 64 Update Options for all Plots 65 Printing a Plot 66 Generating a PostScript File of a Plot 66 Showing/Hiding the Range for Indicators and Controls 66 Deleting a MiniPlot 66 Changing the Window Title 66 Removing an Overlayed Plot 66 Closing a Plot 66 Part II -HSDIR Directory Tool 67
Part III -Histo-Scope Library Subroutines 68
Histo-Scope Data Routines 69 Building and Running the Example Programs on Unix 74 Building and Running the Example Programs on VMS 75 Example Programs FORTRAN 77 C 86 FORTRAN Binding Routines Routines for all Users 90 Routines for HBOOK 91 Histo-Scope data routines 91 Item Creation Routines 92 Filling Histograms/Ntuples and Setting Errors 95 Setting Indicators, Reading Controls and Checking Triggers97 Functions for looking up items 98 Functions for getting properties of all items 99 Functions for reading/writing items from/to files 100 Functions for managing data items 101 Functions for Accessing Histogram Data 103 Calculations on histogram data 106 Summing Groups of Histograms and Ntuples 111 Functions for accessing Ntuple data 112 C Binding Routines Routines for all Users 115 Routines for HBOOK 116 Histo-Scope data routines 116 Filling Histograms/Ntuples and Setting Errors 120 Setting Indicators, Reading Controls,and Checking Triggers 122
Functions for looking up items: 123 Functions for getting properties of all items 124 Functions for reading/writing items from/to files 125 Functions for managing data items 126 Functions for accessing histogram data 127 Calculations on histogram data 131 Summing Groups of Histograms and Ntuples 135 Functions for accessing Ntuple data 137 Hints for Programmers 140 Notes for VMS 142 Release Notes Requirements New UID parameter in all the Histo-Scope Item Creation Routines HBOOK Circular Ntuple Support UNIX restriction on putting Histo-Scope process in background Some X-Servers do not destroy child dialog windows Printer Options window Floating Point Errors Setting up Histo-Scope on UNIX without Fermilab's ups/upd Setting up Histo-Scope on VMS without Fermilab's Setup VMS Installation Notes 145 Using Histo-Scope with YBOS on VMS 147 Index 148