casacore
ImageOpener.h
Go to the documentation of this file.
1 //# ImageOpener.h: A class with static functions to open an image of any type
2 //# Copyright (C) 2005
3 //# Associated Universities, Inc. Washington DC, USA.
4 //#
5 //# This library is free software; you can redistribute it and/or modify it
6 //# under the terms of the GNU Library General Public License as published by
7 //# the Free Software Foundation; either version 2 of the License, or (at your
8 //# option) any later version.
9 //#
10 //# This library is distributed in the hope that it will be useful, but WITHOUT
11 //# ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
12 //# FITNESS FOR A PARTICULAR PURPOSE. See the GNU Library General Public
13 //# License for more details.
14 //#
15 //# You should have received a copy of the GNU Library General Public License
16 //# along with this library; if not, write to the Free Software Foundation,
17 //# Inc., 675 Massachusetts Ave, Cambridge, MA 02139, USA.
18 //#
19 //# Correspondence concerning AIPS++ should be addressed as follows:
20 //# Internet email: aips2-request@nrao.edu.
21 //# Postal address: AIPS++ Project Office
22 //# National Radio Astronomy Observatory
23 //# 520 Edgemont Road
24 //# Charlottesville, VA 22903-2475 USA
25 //#
26 //#
27 //# $Id$
28 
29 #ifndef IMAGES_IMAGEOPENER_H
30 #define IMAGES_IMAGEOPENER_H
31 
32 
33 #include <casacore/casa/aips.h>
34 #include <casacore/images/Images/MaskSpecifier.h>
35 #include <casacore/casa/Containers/SimOrdMap.h>
36 
37 namespace casacore { //# NAMESPACE CASACORE - BEGIN
38 
39 //# Forward Declarations
40 class LatticeBase;
41 class LatticeExprNode;
42 
43 // <summary>
44 // Definition of image types and handlers
45 // </summary>
46 //
47 // <use visibility=local>
48 //
49 // <reviewed reviewer="" date="yyyy/mm/dd" tests="" demos="">
50 // </reviewed>
51 //
52 // <synopsis>
53 // The class contains defines the possible image types.
54 // It contains a registry containing functions to construct an image
55 // based on its type. In this way any image can be used in the image package
56 // without the need that the code must reside in the images package.
57 // </synopsis>
58 //
59 // <motivation>
60 // FITS and MIRIAD needed to be moved out of the images package.
61 // </motivation>
62 
63 
65 {
66 public:
67 // Define the possible image types.
68  enum ImageTypes {
69  // Casacore (former AIPS++)
71  // FITS
73  // Miriad
75  // Gipsy
77  // Classic AIPS
79  // Newstar
81  // HDF5
83  // ImageConcat
85  // ImageExpr
87  // Unknown
89  };
90 
91  // Return the type of an image with the given name. Will throw an
92  // exception if file does not exist.
93  static ImageTypes imageType (const String& fileName);
94 
95  // Define the signature of a function opening an image.
96  // Each basic image class (like FITSImage) must have a static open function
97  // with this signature.
98  // They can be registered using registerOpenImageFunction.
99  // In this way a function like openImage can create any image object
100  // without the need that all image classes are in the images package.
101  // The LogIO object can be used for possible error reporting or logging.
102  typedef LatticeBase* OpenImageFunction (const String& fileName,
103  const MaskSpecifier&);
104 
105  // Register an openImageFunction.
107 
108  // Open an image in the file/table with the given name.
109  // The specified mask will be applied (default is default mask).
110  // A null pointer is returned for an unknown image type.
111  // Non-Casacore image types must have been registered to be known.
112  // Note that class ImageProxy has a function to open an image from a file
113  // or from an image expression.
114  static LatticeBase* openImage (const String& fileName,
115  const MaskSpecifier& = MaskSpecifier());
116 
117  // Open a Casacore paged image of any data type.
118  static LatticeBase* openPagedImage (const String& fileName,
119  const MaskSpecifier& = MaskSpecifier());
120 
121  // Open an HDF5 paged image of any data type.
122  static LatticeBase* openHDF5Image (const String& fileName,
123  const MaskSpecifier& = MaskSpecifier());
124 
125  // Open a persistent image concatenation of any type.
126  static LatticeBase* openImageConcat (const String& fileName);
127 
128  // Open a persistent image expression of any type.
129  // It reads the file written by ImageExpr::save.
130  static LatticeBase* openImageExpr (const String& fileName);
131 
132  // Parse an image expression and return the ImageExpr<T> object for it.
133  // The block of nodes represents optional $i arguments in the expression.
134  static LatticeBase* openExpr (const String& expr,
135  const Block<LatticeExprNode>& nodes,
136  const String& fileName = String());
137 
138 private:
139  // The default openImage function for an unknown image type.
140  // It returns a null pointer.
141  static LatticeBase* unknownImageOpen (const String& name,
142  const MaskSpecifier&);
143 
144  // Mapping of the image type to an openImage function.
146 };
147 
148 
149 } //# NAMESPACE CASACORE - END
150 
151 #endif
LatticeBase * OpenImageFunction(const String &fileName, const MaskSpecifier &)
Define the signature of a function opening an image.
Definition: ImageOpener.h:102
static LatticeBase * openImage(const String &fileName, const MaskSpecifier &=MaskSpecifier())
Open an image in the file/table with the given name.
static ImageTypes imageType(const String &fileName)
Return the type of an image with the given name.
static LatticeBase * openExpr(const String &expr, const Block< LatticeExprNode > &nodes, const String &fileName=String())
Parse an image expression and return the ImageExpr<T> object for it.
static LatticeBase * openImageConcat(const String &fileName)
Open a persistent image concatenation of any type.
A non-templated, abstract base class for array-like objects.
Definition: LatticeBase.h:80
static LatticeBase * unknownImageOpen(const String &name, const MaskSpecifier &)
The default openImage function for an unknown image type.
Simple map with keys ordered.
Definition: SimOrdMap.h:69
Class to specify which mask to use in an image.
Definition: MaskSpecifier.h:69
ImageTypes
Define the possible image types.
Definition: ImageOpener.h:68
Definition of image types and handlers.
Definition: ImageOpener.h:64
static void registerOpenImageFunction(ImageTypes, OpenImageFunction *)
Register an openImageFunction.
simple 1-D array
Definition: ArrayIO.h:47
Casacore (former AIPS++)
Definition: ImageOpener.h:70
String: the storage and methods of handling collections of characters.
Definition: String.h:223
static LatticeBase * openHDF5Image(const String &fileName, const MaskSpecifier &=MaskSpecifier())
Open an HDF5 paged image of any data type.
static LatticeBase * openImageExpr(const String &fileName)
Open a persistent image expression of any type.
this file contains all the compiler specific defines
Definition: mainpage.dox:28
static LatticeBase * openPagedImage(const String &fileName, const MaskSpecifier &=MaskSpecifier())
Open a Casacore paged image of any data type.
static SimpleOrderedMap< ImageTypes, OpenImageFunction * > theirOpenFuncMap
Mapping of the image type to an openImage function.
Definition: ImageOpener.h:145