[AIT logo]

Institut für Astronomie und Astrophysik

Abteilung Astronomie

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


unselect Source code in cafe_unselect.pro

unselect

Name
           unselect
Purpose
           unselect data points
Category
           cafe
SYNTAX:
           unselect, range [,subgroup][,group]
Input Parameters
           range    - Defines range of data points to un-select. 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.
                         If no range is given all data points are
                         selected.
Example
                               > unselect, 2
                                -> unselect data point 2 (the 3-rd)
                               > unselect, 5-22
                                -> unselect data points 5..22 (starting from 0)
                               > unselect 46-*
                                -> unselect all data points upwards from point 47.
                               > unselect, 2.2-5.7
                                -> unselect all data points from x=2.2 to 5.7
                               > unselect, *-0.2
                                -> unselect all data points up to x=0.2
                               > unselect, 0.5-0.2
                                -> unselect all data points except those in 0.2..0.5.
                               > unselect, y lt 0.5
                                 -> unselect all data points with Y-values less than 0.5.
           subgroup - (optional) The data set (subgroup) which should
                      be unseleted. This can be either the
                      subgroup number or the file name representing
                      the data set. It is possible to consider more than
                      one subgroup, either with numbers in brackets
                      ([]), separated with ","; or denoting filenames
                      with wildcards ("*").
                      Default is the first subgroup in current used
                      group.
           group    - (optional) The data group for which the model
                      should be applied.
                      The default can be set with chgrp. Group must be in
                      range [0..29].
Side Effects
           Changes information about data points used for
           fitting. Data points are not excluded.
Example
               > unselect, 0.2-7.5, "test.dat", 3
                 -> unselect all x values between 0.2 and 7.5 from
                 group 3, subgroup represented by file "test.dat"
Revision History
           $Id: cafe_unselect.pro,v 1.12 2004/05/27 09:10:51 goehler Exp $

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

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

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