Untitled

Permission is granted to make and distribute verbatim copies of this manual provided the copyright notice and this permission notice are preserved on all copies.

Permission is granted to copy and distribute modified versions of this manual under the conditions for verbatim copying, provided that the entire resulting derived work is distributed under the terms of a permission notice identical to this one.

Permission is granted to copy and distribute translations of this manual into another language, under the above conditions for modified versions.

GNU Octave
Preface
- Acknowledgements
- How You Can Contribute to Octave
- Distribution
1 A Brief Introduction to Octave
- 1.1 Running Octave
- 1.2 Simple Examples
- 1.3 Conventions
2 Getting Started
- 2.1 Invoking Octave from the Command Line
  - 2.1.1 Command Line Options
  - 2.1.2 Startup Files
- 2.2 Quitting Octave
- 2.3 Commands for Getting Help
- 2.4 Command Line Editing
- 2.5 How Octave Reports Errors
- 2.6 Executable Octave Programs
- 2.7 Comments in Octave Programs
3 Data Types
- 3.1 Built-in Data Types
- 3.2 User-defined Data Types
- 3.3 Object Sizes
4 Numeric Data Types
- 4.1 Matrices
  - 4.1.1 Empty Matrices
- 4.2 Ranges
- 4.3 Single Precision Data Types
- 4.4 Integer Data Types
  - 4.4.1 Integer Arithmetic
- 4.5 Bit Manipulations
- 4.6 Logical Values
- 4.7 Promotion and Demotion of Data Types
- 4.8 Predicates for Numeric Objects
5 Strings
- 5.1 Escape Sequences in string constants
- 5.2 Character Arrays
- 5.3 Creating Strings
  - 5.3.1 Concatenating Strings
  - 5.3.2 Conversion of Numerical Data to Strings
- 5.4 Comparing Strings
- 5.5 Manipulating Strings
- 5.6 String Conversions
- 5.7 Character Class Functions
6 Data Containers
- 6.1 Data Structures
- 6.2 Cell Arrays
- 6.3 Comma Separated Lists
  - 6.3.1 Comma Separated Lists Generated from Cell Arrays
  - 6.3.2 Comma Separated Lists Generated from Structure Arrays
7 Variables
- 7.1 Global Variables
- 7.2 Persistent Variables
- 7.3 Status of Variables
8 Expressions
- 8.1 Index Expressions
- 8.2 Calling Functions
  - 8.2.1 Call by Value
  - 8.2.2 Recursion
- 8.3 Arithmetic Operators
- 8.4 Comparison Operators
- 8.5 Boolean Expressions
  - 8.5.1 Element-by-element Boolean Operators
  - 8.5.2 Short-circuit Boolean Operators
- 8.6 Assignment Expressions
- 8.7 Increment Operators
- 8.8 Operator Precedence
9 Evaluation
- 9.1 Calling a Function by its Name
- 9.2 Evaluation in a Different Context
10 Statements
- 10.1 The if Statement
- 10.2 The switch Statement
  - 10.2.1 Notes for the C programmer
- 10.3 The while Statement
- 10.4 The do-until Statement
- 10.5 The for Statement
  - 10.5.1 Looping Over Structure Elements
- 10.6 The break Statement
- 10.7 The continue Statement
- 10.8 The unwind_protect Statement
- 10.9 The try Statement
- 10.10 Continuation Lines
11 Functions and Scripts
- 11.1 Defining Functions
- 11.2 Multiple Return Values
- 11.3 Variable-length Argument Lists
- 11.4 Variable-length Return Lists
- 11.5 Returning From a Function
- 11.6 Default Arguments
- 11.7 Function Files
- 11.8 Script Files
- 11.9 Function Handles, Inline Functions, and Anonymous Functions
- 11.10 Commands
- 11.11 Organization of Functions Distributed with Octave
12 Errors and Warnings
- 12.1 Handling Errors
  - 12.1.1 Raising Errors
  - 12.1.2 Catching Errors
- 12.2 Handling Warnings
  - 12.2.1 Issuing Warnings
  - 12.2.2 Enabling and Disabling Warnings
13 Debugging
- 13.1 Entering Debug Mode
- 13.2 Leavinging Debug Mode
- 13.3 Breakpoints
- 13.4 Debug Mode
- 13.5 Call Stack
14 Input and Output
- 14.1 Basic Input and Output
- 14.2 C-Style I/O Functions
15 Plotting
- 15.1 Plotting Basics
- 15.2 Advanced Plotting
16 Matrix Manipulation
- 16.1 Finding Elements and Checking Conditions
- 16.2 Rearranging Matrices
- 16.3 Applying a Function to an Array
- 16.4 Special Utility Matrices
- 16.5 Famous Matrices
17 Arithmetic
- 17.1 Exponents and Logarithms
- 17.2 Complex Arithmetic
- 17.3 Trigonometry
- 17.4 Sums and Products
- 17.5 Utility Functions
- 17.6 Special Functions
- 17.7 Coordinate Transformations
- 17.8 Mathematical Constants
18 Linear Algebra
- 18.1 Techniques used for Linear Algebra
- 18.2 Basic Matrix Functions
- 18.3 Matrix Factorizations
- 18.4 Functions of a Matrix
- 18.5 Specialized Solvers
19 Nonlinear Equations
20 Diagonal and Permutation Matrices
- 20.1 Creating and Manipulating Diagonal and Permutation Matrices
- 20.2 Linear Algebra with Diagonal and Permutation Matrices
  - 20.2.1 Expressions Involving Diagonal Matrices
  - 20.2.2 Expressions Involving Permutation Matrices
- 20.3 Functions That Are Aware of These Matrices
  - 20.3.1 Diagonal Matrix Functions
  - 20.3.2 Permutation Matrix Functions
- 20.4 Some Examples of Usage
- 20.5 The Differences in Treatment of Zero Elements
21 Sparse Matrices
- 21.1 The Creation and Manipulation of Sparse Matrices
- 21.2 Linear Algebra on Sparse Matrices
- 21.3 Iterative Techniques applied to sparse matrices
- 21.4 Real Life Example of the use of Sparse Matrices
22 Numerical Integration
- 22.1 Functions of One Variable
- 22.2 Orthogonal Collocation
- 22.3 Functions of Multiple Variables
23 Differential Equations
- 23.1 Ordinary Differential Equations
- 23.2 Differential-Algebraic Equations
24 Optimization
- 24.1 Linear Programming
- 24.2 Quadratic Programming
- 24.3 Nonlinear Programming
- 24.4 Linear Least Squares
25 Statistics
- 25.1 Descriptive Statistics
- 25.2 Basic Statistical Functions
- 25.3 Statistical Plots
- 25.4 Tests
- 25.5 Models
- 25.6 Distributions
- 25.7 Random Number Generation
26 Sets
- 26.1 Set Operations
27 Polynomial Manipulations
- 27.1 Evaluating Polynomials
- 27.2 Finding Roots
- 27.3 Products of Polynomials
- 27.4 Derivatives and Integrals
- 27.5 Polynomial Interpolation
- 27.6 Miscellaneous Functions
28 Interpolation
- 28.1 One-dimensional Interpolation
- 28.2 Multi-dimensional Interpolation
29 Geometry
- 29.1 Delaunay Triangulation
  - 29.1.1 Plotting the Triangulation
  - 29.1.2 Identifying points in Triangulation
- 29.2 Voronoi Diagrams
- 29.3 Convex Hull
- 29.4 Interpolation on Scattered Data
30 Signal Processing
31 Image Processing
- 31.1 Loading and Saving Images
- 31.2 Displaying Images
- 31.3 Representing Images
- 31.4 Plotting on top of Images
- 31.5 Color Conversion
32 Audio Processing
33 Object Oriented Programming
- 33.1 Creating a Class
- 33.2 Manipulating Classes
- 33.3 Indexing Objects
- 33.4 Overloading Objects
- 33.5 Inheritance and Aggregation
34 System Utilities
- 34.1 Timing Utilities
- 34.2 Filesystem Utilities
- 34.3 File Archiving Utilities
- 34.4 Networking Utilities
- 34.5 Controlling Subprocesses
- 34.6 Process, Group, and User IDs
- 34.7 Environment Variables
- 34.8 Current Working Directory
- 34.9 Password Database Functions
- 34.10 Group Database Functions
- 34.11 System Information
- 34.12 Hashing Functions
35 Packages
- 35.1 Installing and Removing Packages
- 35.2 Using Packages
- 35.3 Administrating Packages
- 35.4 Creating Packages
Appendix A Dynamically Linked Functions
- A.1 Oct-Files
- A.2 Mex-Files
- A.3 Standalone Programs
Appendix B Test and Demo Functions
- B.1 Test Functions
- B.2 Demonstration Functions
Appendix C Tips and Standards
- C.1 Writing Clean Octave Programs
- C.2 Tips for Making Code Run Faster.
- C.3 Tips on Writing Comments
- C.4 Conventional Headers for Octave Functions
- C.5 Tips for Documentation Strings
Appendix D Contributing Guidelines
- D.1 How to Contribute
- D.2 General Guidelines
- D.3 Octave Sources (m-files)
- D.4 C++ Sources
- D.5 Other Sources
Appendix E Known Causes of Trouble
- E.1 Actual Bugs We Haven't Fixed Yet
- E.2 Reporting Bugs
- E.3 Have You Found a Bug?
- E.4 Where to Report Bugs
- E.5 How to Report Bugs
- E.6 Sending Patches for Octave
- E.7 How To Get Help with Octave
Appendix F Installing Octave
- F.1 Installation Problems
Appendix G Emacs Octave Support
- G.1 Installing EOS
- G.2 Using Octave Mode
- G.3 Running Octave From Within Emacs
- G.4 Using the Emacs Info Reader for Octave
Appendix H GNU GENERAL PUBLIC LICENSE
Concept Index
Function Index
Operator Index

GNU Octave

This manual documents how to run, install and port GNU Octave, as well as its new features and incompatibilities, and how to report bugs. It corresponds to GNU Octave version 3.2.4.

Table of Contents

GNU Octave