Editing Guide to madagascar programs (section)

==sftransp==
{| class="wikitable" align="center" cellspacing="0" border="1"
! colspan="4" style="background:#ffdead;" | Transpose two axes in a dataset. 
|-
! colspan="4" | sftransp < in.rsf > out.rsf memsize=sf_memsize() plane=
|-
|  colspan="4" | <br>If you get a "Cannot allocate memory" error, give the program a<br>memsize=1 command-line parameter to force out-of-core operation.
|-
| ''int    '' || '''memsize=sf_memsize()''' ||   || 	Max amount of RAM (in Mb) to be used
|-
| ''int    '' || '''plane=''' ||   || 	Two-digit number with axes to transpose. The default is 12
|}

The <tt>sftransp</tt> program transposes the input hypercube
exchanging the two axes specified by the <tt>plane=</tt> parameter. 
<pre>
bash&#36; sfspike n1=10 n2=20 n3=30 > orig123.rsf
bash&#36; sfin orig123.rsf 
orig123.rsf:
    in="/var/tmp/orig123.rsf@"
    esize=4 type=float form=native 
    n1=10          d1=0.004       o1=0          label1="Time" unit1="s" 
    n2=20          d2=0.1         o2=0          label2="Distance" unit2="km" 
    n3=30          d3=0.1         o3=0          label3="Distance" unit3="km" 
        6000 elements 24000 bytes
bash&#36; <orig123.rsf sftransp plane=23 >out132.rsf
bash&#36; sfin out132.rsf 
out132.rsf:
    in="/var/tmp/out132.rsf@"
    esize=4 type=float form=native 
    n1=10          d1=0.004       o1=0          label1="Time" unit1="s" 
    n2=30          d2=0.1         o2=0          label2="Distance" unit2="km" 
    n3=20          d3=0.1         o3=0          label3="Distance" unit3="km" 
        6000 elements 24000 bytes
bash&#36; <orig123.rsf sftransp plane=13 >out321.rsf
bash&#36; sfin out321.rsf 
out321.rsf:
    in="/var/tmp/out132.rsf@"
    esize=4 type=float form=native 
    n1=30          d1=0.1         o1=0          label1="Distance" unit1="km" 
    n2=20          d2=0.1         o2=0          label2="Distance" unit2="km" 
    n3=10          d3=0.004       o3=0          label3="Time" unit3="s" 
        6000 elements 24000 bytes
</pre>
<tt>sftransp</tt> tries to fit the dataset in memory to transpose it
there but, if not enough memory is available, it performs a slower
transpose out of core using disk operations. You can control the
amount of available memory using the <tt>memsize=</tt> parameter or
the <tt>RSFMEMSIZE</tt> environmental variable.