00001 //# MSAntennaGram.h: Grammar for ms antenna sub-expressions 00002 //# Copyright (C) 1998 00003 //# Associated Universities, Inc. Washington DC, USA. 00004 //# 00005 //# This library is free software; you can redistribute it and/or modify it 00006 //# under the terms of the GNU Library General Public License as published by 00007 //# the Free Software Foundation; either version 2 of the License, or (at your 00008 //# option) any later version. 00009 //# 00010 //# This library is distributed in the hope that it will be useful, but WITHOUT 00011 //# ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or 00012 //# FITNESS FOR A PARTICULAR PURPOSE. See the GNU Library General Public 00013 //# License for more details. 00014 //# 00015 //# You should have received a copy of the GNU Library General Public License 00016 //# along with this library; if not, write to the Free Software Foundation, 00017 //# Inc., 675 Massachusetts Ave, Cambridge, MA 02139, USA. 00018 //# 00019 //# Correspondence concerning AIPS++ should be addressed as follows: 00020 //# Internet email: aips2-request@nrao.edu. 00021 //# Postal address: AIPS++ Project Office 00022 //# National Radio Astronomy Observatory 00023 //# 520 Edgemont Road 00024 //# Charlottesville, VA 22903-2475 USA 00025 //# 00026 //# $Id$ 00027 00028 #ifndef MS_MSANTENNAGRAM_H 00029 #define MS_MSANTENNAGRAM_H 00030 00031 00032 //# Includes 00033 #include <casacore/casa/aips.h> 00034 #include <casacore/casa/BasicSL/String.h> 00035 #include <casacore/casa/Arrays/Matrix.h> 00036 #include <casacore/ms/MSSel/MSAntennaParse.h> // routines used by bison actions 00037 00038 namespace casacore { //# NAMESPACE CASACORE - BEGIN 00039 00040 //# Forward Declarations 00041 class MeasurementSet; 00042 class TableExprNode; 00043 00044 // <summary> 00045 // Global functions for flex/bison scanner/parser for MSAntennaGram 00046 // </summary> 00047 00048 // <use visibility=local> 00049 00050 // <reviewed reviewer="" date="" tests=""> 00051 // </reviewed> 00052 00053 // <prerequisite> 00054 //# Classes you should understand before using this one. 00055 // <li> MSAntennaGram.l and .y (flex and bison grammar) 00056 // </prerequisite> 00057 00058 // <synopsis> 00059 // Global functions are needed to define the input of the flex scanner 00060 // and to start the bison parser. 00061 // The input is taken from a string. 00062 // </synopsis> 00063 00064 // <motivation> 00065 // It is necessary to be able to give an image expression in ASCII. 00066 // This can be used in glish. 00067 // </motivation> 00068 // <todo asof="$DATE:$"> 00069 //# A List of bugs, limitations, extensions or planned refinements. 00070 // </todo> 00071 00072 00073 // <group name=MSAntennaGramFunctions> 00074 00075 // Declare the bison parser (is implemented by bison command). 00076 // It returns a TaQL expression tree. 00077 TableExprNode msAntennaGramParseCommand (MSSelectableTable& msLike, 00078 const String& command, 00079 Vector<Int>& selectedAnts1, 00080 Vector<Int>& selectedAnts2, 00081 Matrix<Int>& selectedBaselines) ; 00082 TableExprNode msAntennaGramParseCommand (MSAntennaParse* thisParser, 00083 const TableExprNode& col1TEN, 00084 const TableExprNode& col2TEN, 00085 const String& command, 00086 Vector<Int>& selectedAnts1, 00087 Vector<Int>& selectedAnts2, 00088 Matrix<Int>& selectedBaselines) ; 00089 TableExprNode msAntennaGramParseCommand (Table& subTable, 00090 TableExprNode& col1TEN, 00091 TableExprNode& col2TEN, 00092 const String& command, 00093 Vector<Int>& selectedAnts1, 00094 Vector<Int>& selectedAnts2, 00095 Matrix<Int>& selectedBaselines) ; 00096 TableExprNode msAntennaGramParseCommand (const MeasurementSet *ms, 00097 const String& command, 00098 Vector<Int>& selectedAnt1, 00099 Vector<Int>& selectedAnt2, 00100 Matrix<Int>& selectedBaselines); 00101 00102 TableExprNode baseMSAntennaGramParseCommand(MSAntennaParse* parser, const String& command, 00103 Vector<Int>& selectedAnts1, 00104 Vector<Int>& selectedAnts2, 00105 Matrix<Int>& selectedBaselines); 00106 // The yyerror function for the parser. 00107 // It throws an exception with the current token. 00108 void MSAntennaGramerror (const char*); 00109 00110 // Give the current position in the string. 00111 // This can be used when parse errors occur. 00112 Int& msAntennaGramPosition(); 00113 00114 // Declare the input routine for flex/bison. 00115 int msAntennaGramInput (char* buf, int max_size); 00116 00117 // A function to remove escaped characters. 00118 //String msAntennaGramRemoveEscapes (const String& in); 00119 00120 // A function to remove quotes from a quoted string. 00121 //String msAntennaGramRemoveQuotes (const String& in); 00122 00123 // </group> 00124 00125 } //# NAMESPACE CASACORE - END 00126 00127 #endif