Top (GNU Octave (version 7.1.0))

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.

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 7.1.0.

Preface
- Acknowledgements
- Citing Octave in Publications
- 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.6.1 Passing Arguments to Executable Scripts
  - 2.6.2 Dual-Purpose Executable Scripts and Octave Functions
- 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 String Operations
- 5.4 Converting Strings
- 5.5 Character Class Functions
6 Data Containers
- 6.1 Structures
- 6.2 containers.Map
- 6.3 Cell Arrays
- 6.4 Comma Separated Lists
  - 6.4.1 Comma Separated Lists Generated from Cell Arrays
  - 6.4.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.1.1 Advanced Indexing
- 8.2 Calling Functions
- 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 Introduction to Function and Script Files
- 11.2 Defining Functions
- 11.3 Returning from a Function
- 11.4 Multiple Return Values
- 11.5 Variable-length Return Lists
- 11.6 Variable-length Argument Lists
- 11.7 Ignoring Arguments
- 11.8 Default Arguments
- 11.9 Validating Arguments
- 11.10 Function Files
- 11.11 Script Files
- 11.12 Function Handles and Anonymous Functions
  - 11.12.1 Function Handles
  - 11.12.2 Anonymous Functions
- 11.13 Command Syntax and Function Syntax
- 11.14 Organization of Functions Distributed with Octave
12 Errors and Warnings
- 12.1 Handling 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 Leaving Debug Mode
- 13.3 Breakpoints
- 13.4 Debug Mode
- 13.5 Call Stack
- 13.6 Profiling
- 13.7 Profiler Example
14 Input and Output
- 14.1 Basic Input and Output
- 14.2 C-Style I/O Functions
15 Plotting
- 15.1 Introduction to Plotting
- 15.2 High-Level Plotting
- 15.3 Graphics Data Structures
- 15.4 Advanced Plotting
16 Matrix Manipulation
- 16.1 Finding Elements and Checking Conditions
- 16.2 Rearranging Matrices
- 16.3 Special Utility Matrices
- 16.4 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 Rational Approximations
- 17.8 Coordinate Transformations
- 17.9 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 Vectorization and Faster Code Execution
- 19.1 Basic Vectorization
- 19.2 Broadcasting
  - 19.2.1 Broadcasting and Legacy Code
- 19.3 Function Application
- 19.4 Accumulation
- 19.5 Miscellaneous Techniques
- 19.6 Examples
20 Nonlinear Equations
- 20.1 Solvers
- 20.2 Minimizers
21 Diagonal and Permutation Matrices
- 21.1 Creating and Manipulating Diagonal/Permutation Matrices
- 21.2 Linear Algebra with Diagonal/Permutation Matrices
  - 21.2.1 Expressions Involving Diagonal Matrices
  - 21.2.2 Expressions Involving Permutation Matrices
- 21.3 Functions That Are Aware of These Matrices
  - 21.3.1 Diagonal Matrix Functions
  - 21.3.2 Permutation Matrix Functions
- 21.4 Examples of Usage
- 21.5 Differences in Treatment of Zero Elements
22 Sparse Matrices
- 22.1 Creation and Manipulation of Sparse Matrices
- 22.2 Linear Algebra on Sparse Matrices
- 22.3 Iterative Techniques Applied to Sparse Matrices
- 22.4 Real Life Example using Sparse Matrices
23 Numerical Integration
- 23.1 Functions of One Variable
- 23.2 Orthogonal Collocation
- 23.3 Functions of Multiple Variables
24 Differential Equations
- 24.1 Ordinary Differential Equations
- 24.2 Differential-Algebraic Equations
- 24.3 Matlab-compatible solvers
25 Optimization
- 25.1 Linear Programming
- 25.2 Quadratic Programming
- 25.3 Nonlinear Programming
- 25.4 Linear Least Squares
26 Statistics
- 26.1 Descriptive Statistics
- 26.2 Statistics on Sliding Windows of Data
- 26.3 Basic Statistical Functions
- 26.4 Correlation and Regression Analysis
- 26.5 Distributions
- 26.6 Random Number Generation
27 Sets
- 27.1 Set Operations
28 Polynomial Manipulations
- 28.1 Evaluating Polynomials
- 28.2 Finding Roots
- 28.3 Products of Polynomials
- 28.4 Derivatives / Integrals / Transforms
- 28.5 Polynomial Interpolation
- 28.6 Miscellaneous Functions
29 Interpolation
- 29.1 One-dimensional Interpolation
- 29.2 Multi-dimensional Interpolation
30 Geometry
- 30.1 Delaunay Triangulation
  - 30.1.1 Plotting the Triangulation
  - 30.1.2 Identifying Points in Triangulation
- 30.2 Voronoi Diagrams
- 30.3 Convex Hull
- 30.4 Interpolation on Scattered Data
- 30.5 Vector Rotation Matrices
31 Signal Processing
32 Image Processing
- 32.1 Loading and Saving Images
- 32.2 Displaying Images
- 32.3 Representing Images
- 32.4 Plotting on top of Images
- 32.5 Color Conversion
33 Audio Processing
- 33.1 Audio File Utilities
- 33.2 Audio Device Information
- 33.3 Audio Player
  - 33.3.1 Playback
  - 33.3.2 Properties
- 33.4 Audio Recorder
- 33.5 Audio Data Processing
34 Object Oriented Programming
- 34.1 Creating a Class
- 34.2 Class Methods
- 34.3 Indexing Objects
  - 34.3.1 Defining Indexing And Indexed Assignment
  - 34.3.2 Indexed Assignment Optimization
- 34.4 Overloading Objects
- 34.5 Inheritance and Aggregation
- 34.6 classdef Classes
35 GUI Development
- 35.1 I/O Dialogs
- 35.2 Progress Bar
- 35.3 UI Elements
- 35.4 GUI Utility Functions
- 35.5 User-Defined Preferences
- 35.6 Octave Workspace Windows
36 System Utilities
- 36.1 Timing Utilities
- 36.2 Filesystem Utilities
- 36.3 File Archiving Utilities
- 36.4 Networking Utilities
- 36.5 Controlling Subprocesses
- 36.6 Process, Group, and User IDs
- 36.7 Environment Variables
- 36.8 Current Working Directory
- 36.9 Password Database Functions
- 36.10 Group Database Functions
- 36.11 System Information
- 36.12 Hashing Functions
37 Packages
- 37.1 Installing and Removing Packages
- 37.2 Using Packages
- 37.3 Administrating Packages
- 37.4 Creating Packages
Appendix A External Code Interface
- A.1 Oct-Files
- A.2 Mex-Files
- A.3 Standalone Programs
- A.4 Java Interface
Appendix B Test and Demo Functions
- B.1 Test Functions
- B.2 Demonstration Functions
Appendix C Obsolete Functions
Appendix D Known Causes of Trouble
- D.1 Actual Bugs We Haven’t Fixed Yet
- D.2 Reporting Bugs
- D.3 How To Get Help with Octave
- D.4 How to Distinguish Between Octave and Matlab
Appendix E Installing Octave
- E.1 Build Dependencies
- E.2 Running Configure and Make
- E.3 Compiling Octave with 64-bit Indexing
- E.4 Installation Problems
Appendix F Grammar and Parser
- F.1 Keywords
- F.2 Parser
Appendix G GNU GENERAL PUBLIC LICENSE
Concept Index
Function Index
Operator Index
Graphics Properties Index

GNU Octave (version 7.1.0)

Table of Contents