comparison README @ 7088:5eb3db6e4042

[project @ 2007-10-31 20:35:10 by jwe]
author jwe
date Wed, 31 Oct 2007 20:35:10 +0000
parents 93c65f2a5668
children 25b85c36208f
comparison
equal deleted inserted replaced
7087:b04f0523558d 7088:5eb3db6e4042
1 GNU Octave -- a high-level language for numerical computations. 1 GNU Octave -- a high-level language for numerical computations.
2 2
3 Copyright (C) 1996, 1997, 1998, 2002, 2007 John W. Eaton 3 Copyright (C) 1996, 1997, 1998, 2002, 2007 John W. Eaton
4
5 Last updated: Thu, 11 Oct 2007 19:26:42 EDT
6 4
7 Overview 5 Overview
8 -------- 6 --------
9 7
10 GNU Octave is a high-level language, primarily intended for numerical 8 GNU Octave is a high-level language, primarily intended for numerical
32 sites around the world. 30 sites around the world.
33 31
34 Installation and Bugs 32 Installation and Bugs
35 --------------------- 33 ---------------------
36 34
37 Octave requires approximately 125MB of disk storage to unpack and 35 Octave requires approximately 925MB of disk storage to unpack and
38 compile from source (significantly less if you don't compile with 36 compile from source (significantly less if you don't compile with
39 debugging symbols or create shared libraries). Once installed, Octave 37 debugging symbols). Once installed, Octave requires approximately
40 requires approximately 65MB of disk space (again, considerably less if 38 350MB of disk space (again, considerably less if you don't build
41 you don't build shared libraries or the binaries and libraries do not 39 shared libraries or the binaries and libraries do not include
42 include debugging symbols). 40 debugging symbols).
43 41
44 To compile Octave, you will need a recent version of GNU Make. You 42 To compile Octave, you will need a recent version of GNU Make. You
45 will also need g++ 2.7.2 or later. Version 2.8.0 or egcs 1.0.x should 43 will also need a recent version of g++ or other ANSI C++ compiler.
46 work. Later versions may work, but C++ is still evolving, so don't be 44 You will also need a Fortran 77 compiler or f2c. If you use f2c, you
47 too surprised if you run into some trouble. 45 will need a script like fort77 that works like a normal Fortran
48 46 compiler by combining f2c with your C compiler in a single script.
49 It is no longer necessary to have libg++, but you do need to have the
50 GNU implementation of libstdc++. If you are using g++ 2.7.2,
51 libstdc++ is distributed along with libg++, but for later versions,
52 libstdc++ is distributed separately. For egcs, libstdc++ is included
53 with the compiler distribution.
54 47
55 YOU MUST HAVE GNU MAKE TO COMPILE OCTAVE. Octave's Makefiles use 48 YOU MUST HAVE GNU MAKE TO COMPILE OCTAVE. Octave's Makefiles use
56 features of GNU Make that are not present in other versions of make. 49 features of GNU Make that are not present in other versions of make.
57 GNU Make is very portable and easy to install. 50 GNU Make is very portable and easy to install.
58 51
64 well as a list of known problems and possible fixes. 57 well as a list of known problems and possible fixes.
65 58
66 Documentation 59 Documentation
67 ------------- 60 -------------
68 61
69 Octave's manual has been revised for version 2.0, but it is lagging a 62 Octave's manual has been revised for version 3.0, but it is lagging a
70 bit behind the development of the software. In particular, there is 63 bit behind the development of the software. In particular, there is
71 currently no complete documentation of the C++ class libraries or the 64 currently no complete documentation of the C++ class libraries. If
72 support for dynamic linking and user-defined data types. If you 65 you notice ommissions or inconsistencies, please report them as bugs
73 notice ommissions or inconsistencies, please report them as bugs to 66 to bug@octave.org. Specific suggestions for ways to improve Octave
74 bug@octave.org. Specific suggestions for ways to improve Octave and 67 and its documentation are always welcome. Reports with patches are
75 its documentation are always welcome. 68 even more welcome.
76
77 Implementation
78 --------------
79
80 Octave is being developed with the Free Software Foundation's make,
81 bison (a replacement for YACC), flex (a replacement for lex), gcc/g++,
82 and libstdc++ on an Intel Pentium II system running Linux/GNU. It
83 should be possible to install it on any machine that runs GCC/G++. It
84 may also be possible to install it using other implementations of
85 these tools, but it will most certainly require much more work. Do
86 yourself a favor and get the GNU development tools, either via
87 anonymous ftp from ftp.gnu.org or by writing the Free Software
88 Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA
89 02110-1301, USA.
90
91 The underlying numerical solvers are currently standard Fortran ones
92 like Lapack, Linpack, Odepack, the Blas, etc., packaged in a library
93 of C++ classes (see the files in the libcruft and liboctave
94 subdirectories). If possible, the Fortran subroutines are compiled
95 with the system's Fortran compiler, and called directly from the C++
96 functions. If that's not possible, they are translated with f2c and
97 compiled with a C compiler. Better performance is usually achieved if
98 the intermediate translation to C is avoided.
99
100 The library of C++ classes may also be useful by itself.
101 69
102 Additional Information 70 Additional Information
103 ---------------------- 71 ----------------------
104 72
105 Up to date information about Octave is available on the WWW at the 73 Up to date information about Octave is available on the WWW at the
106 URL http://www.octave.org, including archives of the help-octave, 74 URL http://www.octave.org, including archives of the help, bug, and
107 bug-octave, and octave-sources mailing lists. 75 maintainers mailing lists.
108 76
109 -- 77
110 John W. Eaton 78 John W. Eaton
111 jwe@bevo.che.wisc.edu 79 jwe@bevo.che.wisc.edu
112 University of Wisconsin-Madison 80 University of Wisconsin-Madison
113 Department of Chemical Engineering 81 Department of Chemical & Biological Engineering
82
83 Last updated: Thu, 11 Oct 2007 19:26:42 EDT