Editing Guide to madagascar programs (section)

==sfspray==
{| class="wikitable" align="center" cellspacing="0" border="1"
! colspan="4" style="background:#ffdead;" | Extend a dataset by duplicating in the specified axis dimension.
|-
! colspan="4" | sfspray < in.rsf > out.rsf axis=2 n= d= o= label= unit=
|-
|  colspan="4" |    This operation is adjoint to sfstack.
|-
| ''int    '' || '''axis=2''' ||   || 	which axis to spray
|-
| ''float  '' || '''d=''' ||   || 	Sampling of the newly created dimension
|-
| ''string '' || '''label=''' ||   || 	Label of the newly created dimension
|-
| ''int    '' || '''n=''' ||   || 	Size of the newly created dimension
|-
| ''float  '' || '''o=''' ||   || 	Origin of the newly created dimension
|-
| ''string '' || '''unit=''' ||   || 	Units of the newly created dimension
|}

<tt>sfspray</tt> extends the input hypercube by replicating the data
in one of the dimensions. The output dataset acquires one additional
dimension. Here is an example:
Start with a 2-D dataset
<pre>
bash&#36; sfmath n1=5 n2=2 output=x1+x2 > test.rsf
bash&#36; sfin test.rsf
test.rsf:
    in="/var/tmp/test.rsf@"
    esize=4 type=float form=native 
    n1=5           d1=1           o1=0          
    n2=2           d2=1           o2=0          
        10 elements 40 bytes
bash&#36; < test.rsf sfdisfil
   0:             0            1            2            3            4
   5:             1            2            3            4            5
</pre>
Extend the data in the second dimension
<pre>
bash&#36; < test.rsf sfspray axis=2 n=3 > test2.rsf
bash&#36; sfin test2.rsf
test2.rsf:
    in="/var/tmp/test2.rsf@"
    esize=4 type=float form=native 
    n1=5           d1=1           o1=0          
    n2=3           d2=1           o2=0          
    n3=2           d3=1           o3=0          
        30 elements 120 bytes
bash&#36; < test2.rsf sfdisfil
   0:             0            1            2            3            4
   5:             0            1            2            3            4
  10:             0            1            2            3            4
  15:             1            2            3            4            5
  20:             1            2            3            4            5
  25:             1            2            3            4            5
</pre>
The output is three-dimensional, with traces from the original
data duplicated along the second axis.
Extend the data in the third dimension
<pre>
bash&#36; < test.rsf sfspray axis=3 n=2 > test3.rsf
bash&#36; sfin test3.rsf
test3.rsf:
    in="/var/tmp/test3.rsf@"
    esize=4 type=float form=native 
    n1=5           d1=1           o1=0          
    n2=2           d2=1           o2=0          
    n3=2           d3=?           o3=?          
        20 elements 80 bytes
bash&#36; < test3.rsf sfdisfil
   0:             0            1            2            3            4
   5:             1            2            3            4            5
  10:             0            1            2            3            4
  15:             1            2            3            4            5
</pre>
The output is also three-dimensional, with the original data replicated
along the third axis.