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
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
|
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<!--Converted with LaTeX2HTML 2002-2-1 (1.70)
original version by: Nikos Drakos, CBLU, University of Leeds
* revised and updated by: Marcus Hennecke, Ross Moore, Herb Swan
* with significant contributions from:
Jens Lippmann, Marek Rouchal, Martin Wilck and others -->
<HTML>
<HEAD>
<TITLE>Arrays</TITLE>
<META NAME="description" CONTENT="Arrays">
<META NAME="keywords" CONTENT="users_guide">
<META NAME="resource-type" CONTENT="document">
<META NAME="distribution" CONTENT="global">
<META NAME="Generator" CONTENT="LaTeX2HTML v2002-2-1">
<META HTTP-EQUIV="Content-Style-Type" CONTENT="text/css">
<LINK REL="STYLESHEET" HREF="users_guide.css">
<LINK REL="next" HREF="node100.html">
<LINK REL="previous" HREF="node54.html">
<LINK REL="up" HREF="node47.html">
<LINK REL="next" HREF="node60.html">
</HEAD>
<BODY >
<DIV CLASS="navigation"><!--Navigation Panel-->
<A NAME="tex2html1498"
HREF="node60.html">
<IMG WIDTH="37" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="next" SRC="next.png"></A>
<A NAME="tex2html1492"
HREF="node47.html">
<IMG WIDTH="26" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="up" SRC="up.png"></A>
<A NAME="tex2html1486"
HREF="node58.html">
<IMG WIDTH="63" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="previous" SRC="prev.png"></A>
<A NAME="tex2html1494"
HREF="node14.html">
<IMG WIDTH="65" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="contents" SRC="contents.png"></A>
<A NAME="tex2html1496"
HREF="node317.html">
<IMG WIDTH="43" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="index" SRC="index.png"></A>
<BR>
<B> Next:</B> <A NAME="tex2html1499"
HREF="node60.html">R-arrays</A>
<B> Up:</B> <A NAME="tex2html1493"
HREF="node47.html">SIDL Basics</A>
<B> Previous:</B> <A NAME="tex2html1487"
HREF="node58.html">Enumerations</A>
<B> <A NAME="tex2html1495"
HREF="node14.html">Contents</A></B>
<B> <A NAME="tex2html1497"
HREF="node317.html">Index</A></B>
<BR>
<BR></DIV>
<!--End of Navigation Panel-->
<H1><A NAME="SECTION02440000000000000000"></A><A NAME="s:arrays"></A>
<BR>
Arrays
</H1>
<P>
One of the features that separates SIDL and BABEL from Microsoft's
COM/DCOM<A NAME="2591"></A> and the OMG's CORBA<A NAME="2592"></A> is support for multi-dimensional
arrays. SIDL is designed to serve the high performance computing
community, so we anticipate that both SIDL object developers and
object clients may require direct access to the underlying array data
structure to try to optimize instruction pipelining or cache
performance. The purpose of this document is to describe the
functional API to the SIDL array data structure and the underlying
data structures. This presentation will focus on the C API for arrays
because it is the basis for the other language APIs, so they will
likely reflect its idiosyncrasies.
<P>
There are two main kinds of arrays in SIDL: normal arrays and
r-arrays. R-arrays are a specialized form of array for numeric types
that has a simpler interface from C, C++, FORTRAN 77 and FOTRAN
90. Normal arrays are used for all SIDL types.
<P>
The SIDL array API and data structure can be used in client code to
prepare argument for passing to a SIDL method, and it is used inside
the implementation code to get data and meta-data from incoming
arguments.
<P>
Normal SIDL arrays can be ``row-major''<A NAME="2593"></A>
or<A NAME="2594"></A> ``column-major''<A NAME="2595"></A>.
They are not parallel array classes, and not particularly
sophisticated, but they are very, very general. These are meant to
generalize the array types built into many languages, not to provide a
general array component that everyone will use. It is expected for
parallel array libraries to build on top of the array type presented
into SIDL.
<P>
<BR><HR>
<!--Table of Child-Links-->
<A NAME="CHILD_LINKS"><STRONG>Subsections</STRONG></A>
<UL CLASS="ChildLinks">
<LI><A NAME="tex2html1500"
HREF="node60.html">R-arrays</A>
<LI><A NAME="tex2html1501"
HREF="node61.html">SIDL Language Features</A>
<LI><A NAME="tex2html1502"
HREF="node62.html">Independent and borrowed arrays</A>
<LI><A NAME="tex2html1503"
HREF="node63.html">The Life of an Array</A>
<LI><A NAME="tex2html1504"
HREF="node64.html">The Language Bindings</A>
<LI><A NAME="tex2html1505"
HREF="node65.html">The Array API</A>
<UL>
<LI><A NAME="tex2html1506"
HREF="node66.html">Function: createCol</A>
<LI><A NAME="tex2html1507"
HREF="node67.html">Function: createRow</A>
<LI><A NAME="tex2html1508"
HREF="node68.html">Function: create1d</A>
<LI><A NAME="tex2html1509"
HREF="node69.html">Function: create2dCol</A>
<LI><A NAME="tex2html1510"
HREF="node70.html">Function: create2dRow</A>
<LI><A NAME="tex2html1511"
HREF="node71.html">Function: slice</A>
<LI><A NAME="tex2html1512"
HREF="node72.html">Function: borrow</A>
<LI><A NAME="tex2html1513"
HREF="node73.html">Function: smartCopy</A>
<LI><A NAME="tex2html1514"
HREF="node74.html">Function: addRef</A>
<LI><A NAME="tex2html1515"
HREF="node75.html">Function: deleteRef</A>
<LI><A NAME="tex2html1516"
HREF="node76.html">Function: get1</A>
<LI><A NAME="tex2html1517"
HREF="node77.html">Function: get2</A>
<LI><A NAME="tex2html1518"
HREF="node78.html">Function: get3</A>
<LI><A NAME="tex2html1519"
HREF="node79.html">Function: get4</A>
<LI><A NAME="tex2html1520"
HREF="node80.html">Function: get5-7</A>
<LI><A NAME="tex2html1521"
HREF="node81.html">Function: get</A>
<LI><A NAME="tex2html1522"
HREF="node82.html">Function: set1</A>
<LI><A NAME="tex2html1523"
HREF="node83.html">Function: set2</A>
<LI><A NAME="tex2html1524"
HREF="node84.html">Function: set3</A>
<LI><A NAME="tex2html1525"
HREF="node85.html">Function: set4</A>
<LI><A NAME="tex2html1526"
HREF="node86.html">Function: set5-7</A>
<LI><A NAME="tex2html1527"
HREF="node87.html">Function: set</A>
<LI><A NAME="tex2html1528"
HREF="node88.html">Function: dimen</A>
<LI><A NAME="tex2html1529"
HREF="node89.html">Function: lower</A>
<LI><A NAME="tex2html1530"
HREF="node90.html">Function: upper</A>
<LI><A NAME="tex2html1531"
HREF="node91.html">Function: stride</A>
<LI><A NAME="tex2html1532"
HREF="node92.html">Function: length</A>
<LI><A NAME="tex2html1533"
HREF="node93.html">Function: isColumnOrder</A>
<LI><A NAME="tex2html1534"
HREF="node94.html">Function: isRowOrder</A>
<LI><A NAME="tex2html1535"
HREF="node95.html">Function: copy</A>
<LI><A NAME="tex2html1536"
HREF="node96.html">Function: ensure</A>
<LI><A NAME="tex2html1537"
HREF="node97.html">Function: first</A>
</UL>
<BR>
<LI><A NAME="tex2html1538"
HREF="node98.html">The C Macro API</A>
<LI><A NAME="tex2html1539"
HREF="node99.html">The C Data Structure</A>
</UL>
<!--End of Table of Child-Links-->
<DIV CLASS="navigation"><HR>
<!--Navigation Panel-->
<A NAME="tex2html1498"
HREF="node60.html">
<IMG WIDTH="37" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="next" SRC="next.png"></A>
<A NAME="tex2html1492"
HREF="node47.html">
<IMG WIDTH="26" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="up" SRC="up.png"></A>
<A NAME="tex2html1486"
HREF="node58.html">
<IMG WIDTH="63" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="previous" SRC="prev.png"></A>
<A NAME="tex2html1494"
HREF="node14.html">
<IMG WIDTH="65" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="contents" SRC="contents.png"></A>
<A NAME="tex2html1496"
HREF="node317.html">
<IMG WIDTH="43" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="index" SRC="index.png"></A>
<BR>
<B> Next:</B> <A NAME="tex2html1499"
HREF="node60.html">R-arrays</A>
<B> Up:</B> <A NAME="tex2html1493"
HREF="node47.html">SIDL Basics</A>
<B> Previous:</B> <A NAME="tex2html1487"
HREF="node58.html">Enumerations</A>
<B> <A NAME="tex2html1495"
HREF="node14.html">Contents</A></B>
<B> <A NAME="tex2html1497"
HREF="node317.html">Index</A></B> </DIV>
<!--End of Navigation Panel-->
<ADDRESS>
<br><br>babel-0.10.2<br>users_guide Last Modified 2005-03-23<br><br><a href="http://www.llnl.gov/CASC/components">http://www.llnl.gov/CASC/components</a><br><a href="mailto:components@llnl.gov">components@llnl.gov</a>
</ADDRESS>
</BODY>
</HTML>
|
