Recent changes to PnumpyExample

PnumpyExample modified by Alexander Pletzer

Alexander Pletzer — Tue, 04 Feb 2014 00:54:19 -0000

--- v9
+++ v10
@@ -45,16 +45,15 @@

 The following method can be used to access remote data 

-    # access window defined using the expose method
+    # use the key form the expose method to access the halo on a different process
     remoteData = da.get(remoteRank, winID='n')

 or

-    # ghosted array take a tuple as winID
+    # ghosted array takes a tuple as winID
     remoteData = da.get(remoteRank, winID=(1,0))
+
+Note that for ghosted distributed arrays, the key to the window is a tuple with elements -1, 0, or 1. The value -1 refers to the low end of the variable, +1 to the high end, and 0 indicates variation along this index. 

-
-
-

PnumpyExample modified by Alexander Pletzer

Alexander Pletzer — Mon, 03 Feb 2014 21:12:50 -0000

--- v8
+++ v9
@@ -35,7 +35,7 @@

 Use a ghosted distributed array if you want to expose the boundary of the array, otherwise also known as the halo. The thickness of the halo can be prescribed.

-    da = pnumpy.gaZeros( (2,3), numpy.float32, ghostWidth=1 )
+    da = pnumpy.ghZeros( (2,3), numpy.float32, ghostWidth=1 )

 This will expose one ghost along the north, south, east, and west sides of the array. The `winID` for these parts are `(1,0), (-1,0), (0,1),` and `(0,-1)` respectively.

PnumpyExample modified by Alexander Pletzer

Alexander Pletzer — Mon, 03 Feb 2014 12:57:16 -0000

--- v7
+++ v8
@@ -45,13 +45,13 @@

 The following method can be used to access remote data 

-     # access window defined using the expose method
-     remoteData = da.get(remoteRank, winID='n')
+    # access window defined using the expose method
+    remoteData = da.get(remoteRank, winID='n')

 or

-     # ghosted array take a tuple as winID
-     remoteData = da.get(remoteRank, winID=(1,0))
+    # ghosted array take a tuple as winID
+    remoteData = da.get(remoteRank, winID=(1,0))

PnumpyExample modified by Alexander Pletzer

Alexander Pletzer — Mon, 03 Feb 2014 12:56:16 -0000

--- v6
+++ v7
@@ -22,8 +22,8 @@
     north = ( slice(-1, None, None), slice(0, None, None) )
     da.expose( slce=north, winID='n' )

-    # set the data 
-    da[:] = rk
+    # set the data to the rank value
+    da[:] = rk 

     # free the data
     da.free()
@@ -45,15 +45,16 @@

 The following method can be used to access remote data 

-     remoteData = da.get(remoteRank, winId='n')
+     # access window defined using the expose method
+     remoteData = da.get(remoteRank, winID='n')

 or

-     remoteData = da.get(remoteRank, winId=(1,0)) # access north side of remoteRank data
+     # ghosted array take a tuple as winID
+     remoteData = da.get(remoteRank, winID=(1,0))

-

PnumpyExample modified by Alexander Pletzer

Alexander Pletzer — Mon, 03 Feb 2014 08:56:55 -0000

--- v5
+++ v6
@@ -35,9 +35,25 @@

 Use a ghosted distributed array if you want to expose the boundary of the array, otherwise also known as the halo. The thickness of the halo can be prescribed.

-    ga = pnumpy.gaZeros( (2,3), numpy.float32, ghostWidth=1 )
+    da = pnumpy.gaZeros( (2,3), numpy.float32, ghostWidth=1 )

-This will expose one ghost along the north, south, east, and west sides of the array. 
+This will expose one ghost along the north, south, east, and west sides of the array. The `winID` for these parts are `(1,0), (-1,0), (0,1),` and `(0,-1)` respectively.
+
+
+Accessing remote data
+---------------------
+
+The following method can be used to access remote data 
+
+     remoteData = da.get(remoteRank, winId='n')
+
+or
+
+     remoteData = da.get(remoteRank, winId=(1,0)) # access north side of remoteRank data

+
+
+
+

PnumpyExample modified by Alexander Pletzer

Alexander Pletzer — Mon, 03 Feb 2014 08:49:26 -0000

PnumpyExample modified by Alexander Pletzer

Alexander Pletzer — Mon, 03 Feb 2014 08:49:26 -0000

--- v3
+++ v4
@@ -3,9 +3,9 @@

 All examples require you to import 

-```
+
     import pnumpy
-```
+

 Distributed array
 -----------------
@@ -18,7 +18,7 @@
     rk = da.rk
     nprocs = da.sz

-    # expose the high end of the first index (-1)
+    # expose the high end of the first index (-1 refers to last index in python)
     north = ( slice(-1, None, None), slice(0, None, None) )
     da.expose( slce=north, winID='n' )

@@ -27,3 +27,17 @@

     # free the data
     da.free()
+
+You can expose as many parts as you want. The number of slices should match the number if indices in the array. slice(0, None, None) refers to 0:-1 with a stride of one. 
+
+Ghosted distributed array
+-------------------------
+
+Use a ghosted distributed array if you want to expose the boundary of the array, otherwise also known as the halo. The thickness of the halo can be prescribed.
+
+    ga = pnumpy.gaZeros( (2,3), numpy.float32, ghostWidth=1 )
+
+This will expose one ghost along the north, south, east, and west sides of the array. 
+
+
+

PnumpyExample modified by Alexander Pletzer

Alexander Pletzer — Mon, 03 Feb 2014 08:42:27 -0000

--- v2
+++ v3
@@ -2,30 +2,28 @@
 ===============

 All examples require you to import 
-`
-import pnumpy
-`
+
+```
+    import pnumpy
+```

 Distributed array
 -----------------

 Use this class if you want the flexibility to expose any parts of your array to other processes. 

-`
-# create dist array and fill with zeros
-da = pnumpy.daZeros( (2,3), numpy.float32 )
+    # create dist array and fill with zeros
+    da = pnumpy.daZeros( (2,3), numpy.float32 )
+    # processor rank and number of processes
+    rk = da.rk
+    nprocs = da.sz

-# processor rank and number of processes
-rk = da.rk
-nprocs = da.sz
+    # expose the high end of the first index (-1)
+    north = ( slice(-1, None, None), slice(0, None, None) )
+    da.expose( slce=north, winID='n' )

-# expose the high end of the first index (-1), extending across the array (0...
-north = ( slice(-1, None, None), slice(0, None, None) )
-da.expose( slce=north, winID='n' )
+    # set the data 
+    da[:] = rk

-# set the data 
-da[:] = rk
-
-# free the data
-da.free()
-`
+    # free the data
+    da.free()

PnumpyExample modified by Alexander Pletzer

Alexander Pletzer — Mon, 03 Feb 2014 08:19:54 -0000

--- v1
+++ v2
@@ -2,7 +2,30 @@
 ===============

 All examples require you to import 
-{{{
+`
 import pnumpy
-}}}
+`

+Distributed array
+-----------------
+
+Use this class if you want the flexibility to expose any parts of your array to other processes. 
+
+`
+# create dist array and fill with zeros
+da = pnumpy.daZeros( (2,3), numpy.float32 )
+
+# processor rank and number of processes
+rk = da.rk
+nprocs = da.sz
+
+# expose the high end of the first index (-1), extending across the array (0...
+north = ( slice(-1, None, None), slice(0, None, None) )
+da.expose( slce=north, winID='n' )
+
+# set the data 
+da[:] = rk
+
+# free the data
+da.free()
+`

PnumpyExample modified by Alexander Pletzer

Alexander Pletzer — Mon, 03 Feb 2014 08:07:03 -0000

pnumpy examples

All examples require you to import
{{{
import pnumpy
}}}