summaryrefslogtreecommitdiff
path: root/numpy/f2py/doc
diff options
context:
space:
mode:
authorCharles Harris <charlesr.harris@gmail.com>2013-08-18 11:16:06 -0600
committerCharles Harris <charlesr.harris@gmail.com>2013-08-18 11:20:45 -0600
commit8ddb0ce0acafe75d78df528b4d2540dfbf4b364d (patch)
tree156b23f48f14c7c1df699874007c521b5482d1a4 /numpy/f2py/doc
parent13b0b272f764c14bc4ac34f5b19fd030d9c611a4 (diff)
downloadnumpy-8ddb0ce0acafe75d78df528b4d2540dfbf4b364d.tar.gz
STY: Giant whitespace cleanup.
Now is as good a time as any with open PR's at a low.
Diffstat (limited to 'numpy/f2py/doc')
-rw-r--r--numpy/f2py/doc/Release-2.x.txt6
-rw-r--r--numpy/f2py/doc/Release-3.x.txt10
-rw-r--r--numpy/f2py/doc/Release-4.x.txt10
-rw-r--r--numpy/f2py/doc/f2python9-final/README.txt4
-rw-r--r--numpy/f2py/doc/f2python9-final/src/examples/exp1mess.txt2
-rw-r--r--numpy/f2py/doc/f2python9-final/src/examples/exp1session.txt2
-rw-r--r--numpy/f2py/doc/multiarray/array_from_pyobj.c4
-rw-r--r--numpy/f2py/doc/multiarray/fortran_array_from_pyobj.txt6
-rw-r--r--numpy/f2py/doc/multiarray/transpose.txt97
-rw-r--r--numpy/f2py/doc/multiarrays.txt3
-rw-r--r--numpy/f2py/doc/using_F_compiler.txt8
11 files changed, 75 insertions, 77 deletions
diff --git a/numpy/f2py/doc/Release-2.x.txt b/numpy/f2py/doc/Release-2.x.txt
index 807eb0ca8..2085cb1be 100644
--- a/numpy/f2py/doc/Release-2.x.txt
+++ b/numpy/f2py/doc/Release-2.x.txt
@@ -14,13 +14,13 @@ C expertise is required for using this tool.
Features include:
*** All basic Fortran types are supported:
- integer[ | *1 | *2 | *4 | *8 ], logical[ | *1 | *2 | *4 | *8 ],
+ integer[ | *1 | *2 | *4 | *8 ], logical[ | *1 | *2 | *4 | *8 ],
character[ | *(*) | *1 | *2 | *3 | ... ]
real[ | *4 | *8 | *16 ], double precision,
complex[ | *8 | *16 | *32 ]
*** Multi-dimensional arrays of (almost) all basic types.
- Dimension specifications:
+ Dimension specifications:
<dim> | <start>:<end> | * | :
*** Supported attributes:
@@ -63,7 +63,7 @@ Features include:
*** f2py users list is available for support, feedback, etc.
-More information about f2py, see
+More information about f2py, see
http://cens.ioc.ee/projects/f2py2e/
diff --git a/numpy/f2py/doc/Release-3.x.txt b/numpy/f2py/doc/Release-3.x.txt
index 940771015..ddb93b9fd 100644
--- a/numpy/f2py/doc/Release-3.x.txt
+++ b/numpy/f2py/doc/Release-3.x.txt
@@ -14,13 +14,13 @@ C expertise is required for using this tool.
Features include:
*** All basic Fortran types are supported:
- integer[ | *1 | *2 | *4 | *8 ], logical[ | *1 | *2 | *4 | *8 ],
+ integer[ | *1 | *2 | *4 | *8 ], logical[ | *1 | *2 | *4 | *8 ],
character[ | *(*) | *1 | *2 | *3 | ... ]
real[ | *4 | *8 | *16 ], double precision,
complex[ | *8 | *16 | *32 ]
*** Multi-dimensional arrays of (almost) all basic types.
- Dimension specifications:
+ Dimension specifications:
<dim> | <start>:<end> | * | :
*** Supported attributes and statements:
@@ -33,7 +33,7 @@ Features include:
NEW: intent(c), threadsafe, fortranname
*** Calling Fortran 77/90/95 subroutines and functions. Also
- Fortran 90/95 module subroutines are supported. Internal
+ Fortran 90/95 module subroutines are supported. Internal
initialization of optional arguments.
*** Accessing COMMON blocks from Python.
@@ -55,7 +55,7 @@ NEW: Accessing Fortran 90/95 module data.
dependencies, etc.
NEW: * Automatically generates setup_<modulename>.py for building
- extension modules using tools from distutils and
+ extension modules using tools from distutils and
fortran_support module (SciPy).
*** Automatically generates Makefile for compiling Fortran and C
@@ -72,7 +72,7 @@ NEW: * Installation with distutils.
*** And finally, many bugs are fixed.
-More information about f2py, see
+More information about f2py, see
http://cens.ioc.ee/projects/f2py2e/
diff --git a/numpy/f2py/doc/Release-4.x.txt b/numpy/f2py/doc/Release-4.x.txt
index ed071a0cb..d490dcb7a 100644
--- a/numpy/f2py/doc/Release-4.x.txt
+++ b/numpy/f2py/doc/Release-4.x.txt
@@ -18,13 +18,13 @@ New features:
Features include:
*** All basic Fortran types are supported:
- integer[ | *1 | *2 | *4 | *8 ], logical[ | *1 | *2 | *4 | *8 ],
+ integer[ | *1 | *2 | *4 | *8 ], logical[ | *1 | *2 | *4 | *8 ],
character[ | *(*) | *1 | *2 | *3 | ... ]
real[ | *4 | *8 | *16 ], double precision,
complex[ | *8 | *16 | *32 ]
*** Multi-dimensional arrays of (almost) all basic types.
- Dimension specifications:
+ Dimension specifications:
<dim> | <start>:<end> | * | :
*** Supported attributes and statements:
@@ -37,7 +37,7 @@ Features include:
intent(c), threadsafe, fortranname
*** Calling Fortran 77/90/95 subroutines and functions. Also
- Fortran 90/95 module subroutines are supported. Internal
+ Fortran 90/95 module subroutines are supported. Internal
initialization of optional arguments.
*** Accessing COMMON blocks from Python.
@@ -59,7 +59,7 @@ Features include:
dependencies, etc.
*** Automatically generates setup_<modulename>.py for building
- extension modules using tools from distutils and
+ extension modules using tools from distutils and
fortran_support module (SciPy).
*** Automatically generates Makefile for compiling Fortran and C
@@ -76,7 +76,7 @@ Features include:
*** And finally, many bugs are fixed.
-More information about f2py, see
+More information about f2py, see
http://cens.ioc.ee/projects/f2py2e/
diff --git a/numpy/f2py/doc/f2python9-final/README.txt b/numpy/f2py/doc/f2python9-final/README.txt
index b907216b6..2ce8e393a 100644
--- a/numpy/f2py/doc/f2python9-final/README.txt
+++ b/numpy/f2py/doc/f2python9-final/README.txt
@@ -23,9 +23,9 @@ Note that this file includes the following JPG images
PS:
The HTML file f2python9.html is generated using TTH (http://hutchinson.belmont.ma.us/tth/)
-from the LaTeX source file `python9.tex'. The source can be found in the
+from the LaTeX source file `python9.tex'. The source can be found in the
src/
-directory. This directory contains also the following EPS files
+directory. This directory contains also the following EPS files
flow.eps
structure.eps
aerostructure.eps
diff --git a/numpy/f2py/doc/f2python9-final/src/examples/exp1mess.txt b/numpy/f2py/doc/f2python9-final/src/examples/exp1mess.txt
index ae1545718..d4188a91b 100644
--- a/numpy/f2py/doc/f2python9-final/src/examples/exp1mess.txt
+++ b/numpy/f2py/doc/f2python9-final/src/examples/exp1mess.txt
@@ -13,5 +13,5 @@ Building modules...
l,u = exp1([n])
Wrote C/API module "foo" to file "foomodule.c"
Documentation is saved to file "foomodule.tex"
-Run GNU make to build shared modules:
+Run GNU make to build shared modules:
gmake -f Makefile-<modulename> [test]
diff --git a/numpy/f2py/doc/f2python9-final/src/examples/exp1session.txt b/numpy/f2py/doc/f2python9-final/src/examples/exp1session.txt
index 9bec9198e..5ae75ebd1 100644
--- a/numpy/f2py/doc/f2python9-final/src/examples/exp1session.txt
+++ b/numpy/f2py/doc/f2python9-final/src/examples/exp1session.txt
@@ -17,4 +17,4 @@ Return objects:
>>> print l,u
[ 517656. 190435.] [ 566827. 208524.]
>>> print l[0]/l[1], u[0]/u[1]-l[0]/l[1]
-2.71828182845 1.36437527942e-11 \ No newline at end of file
+2.71828182845 1.36437527942e-11
diff --git a/numpy/f2py/doc/multiarray/array_from_pyobj.c b/numpy/f2py/doc/multiarray/array_from_pyobj.c
index 03d4aacf6..237d16dbc 100644
--- a/numpy/f2py/doc/multiarray/array_from_pyobj.c
+++ b/numpy/f2py/doc/multiarray/array_from_pyobj.c
@@ -311,9 +311,9 @@ int check_and_fix_dimensions(const PyArrayObject* arr,const int rank,int *dims)
if (arr->dimensions[i]!=dims[i]) {
fprintf(stderr,"%d-th dimension must be fixed to %d but got %d\n",
i,dims[i],arr->dimensions[i]);
- return 1;
+ return 1;
}
- if (!dims[i]) dims[i] = 1;
+ if (!dims[i]) dims[i] = 1;
} else
dims[i] = arr->dimensions[i];
}
diff --git a/numpy/f2py/doc/multiarray/fortran_array_from_pyobj.txt b/numpy/f2py/doc/multiarray/fortran_array_from_pyobj.txt
index c7b945c84..e351e8e89 100644
--- a/numpy/f2py/doc/multiarray/fortran_array_from_pyobj.txt
+++ b/numpy/f2py/doc/multiarray/fortran_array_from_pyobj.txt
@@ -118,7 +118,7 @@ Statement of the problem:
=========================
Consider a M-by-N matrix A of integers, where M and N are the number A
-rows and columns, respectively.
+rows and columns, respectively.
In Fortran language, the storing array of this matrix can be defined
as follows:
@@ -192,7 +192,7 @@ if type(obj) is ArrayType:
set_transpose_strides(obj) # lazy-transpose
Py_INCREF(obj);
return obj
- set_transpose_strides(obj)
+ set_transpose_strides(obj)
if is_contiguous(obj):
set_transpose_strides(obj)
Py_INCREF(obj);
@@ -281,4 +281,4 @@ else:
14 January, 2002
-Pearu Peterson <pearu@cens.ioc.ee> \ No newline at end of file
+Pearu Peterson <pearu@cens.ioc.ee>
diff --git a/numpy/f2py/doc/multiarray/transpose.txt b/numpy/f2py/doc/multiarray/transpose.txt
index a8d41e6df..925e7a399 100644
--- a/numpy/f2py/doc/multiarray/transpose.txt
+++ b/numpy/f2py/doc/multiarray/transpose.txt
@@ -1,7 +1,7 @@
From: Phil Garner (garner@signal.dra.hmg.gb)
- Subject: In place matrix transpose
+ Subject: In place matrix transpose
Newsgroups: sci.math.num-analysis
- Date: 1993-08-05 06:35:06 PST
+ Date: 1993-08-05 06:35:06 PST
Someone was talking about matrix transposes earlier on. It's a
@@ -161,16 +161,16 @@ int trans(scalar *a, unsigned m, unsigned n, int *move, int iwrk)
`-0---0-' `-0--0-' `--OO-------------------O-----' `---0---' `-0---0-'
From: Murray Dow (mld900@anusf.anu.edu.au)
- Subject: Re: In place matrix transpose
+ Subject: Re: In place matrix transpose
Newsgroups: sci.math.num-analysis
- Date: 1993-08-09 19:45:57 PST
+ Date: 1993-08-09 19:45:57 PST
In article <23qmp3INN3gl@mentor.dra.hmg.gb>, garner@signal.dra.hmg.gb (Phil Garner) writes:
|> Someone was talking about matrix transposes earlier on. It's a
|> curious subject. I found that an in-place transpose is about 12 times
|> slower than the trivial copying method.
-|>
+|>
Algorithm 380 from CACM is sloweer than ALG 467. Here are my times
from a VP2200 vector computer. Note that the CACM algorithms are scalar.
@@ -188,7 +188,7 @@ My Alg Matrix copy
Conclusions: dont use Alg 380 from Netlib. If you have the available memory,
do a matrix copy. If you don't have the memory, I will send you my algorithm
when I have published it.
---
+--
Murray Dow GPO Box 4 Canberra ACT 2601 Australia
Supercomputer Facility Phone: +61 6 2495028
Australian National University Fax: +61 6 2473425
@@ -197,16 +197,16 @@ mld900@anusf.anu.edu.au
=============================================================================
From: Mark Smotherman (mark@hubcap.clemson.edu)
- Subject: Matrix transpose benchmark [was Re: MIPS R8000 == TFP?]
+ Subject: Matrix transpose benchmark [was Re: MIPS R8000 == TFP?]
Newsgroups: comp.arch, comp.benchmarks, comp.sys.super
- Date: 1994-07-01 06:35:51 PST
+ Date: 1994-07-01 06:35:51 PST
mccalpin@perelandra.cms.udel.edu (John D. McCalpin) writes:
->
->Of course, these results are all for the naive algorithm. I would be
->interested to see what an efficient blocked algorithm looks like.
+>
+>Of course, these results are all for the naive algorithm. I would be
+>interested to see what an efficient blocked algorithm looks like.
>Anyone care to offer one? There is clearly a lot of performance
>to be gained by the effort....
@@ -225,15 +225,15 @@ Enjoy!
Matrix Transpose Generator
Copyright 1993, Dept. of Computer Science, Clemson University
-
+
Permission to use, copy, modify, and distribute this software and
its documentation for any purpose and without fee is hereby granted,
provided that the above copyright notice appears in all copies.
-
+
Clemson University and its Dept. of Computer Science make no
representations about the suitability of this software for any
purpose. It is provided "as is" without express or implied warranty.
-
+
Original author: Mark Smotherman
-------------------------------------------------------------------------*/
@@ -624,14 +624,14 @@ void processstmt()
}
}
}
---
+--
Mark Smotherman, Computer Science Dept., Clemson University, Clemson, SC
=======================================================================
From: has (h.genceli@bre.com)
- Subject: transpose of a nxm matrix stored in a vector !!!
+ Subject: transpose of a nxm matrix stored in a vector !!!
Newsgroups: sci.math.num-analysis
- Date: 2000/07/25
+ Date: 2000/07/25
If I have a matrix nrows x ncols, I can store it in a vector.
@@ -657,9 +657,9 @@ can give me a lead here, thanks.
Has
From: wei-choon ng (wng@ux8.cso.uiuc.edu)
- Subject: Re: transpose of a nxm matrix stored in a vector !!!
+ Subject: Re: transpose of a nxm matrix stored in a vector !!!
Newsgroups: sci.math.num-analysis
- Date: 2000/07/25
+ Date: 2000/07/25
has <h.genceli@bre.com> wrote:
@@ -674,12 +674,12 @@ no need to explicitly store the transpose matrix in another array and
doubling the storage!
W.C.
---
+--
From: Robin Becker (robin@jessikat.fsnet.co.uk)
- Subject: Re: transpose of a nxm matrix stored in a vector !!!
+ Subject: Re: transpose of a nxm matrix stored in a vector !!!
Newsgroups: sci.math.num-analysis
- Date: 2000/07/25
+ Date: 2000/07/25
In article <snr532fo3j1180@corp.supernews.com>, has <h.genceli@bre.com>
@@ -737,13 +737,13 @@ void dmx_transpose(unsigned n, unsigned m, double* a, double* b)
}
}
}
---
+--
Robin Becker
From: E. Robert Tisdale (edwin@netwood.net)
- Subject: Re: transpose of a nxm matrix stored in a vector !!!
+ Subject: Re: transpose of a nxm matrix stored in a vector !!!
Newsgroups: sci.math.num-analysis
- Date: 2000/07/25
+ Date: 2000/07/25
Take a look at
@@ -798,14 +798,14 @@ The C++ Scalar, Vector, Matrix and Tensor class library
Read the rest of this message... (50 more lines)
From: Victor Eijkhout (eijkhout@disco.cs.utk.edu)
- Subject: Re: transpose of a nxm matrix stored in a vector !!!
+ Subject: Re: transpose of a nxm matrix stored in a vector !!!
Newsgroups: sci.math.num-analysis
- Date: 2000/07/25
+ Date: 2000/07/25
"Alan Miller" <amiller @ vic.bigpond.net.au> writes:
-> The attached routine does an in situ transpose.
+> The attached routine does an in situ transpose.
> begin 666 Dtip.f90
> M4U5"4D]55$E.12!D=&EP("AA+"!N,2P@;C(L(&YD:6TI#0HA("TM+2TM+2TM
@@ -814,22 +814,22 @@ Hm. F90? You're not silently allocating a temporary I hope?
(Why did you have to encode this? Now I have to save, this decode, ...
and all for plain ascii?)
---
+--
Victor Eijkhout
"When I was coming up, [..] we knew exactly who the they were. It was us
-versus them, and it was clear who the them was were. Today, we are not
+versus them, and it was clear who the them was were. Today, we are not
so sure who the they are, but we know they're there." [G.W. Bush]
From: Alan Miller (amiller_@_vic.bigpond.net.au)
- Subject: Re: transpose of a nxm matrix stored in a vector !!!
+ Subject: Re: transpose of a nxm matrix stored in a vector !!!
Newsgroups: sci.math.num-analysis
- Date: 2000/07/25
+ Date: 2000/07/25
Victor Eijkhout wrote in message ...
>"Alan Miller" <amiller @ vic.bigpond.net.au> writes:
>
->> The attached routine does an in situ transpose.
+>> The attached routine does an in situ transpose.
>> begin 666 Dtip.f90
>> M4U5"4D]55$E.12!D=&EP("AA+"!N,2P@;C(L(&YD:6TI#0HA("TM+2TM+2TM
>
@@ -862,13 +862,13 @@ http://users.bigpond.net.au/amiller/
=================================================================
From: Darran Edmundson (dedmunds@sfu.ca)
- Subject: array reordering algorithm?
+ Subject: array reordering algorithm?
Newsgroups: sci.math.num-analysis
- Date: 1995/04/30
+ Date: 1995/04/30
-A code I've written refers to a complex array as two separate real arrays.
-However, I have a canned subroutine which expects a single array where the
+A code I've written refers to a complex array as two separate real arrays.
+However, I have a canned subroutine which expects a single array where the
real and imaginary values alternate. Essentially I have a case of mismatched
data structures, yet for reasons that I'd rather not go into, I'm stuck with them.
@@ -878,7 +878,7 @@ space, what I need is a porting subroutine that remaps the data from one format
to the other - using as little space as possible.
I think of the problem as follows. Imagine an array of dimension 10 containing
-the values 1,3,5,7,9,2,4,6,8,10 in this order.
+the values 1,3,5,7,9,2,4,6,8,10 in this order.
A(1) / 1 \ C(1)
A(2) | 3 | C(2)
@@ -892,18 +892,18 @@ the values 1,3,5,7,9,2,4,6,8,10 in this order.
B(4) | 8 | C(9)
B(5) \ 10 / C(10)
-Given that I know this initial pattern, I want to sort the array C in-place *without
-making comparisons*. That is, the algorithm can only depend on the initial
+Given that I know this initial pattern, I want to sort the array C in-place *without
+making comparisons*. That is, the algorithm can only depend on the initial
knowledge of the pattern. Do you see what a sort is going to do? It will
make the A and B arrays alternate, i.e. C(1)=A(1), C(2)=B(1), C(3)=A(2),
-C(4)=B(2), etc. It's not a real sort though because I can't actually refer to the
+C(4)=B(2), etc. It's not a real sort though because I can't actually refer to the
values above (i.e. no comparisons) because A and B will be holding real data,
not this contrived pattern. The pattern above exists though - it's the
natural ordering in memory of A and B.
-Either pair swapping only or a small amount of workspace can be used. The
-in-place is important - imagine scaling this problem up to an
-array of 32 or 64 million double precision values and you can easily see how
+Either pair swapping only or a small amount of workspace can be used. The
+in-place is important - imagine scaling this problem up to an
+array of 32 or 64 million double precision values and you can easily see how
duplicating the array is not a feasible solution.
Any ideas? I've been stumped on this for a day and a half now.
@@ -912,9 +912,9 @@ Darran Edmundson
dedmunds@sfu.ca
From: Roger Critchlow (rec@elf115.elf.org)
- Subject: Re: array reordering algorithm?
+ Subject: Re: array reordering algorithm?
Newsgroups: sci.math.num-analysis
- Date: 1995/04/30
+ Date: 1995/04/30
Any ideas? I've been stumped on this for a day and a half now.
@@ -1026,7 +1026,7 @@ int test_matrix_cols(a, m, n) TYPE *a; int m, n;
o += a[i*n+j] != j*m+i;
return o;
}
-
+
/* print a matrix */
void print_matrix(a, m, n) TYPE *a; int m, n;
{
@@ -1121,7 +1121,6 @@ main(argc, argv) int argc; char *argv[];
return 0;
}
-
+
#endif
#endif
-
diff --git a/numpy/f2py/doc/multiarrays.txt b/numpy/f2py/doc/multiarrays.txt
index 704208976..75aeaab9a 100644
--- a/numpy/f2py/doc/multiarrays.txt
+++ b/numpy/f2py/doc/multiarrays.txt
@@ -89,7 +89,7 @@ subroutine foo(l,m,n,a)
integer :: n
real*8 dimension(l,m,n),check(rank(a)==3),depend(l,m,n), &
check(shape(a,2)==l,shape(a,1)==m,shape(a,0)==n):: a
- optional a
+ optional a
end
Note again that the array a must depend on l,m,n. Then the array a will be
allocated in the Python C/API module. Not also that
@@ -117,4 +117,3 @@ wrapping Fortran multidimensional arrays with f2py2e.
Regards,
Pearu
-
diff --git a/numpy/f2py/doc/using_F_compiler.txt b/numpy/f2py/doc/using_F_compiler.txt
index 3067f0776..63bb0d68c 100644
--- a/numpy/f2py/doc/using_F_compiler.txt
+++ b/numpy/f2py/doc/using_F_compiler.txt
@@ -46,7 +46,7 @@ Required arguments:
>>> from Numeric import array
>>> a = array(3)
->>> fun.foo.bar(a)
+>>> fun.foo.bar(a)
Hello from foo.bar
a= 3
a= 8
@@ -54,7 +54,7 @@ Required arguments:
8
>>>
-This works nicely with all supported Fortran compilers.
+This works nicely with all supported Fortran compilers.
However, the F compiler (http://www.fortran.com/F/compilers.html) is
an exception. Namely, the F compiler is designed to recognize only
@@ -117,7 +117,7 @@ value of `a'.
4) Build the extension module
f2py -c foo.pyf foo.o --fcompiler=Gnu /opt/F/lib/quickfit.o \
- /opt/F/lib/libf96.a
+ /opt/F/lib/libf96.a
This will create the extension module foo.so into the current
directory. Notice that you must use Gnu compiler (gcc) for linking.
@@ -137,7 +137,7 @@ Return objects:
>>> foo.bar(3)
8
->>>
+>>>
Notice that the F compiled module procedures are called as ordinary
external procedures. Also I/O seems to be lacking for F compiled