1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
|
//# Converters.h: The Converters module - Boost.Python converters
//# Copyright (C) 2006
//# Associated Universities, Inc. Washington DC, USA.
//#
//# This library is free software; you can redistribute it and/or modify it
//# under the terms of the GNU Library General Public License as published by
//# the Free Software Foundation; either version 2 of the License, or (at your
//# option) any later version.
//#
//# This library is distributed in the hope that it will be useful, but WITHOUT
//# ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
//# FITNESS FOR A PARTICULAR PURPOSE. See the GNU Library General Public
//# License for more details.
//#
//# You should have received a copy of the GNU Library General Public License
//# along with this library; if not, write to the Free Software Foundation,
//# Inc., 675 Massachusetts Ave, Cambridge, MA 02139, USA.
//#
//# Correspondence concerning AIPS++ should be addressed as follows:
//# Internet email: casa-feedback@nrao.edu.
//# Postal address: AIPS++ Project Office
//# National Radio Astronomy Observatory
//# 520 Edgemont Road
//# Charlottesville, VA 22903-2475 USA
#ifndef PYRAP_CONVERTERS_H
#define PYRAP_CONVERTERS_H
//# Includes
#include <casacore/python/Converters/PycBasicData.h>
#include <casacore/python/Converters/PycRecord.h>
#include <casacore/python/Converters/PycValueHolder.h>
#include <casacore/python/Converters/PycExcp.h>
namespace casacore { //# NAMESPACE CASACORE - BEGIN
// <module>
// <summary>
// Convert Casacore objects to/from Python (using Boost.Python)
// </summary>
// <use visibility=export>
// <reviewed reviewer="" date="" tests="tConvert" demos="">
// </reviewed>
// <prerequisite>
// <li> <linkto class="Record">Record</linkto> class
// <li> <linkto class="ValueHolder">Record</linkto> class
// </prerequisite>
// <synopsis>
// Converters contains functions to convert the important Casacore objects
// to/from Python using the Boost.Python package.
// Converters for the following Casacore classes exist:
// <ul>
// <li> Scalars of basic data types like Bool, Int, Float, Complex.
// <li> casacore::String and std::string.
// <li> casacore::Vector and std::vector of any type which can be converted
// from a Python scalar, list, tuple, or 1-dim array. They are converted
// back to a Python list.
// <li> Record which is converted to/from a Python dict.
// <li> ValueHolder which is converted to/from the appropriate Python type.
// A ValueHolder is a class which can hold various value types:
// <ul>
// <li> Scalar of any basic data type.
// <li> Record.
// <li> N-dim Array of any basic data type. A casacore::Array can be
// constructed from Python types like tuple, list, and numpy array
// A Py_None object results in an empty array.
// The conversion back is done to a numpy array.
// An empty array is returned as an empty numpy array.
// <br>Because Casacore arrays are in Fortran order and numpy arrays
// (preferably) in C order, the axes are reversed during conversion.
// <br>A 1-dim <src>Array<String></src> object is converted to a list,
// while a higher dimensioned Array<String> object is converted to/from
// a dict containing the shape and the values as a list.
// However, conversion from a numpy string array is supported.
// </ul>
// A ValueHolder is for instance used by the Table System to be able
// to get or put data in a column of any type.
// It can be used by any Python binding to convert arrays. Class
// ValueHolder has functions to get or set the array.
// <li> casacore::IPosition which can be converted
// from a Python scalar, list, tuple, or 1-dim array.
// It is converted back to a Python list.
// An IPosition object represents an array shape or position, so its
// values are reversed because of the different ordening of
// Casacore and Python arrays.
// <li> Exceptions, which are mapped to a Python <src>RuntimeError</src>
// exception. Only the <src>casacore::IterError</src> exception is mapped
// to a Python <src>StopIteration</src> exception.
// </ul>
// The converts from Python to C++ can handle some special numpy objects.
// Such objects can also be contained in sequences or dicts.
// <ul>
// <li> Elements in a numpy array are called array scalars. They do not have
// a python type such as <src>int</src>, but instead a type as
// <src>numpy.int32</src>.
// The converters can handle such types and convert them correctly to
// a scalar.
// <li> A numpy scalar array (e.g. <src>array(1.0)</src> is a somewhat
// peculiar numpy object. It has an empty shape and cannot be indexed.
// It is handled correctly by the from converters and handled as a
// scalar value.
// <li> An empty numpy object (e.g. <src>array([])</src>) is handled as
// a None value.
// </ul>
// </synopsis>
// </module>
} //# NAMESPACE CASACORE - END
#endif
|
