Histo-Scope V4.0 User's Guide

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/AIX

Graphics 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.

Table of Contents

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 Variables

on 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