[AIT logo]

Institut für Astronomie und Astrophysik

Abteilung Astronomie

Sand 1, D-72076 Tübingen, Germany
[Uni logo]


print Source code in cafe_print.pro

print

Name
           print
Purpose
           prints out data list of single group
Category
           cafe
SYNTAX:
           print [,range][,subgroup][,group]
Input Parameters
           range    - (optional) Define the range to print. This can
                      be either:
                       - Data point range, denoted by the data
                         point number:
                         <n1>[-], while ,  are positive
                         numbers. Data point numbers start from zero.
                         Open intervals can be represented with a
                         "*" instead of the number.
                         If only one number is given, a single
                         data point will be referenced.
                         If <val2> is less than  all but the
                         interval <val2>.. are referenced.
                       - X value range, denoted by float point numbers:
                         <val1>-, while , 
                         represents X values defining the interval to
                         reference. Open intervals can be represented
                         with a *  instead of the value. If <val2> is
                         less than <val1> all but the interval
                         <val2>.. is referenced.
                       - Vector of data point indices. The vector is
                         denoted with [val,val,...,val] (indgen may
                         be used also).
                       - Boolean expressions with X/Y values. All
                         values for which this expression is true are
                         referenced. The expression may contain
                         algebraic formulas combined with comparison
                         operators "lt", "le", "eq", "gt", "ge" as used in IDL
                         comparisons. For each data point a keyword
                         is defined which has meaning and can be used
                         for the boolean expression:
                                 x - The x-column value.
                                 y - The y-column value.
                             error - The error column value.
                          selected - True when the data point is selected.
                               def - True when the data point is defined.
                               x1  - Multi column first column value.
                               x2  - Multi column second column
                                     value.
                               x3  - Multi column third column value.
                         To avoid interference with functions which
                         also can be used a lower/upper case
                         distinction  is made. IDL funktions should
                         be upper case.
                      Default is the entire range (="*").
           subgroup - (optional) The dataset to print. This can be
                      either the dataset name or its subgroup
                      number. Subgroup numbers can be given as an
                      array of numbers ([]) separated with ",";
                      wildcards ("*")in names are possible. Default
                      are all subgroups.
           group    - (optional) Define the data group to show.
                      Default is the current group set with
                      "chgrp". Must be in range [0..29].
Output Parameters
           Prints data as follows:
             - The number of a given data point (Num).
             - The x value of the data points (X). If there are more
               than one x dimensions the title is denoted with
               X1,X2...
             - The y value of the data points (Y).
             - The (y-) error of the data points. If no error is
               given it is displayed as "NONE" (ERROR).
             - The x bin size if defined (XBIN).
             - A flag whether the data point is defined resp. noticed
               (1) or not defined resp. ignored (0)  (DEFINED).
SETUP:
           All options may be set with the "set" command. The
           command prefix is "print".
       maxnum - Integer defining the maximum number of data points to
                print without confirmation. Default: 1000.
Side Effects
           None.
Example
               > data, "test.dat:2"
               > print, *,*,2
                 -> X   Y   ERROR
                    3   5   0.2
                    4   7   0.15
                    6   9   0.3
                    ... all data of all subgroups in group 2.
Revision History
           $Id: cafe_print.pro,v 1.18 2004/12/13 08:45:23 goehler Exp $

Last modified by pro2html on 2005 January 04 at 16:18 UTC

[Home Page] [Software, Documentation] [IDL Documentation] [Quick Reference] [Feedback]

Jörn Wilms (wilms@astro.uni-tuebingen.de)
Updated automatically