Documentos de Académico
Documentos de Profesional
Documentos de Cultura
Autor:JosMaraValienteCifuentes
TrabajorealizadodentrodeunProyectoFindeCarreradirigidopor
CarlosMedranoSnchez
enlaE.U.PolitcnicadeTeruel
Ao2006
Licencia
Copyright(c)2006JosMaraValienteCifuentes
Manual
De
GNU Octave
Pg -1-
1. Operaciones Bsicas
1.1. Operaciones con matrices y vectores
1.1.1. Introduccin de matrices desde el teclado
1.1.2. Operaciones con matrices
1.1.3. Tipos de datos
1.1.3.1. Nmeros reales de doble precisin
1.1.3.2. Nmeros Complejos
1.1.3.3. Cadenas de caracteres
1.1.3.4. Otras formas de definir matrices
1.1.3.4.1 Tipos de matrices predefinidos
1.1.3.4.2 Formacin de una matriz a partir de otras
1.1.3.4.3 Direccionamiento de vectores y matrices a partir de
vectores
1.1.3.4.4 Operador <<Dos Puntos>> (:)
1.1.3.4.5 Definicin de matrices y vectores desde fichero
1.1.3.5. Operadores Relacionales
1.1.3.6. Operadores Lgicos
1.2. Funciones de Librera
1.2.1 Caractersticas Generales de las funciones de librera
1.2.2. Funciones matemticas elementales que operan de modo escalar
1.2.3. Funciones que actan sobre matrices
1.2.3.1 Funciones elementales
1.2.3.2 Funciones Especiales
1.2.3.3 Funciones de Factorizacin y/o Descomposicin Matricial
1.3. Ms sobre operadores relacionales con vectores y matrices
1.4. Otras funciones que actan sobre vectores y matrices
2. Otros tipos de datos de GNU Octave
2.1. Cadenas de caracteres
2.2 Hipermatrices (arrays de ms de dos dimensiones)
2.2.1 Definicin de Hipermatrices
Pg -2-
Pg -3-
Pg -4-
1. Operaciones Bsicas
octave:31> a=[1 1; 2 5]
A partir de este momento la matriz a est disponible para hacer cualquier tipo de
operacin con ella (adems de valores numricos, en la definicin de una matriz o
vector se pueden utilizar expresiones y funciones matemticas). Por ejemplo, una
Pg -5-
10
octave:34> a -b
ans =
-6
-5
-6
15
54
27
16
15
A continuacin vamos a definir una nueva matriz a a partir de una funcin que
genera valores aleatorios entre 0 y 1.
octave:4> a=rand(3); #generar una matriz aleatoria de 3x3
octave:5> a
a =
0.6086115
0.0010003
0.3250563
0.4910289
0.2250230
0.4538064
0.6238124
0.5558372
0.9002053
Vamos ahora a crear una matriz 3x3 para realizar nuevos clculos a partir de una
matriz ms manejable si queremos comprobar a mano los datos que creamos.
octave:6> a=[1 2 1;1 2 3;4 3.4 4.5]
a =
1.0000
2.0000
1.0000
1.0000
2.0000
3.0000
4.0000
3.4000
4.5000
Pg -7-
-0.13043
-0.60870
0.43478
0.81522
0.05435
-0.21739
-0.50000
0.50000
0.00000
1.00000
0.00000
0.00000
0.00000
1.00000
0.00000
0.00000
0.00000
1.00000
2 0 0
octave:50> b=[2 0 0]
b =
2
0
0
Como podemos observar, podemos definir vectores fila y vectores columna, con
slo hacer la traspuesta del vector en la definicin. Tambin podemos definir un vector
columna como si hicieramos una matriz de 1xn
octave:46> b=[1;0];
Como podemos ver, no hemos obtenido resultado tras realizar la operacin; esto
es debido a que hemos puesto un ; al final de la lnea de comando, esto hace que no
salga por pantalla lo que hemos ejecutado, cosa que resulta muy til cuando las
Pg -8-
Pg -9-
adicin o suma
sustraccin o resta
multiplicacin
'
traspuesta
potenciacin
divisin-izquierda
divisin-derecha
algunas
diferencias.
Todos
estos
operadores
son
coherentes
con
las
Pg -10-
1.66667
-0.66667
Vase el siguiente ejemplo de tres ecuaciones formadas por una recta que no
pasa por el origen y los dos ejes de coordenadas:
b =
2
0
0
0.33333
0.66667
resto =
-0.33333
0.33333
0.66667
Pg -11-
0.185185
-0.037037
1.259259
-0.851852
octave:38> a\b
ans =
9.0000
9.0000
-2.0000
-3.0000
0.14286
0.16667
0.25000
1.66667
octave:40> a.\b
ans =
7.00000
6.00000
4.00000
0.60000
7.00000
6.00000
4.00000
0.60000
Pg -12-
As pues, para GNU Octave el infinito se representa como inf Inf. GNU
Octave tiene tambin una representacin especial para los resultados que no estn
definidos como nmeros. Por ejemplo, ejectense los siguientes comandos y obsrvense
las respuestas obtenidas:
octave:51> 0/0
warning: division by zero
ans = NaN
Pg -13-
eps
realmin
(2.2251e-308)
realmax
(1.7977e+308)
Pg -14-
Esta funcin conj() puede ser empleada con escalares debido a que podemos
entender dicho escalar como una matriz de 1x1.
Pg -15-
clear sin argumentos, clear elimina todas las variables creadas previamente
(excepto las variables globales).
Pg -16-
octave:84> eye(2)
ans =
octave:83> zeros(3,5)
ans =
octave:85> zeros(2)
ans =
octave:87> ones(3,4)
ans =
octave:88> linspace(1,10,9)
ans =
Pg -17-
Columns 1 through 8:
1.0000
2.1250
3.2500
4.3750
5.5000
6.6250
7.7500
8.8750
Column 9:
10.0000
valores espaciados
magic(3) crea una matriz (3x3) con los nmeros 1, 2, ... 3*3, con la
propiedad de que todas las filas y columnas suman lo mismo.
octave:92> magic(3)
ans =
-2
-1
octave:105> x=1:0.00001:2;
octave:106> longitud_vector=length(x)
longitud_vector = 100001
zeros(size(A)) forma una matriz de ceros del mismo tamao que una
matriz A previamente creada.
octave:107> zeros(size(a))
ans =
Pg -19-
1
2
5
octave:112> diag(diag(a))
ans =
triu(A) forma una matriz triangular superior a partir de una matriz A (no
tiene por qu ser cuadrada).
octave:110> triu(a)
ans =
octave:109> tril(a)
ans =
Pg -20-
octave:113> rot90(a,1)
ans =
octave:114> flipud(a)
ans =
Pg -21-
octave:127> a=rand(2,5)
a =
0.253124
0.517686
0.089229
0.382511
0.177737
0.081242
0.079172
0.841718
0.649800
0.634496
0.253124
0.081242
0.089229
Creamos esta nueva matriz a para que sea ms fcil seguir los valores:
octave:133> a=randn(4)*10
a =
-22.94025
6.55306
-2.80857
-1.33060
5.12081
8.98726
1.81236
3.29938
-0.69713
1.40557
25.56103
5.62650
-17.50361
-0.63861
4.61985
1.21845
octave:134> a(2,3)
ans = 1.8124
Pg -22-
-17.50361
-0.63861
4.61985
-0.69713
1.40557
25.56103
5.62650
-2.8086
1.8124
25.5610
4.6199
10
Pg -23-
10
-22.94025
6.55306
-2.80857
-1.33060
5.12081
8.98726
1.81236
3.29938
-0.69713
1.40557
25.56103
5.62650
-17.50361
-0.63861
4.61985
1.21845
Pg -24-
== igual que
~= distinto que
Pg -25-
& and
| or
~ negacin lgica
Obsrvese que estos operadores lgicos tienen distinta notacin que los
correspondientes operadores de C (&&, || y !). Los operadores lgicos se combinan con
los relacionales para poder comprobar el cumplimiento de condiciones mltiples.
octave:165> a=true
a = 1
octave:166> b=not(a)
b = 0
octave:167> c=a&b
c = 0
octave:168> c=a|b
c = 1
Pg -26-
function y=prueba(x)
y=x+3;
endfunction
Podemos ver que esta funcin es solamente la funcin de una recta, cuya
pendiente es de 45 y desplazada 3 unidades.
y : es el valor de retorno.
prueba : es el nombre de la funcin.
x : es el argumento de entrada.
Una caracterstica de GNU OCTAVE es que las funciones que no tienen
argumentos no llevan parntesis, por lo que a simple vista no siempre son fciles de
distinguir de las simples variables. Ejemplo:
#! hello -qf
printf("hello, world \n")
Pg -27-
octave:1> hello
hello, word
Los nombres de las funciones de GNU Octave no son palabras reservadas del
lenguaje. Es posible crear una variable llamada sin o cos, que ocultan las funciones
correspondientes. Para poder acceder a las funciones hay que eliminar (clear) las
variables del mismo nombre que las ocultan.
Podemos encontrar gran variedad de tipos de funcin segn lo que resuelvan:
1.- Funciones matemticas elementales.
2.- Funciones especiales.
3.- Funciones matriciales elementales.
4.- Funciones matriciales especficas.
5.- Funciones para la descomposicin y/o factorizacin de matrices.
6.- Funciones para anlisis estadstico de datos.
7.- Funciones para anlisis de polinomios.
8.- Funciones para integracin de ecuaciones diferenciales ordinarias.
9.- Resolucin de ecuaciones no-lineales y optimizacin.
10.- Integracin numrica.
11.- Funciones para procesamiento de seal.
-0.85065
0.52573
0.52573
0.85065
Pg -28-
-0.23607
0.00000
0.00000
4.23607
la funcin eig() calcula los valores y vectores propios de la matriz cuadrada A. Los
vectores propios se devuelven como columnas de la matriz vector_propio, mientras
que los valores propios son los elementos de la matriz diagonal valor_propio.
o
Las operaciones de suma y/o resta de una matriz con un escalar consisten en
sumar y/o restar el escalar a todos los elementos de la matriz.
Pg -30-
1 - 1i
1 - 2i
2 - 3i
2 - 1i
1 + 1i
1 + 2i
2 + 3i
2 + 1i
-4
-2
Pg -31-
0.8047 + 1.5708i
0.3540 - 1.2825i
0.5309 - 1.9238i
0.8047 + 1.5708i
Pg -32-
0.521692
0.247373
0.174305
0.245762
0.047457
0.744174
0.468085
0.375004
0.362295
octave:43> [L,U]=lu(a)
L =
1.00000
0.00000
0.00000
0.47109
-0.45134
1.00000
0.89725
1.00000
0.00000
U =
0.52169
0.24737
0.17430
0.00000
0.15305
0.20590
0.00000
0.00000
0.75499
Pg -33-
2.00000
2.00000
0.50000
0.00000
1.00000
0.00000
0.00000
13.00000
0.00000
1.00000
0.00000
-2.00000
0.00000
0.00000
1.00000
-8.00000
Pg -34-
-0.50000
-0.50000
0.50000
0.50000
-0.50000
-0.50000
-0.50000
-0.50000
-0.50000
0.50000
0.50000
-0.50000
-0.50000
0.50000
-0.50000
0.50000
-2.00000
-3.00000
-3.00000
-5.00000
0.00000
1.00000
0.00000
0.00000
0.00000
0.00000
-1.00000
-2.00000
0.00000
0.00000
0.00000
-1.00000
octave:54> r
r =
Pg -35-
o Q = orth(A) las columnas de Q son una base ortonormal del espacio vectorial de
las columnas de A, y el nmero de columnas de Q es el rango de A .
octave:62> q=orth(a)
q =
0.36060
0.93272
0.93272
-0.36060
0.100000
0.200000
0.100000
0.200000
0.84525
0.67284
0.87206
0.57248
octave:68> norm(x,2)
ans = 1.5018
Pg -36-
octave:67> x=rand(1,4)
x =
0.84525
0.67284
0.87206
0.57248
octave:68> norm(x,2)
ans = 1.5018
octave:69> norm(x,3)
ans = 1.2072
Pg -37-
Cuando alguno de los operadores relacionales vistos previamente (<, >, <=, >=,
== y =) acta entre dos matrices (vectores) del mismo tamao, el resultado es otra
matriz (vector) de ese mismo tamao conteniendo unos y ceros, segn los resultados de
cada comparacin entre elementos hayan sido true o false, respectivamente.
De ordinario, las matrices "binarias" que se obtienen de la aplicacin de los
operadores relacionales no se almacenan en memoria ni se asignan a variables, sino que
se procesan sobre la marcha. GNU OCTAVE dispone de varias funciones para ello.
Recurdese que cualquier valor distinto de cero equivale a true, mientras que un valor
cero equivale a false. Algunas de estas funciones son:
octave:70> any(x)
ans = 1
octave:71> any(a)
ans =
Pg -38-
octave:74> all(a)
ans =
octave:82> x
x =
0.84525
0.67284
0.87206
0.57248
octave:83> find(x>0)
ans =
find(A) cuando esta funcin se aplica a una matriz la considera como un vector
con una columna detrs de otra, de la 1 a la ltima.
Pg -39-
isnan() chequea si hay valores NaN, devolviendo una matriz de unos y ceros
NaN
octave:90> isnan(x)
ans =
isinf() chequea si hay valores Inf, devolviendo una matriz de unos y ceros
octave:91> isinf(x)
ans =
octave:94> isfinite(x)
ans =
octave:95> ischar(x)
ans = 0
octave:97> isglobal(y)
ans = 0
Pg -40-
Pg -41-
char(c1,c2) crea una matriz de caracteres, completando con blancos las cadenas
ms cortas
findstr(c1,c2) devuelve un vector con las posiciones iniciales de todas las veces
en que la cadena ms corta aparece en la ms larga
Pg -42-
mas
madera
octave:4>
a=[11,112,121,23];
#podemos
crear
los
caracteres
con
su
numero en ascii
octave:5> b=char(a)
b=
py_
octave:6> char(11)
ans=
octave:7> char(112)
ans = p
octave:8> char(121)
ans = y
octave:9> char(23)
ans = _
octave:10> double(b)
ans =
11
112
121
23
octave:11> c='espacios
'
c = espacios
octave:12> size(c)
ans =
12
octave:13> deblank(c)
#de
este
modo
podemos
eliminar
Pg -43-
los
a='en
un
lugar
de
la
mancha
de
cuyo
nombre
no
puedo
acordarme'
a = en un lugar de la mancha de cuyo nombre no puedo acordarme
octave:18> b='n';
octave:19> findstr(a,b)
ans =
21
34
41
octave:20> strmatch(a,b)
ans = [](0x0)
octave:21> strrep(a,b,'T')
ans = eT uT lugar de la maTcha de cuyo Tombre To puedo acordarme
Pg -44-
octave:25> rand(2,2,2)
ans =
ans(:,:,1) =
0.31106
0.70197
0.48694
0.45170
ans(:,:,2) =
0.017063
0.261818
0.234682
0.340703
Pg -45-
2.3. Estructuras
Una estructura (struct) es una agrupacin de datos de tipo diferente bajo un
mismo nombre. Estos datos se llaman miembros (members) o campos (fields). Una
estructura es un nuevo tipo de dato, del que luego se pueden crear muchas variables
(objetos o instances). Por ejemplo, la estructura alumno puede contener los campos
nombre (una cadena de caracteres) y carnet (un nmero).
Tambin puede crearse la estructura por medio de la funcin struct(), como por
ejemplo,
Pg -46-
Como hemos visto desde un inicio, GNU Octave trabaja con matrices, por lo tanto, todo
lo que veamos para un elemento es extrapolable a una matriz, vector o conjunto de
estos, por lo tanto, podemos hacer matrices de structs al igual que hemos hecho structs
de vectores/matrices.
isfield (expr, nombre) nos dice si la structura posee un campo con el nombre
indicado.
Pg -47-
{
[1,1] =
{
[1,1] =
Pg -48-
octave:44> vc(3)={rand(2,2)}
vc =
{
[1,1] =
0.39113
0.97938
0.41501
0.77790
{
[1,1] =
Pg -49-
octave:46> v{2}='escriche'
v =
{
[1,1] =
[1,2] = escriche
}
octave:48> c=cell(2,2)
c =
{
[1,1] = [](0x0)
[2,1] = [](0x0)
[1,2] = [](0x0)
[2,2] = [](0x0)
}
Pg -50-
{
[1,1] = jose maria
[2,1] = [](0x0)
[1,2] = [](0x0)
[2,2] = [](0x0)
}
octave:50> c{2,2}='azucar'
c =
{
[1,1] = jose maria
[2,1] = [](0x0)
[1,2] = [](0x0)
[2,2] = azucar
}
Pg -51-
Los bucles nos permiten realizar varias iteraciones de un mismo proceso, o sea, realizar
una misma operacin sobre distintos elementos. Podemos encontrar varios tipos de
bucles:
while
do-until
for
Adems de las sentencias break y continue utilizadas dentro de los bucles para salir del
proceso.
Pg -52-
3.1.1. Sentencia IF
Esta sentencia nos sirve para hacer bifurcaciones, podemos hacer 3 usos diferentes de
ella:
if (condition)
then-body
endif
if (condition)
then-body
else
else-body
endif
if (condition)
then-body
elseif (condition)
elseif-body
else
endif
Pg -53-
if A==B exige que todos los elementos sean iguales dos a dos
if A=B exige que todos los elementos sean diferentes dos a dos
switch expression
case label
command_list
case label
command_list
...
otherwise
#con
este
ltimo
agregamos
todas
las
posibilidades
que
no
se
Pg -54-
while (condition)
body
endwhile
Pg -55-
Pg -56-
ejecuta cada vez que se entra en GNU OCTAVE. En l puede introducir todos aquellos
comandos que le interesa se ejecuten siempre al iniciar la sesin, por ejemplo format
compact y los comandos necesarios para modificar el path.
Pg -57-
Pg -58-
el programa responde escribiendo las primeras lneas del fichero mi_func.m que
comienzan por el carcter #, es decir, que son comentarios.
Pg -59-
4. Grficos bidimensionales
A estas alturas, despus de ver cmo funciona este programa, a nadie le puede
resultar extrao que los grficos 2-D de GNU Octave estn fundamentalmente
orientados a la representacin grfica de vectores (y matrices). En el caso ms sencillo
los argumentos bsicos de la funcin plot van a ser vectores. Cuando una matriz
aparezca como argumento, se considerar como un conjunto de vectores columna (en
algunos casos tambin de vectores fila).
GNU Octave utiliza un tipo especial de ventanas para realizar las operaciones
grficas. Ciertos comandos abren una ventana nueva y otros dibujan sobre la ventana
activa, bien sustituyendo lo que hubiera en ella, bien aadiendo nuevos elementos
grficos a un dibujo anterior. Todo esto se ver con ms detalle en las siguientes
secciones.
Todo este sistema de grficos est implementado a partir de GNU Plot, por lo
que si fuera necesario, siempre podramos llamar directamente a este programa en vez
de dejar que sea Octave el que lo haga por nosotros.
plot()
loglog()
semilogx()
en el eje de abscisas
semilogy()
en el eje de ordenadas
En lo sucesivo se har referencia casi exclusiva a la primera de estas funciones
(plot). Las dems se pueden utilizar de un modo muy similar.
Pg -60-
title('ttulo')
xlabel('tal')
ylabel('cual')
se
escribe
en
las
coordenadas
correspondientes.
legend()
grid
Pg -61-
Ms adelante se ver que con la funcin hold pueden aadirse grficos a una
figura ya existente respetando su contenido.
Pg -62-
El resultado de este comando es que se abre una ventana. Por defecto, los
distintos puntos del grfico se unen con una lnea continua. Tambin por defecto, el
color que se utiliza para la primera lnea es el rojo.
Cuando a la funcin plot() se le pasa un nico vector real como argumento,
dicha funcin dibuja en ordenadas el valor de los n elementos del vector frente a los
ndices 1, 2, ... n del mismo en abscisas. Ms adelante se ver que si el vector es
complejo, el funcionamiento es bastante diferente.
Pg -63-
Ahora se va a ver lo que pasa con los vectores complejos. Si se pasan a plot()
arios vectores complejos como argumentos, GNU Octave simplemente representa las
partes reales y desprecia las partes imaginarias.
octave:12> a=rand(3,3)+rand(3,3)*i;
octave:13> plot(a)
Pg -64-
plot(A)
plot(x,A)
plot(A,x)
plot(A,B)
Pg -65-
Color
Smbolo
Marcadores
yellow
puntos
magenta
cyan
crculos
marcas en x
r ed
marcas en +
green
marcas en *
blue
marcas
cuadradas (square)
white
marcas
en
diamante (diamond)
k
black
tringulo
apuntando arriba
Pg -66-
Pg -67-
mientras que :
axis(auto)
Pg -68-
Pg -69-
bar()
barh()
bar3()
bar3h()
pie()
pie3()
area()
stairs()
errorbar()
compass()
feather()
de
vectores
partiendo
de
orgenes
hist()
Pg -70-
Pg -71-
5. Grficos tridimensionales
Quizs sea sta una de las caractersticas de GNU OCTAVE que ms
admiracin despierta entre los usuarios no tcnicos (cualquier alumno de ingeniera sabe
que hay ciertas operaciones algebraicas como la descomposicin de valor singular, sin ir
ms lejos, que tienen dificultades muy superiores, aunque "luzcan" menos).
Ahora se ver cmo se representa una funcin de dos variables. Para ello se
va a definir una funcin de este tipo en un fichero llamado test3d.m. La frmula ser la
siguiente:
Pg -72-
Estos son unos ejemplos de las posibilidades que GNU Octave ofrece para el uso
de grficos 3-D.
Pg -73-
que dibuja una lnea que une los puntos (x(1), y(1), z(1)), (x(2), y(2), z(2)), etc.
Y la proyecta sobre un plano para poderla representar en la pantalla. Al igual que en el
caso plano, se puede incluir una cadena de 1, 2 3 caracteres para determinar el color,
los markers, y el tipo de lnea:
octave:82>plot3(x,y,z,s)
en cuyo caso se dibujan tantas lneas como columnas tienen estas 3 matrices,
cada una de las cuales est definida por las 3 columnas homlogas de dichas matrices.
A continuacin se va a realizar un ejemplo sencillo consistente en dibujar un
cubo. Para ello se crear una matriz que contenga las aristas correspondientes, definidas
mediante los vrtices del cubo como una lnea poligonal continua (obsrvese que
algunas aristas se dibujan dos veces). La matriz A cuyas columnas son las coordenadas
de los vrtices, y cuyas filas son las coordenadas x, y y z de los mismos:
octave:86>A=[0 1 1 0 0 0 1 0 1 1 0 0 1 1 1 1 0 0
0 0 1 1 0 0 0 0 0 1 1 0 0 0 1 1 1 1
0 0 0 0 0 1 1 1 1 1 1 1 1 0 0 1 1 0];
Ahora basta ejecutar los comandos siguientes (el trasponer los vectores en este
caso es opcional):
octave:87>plot3(A(1,:)',A(2,:)',A(3,:)')
Pg -74-
closeplot
u=-8:0.5:8; v=u;
[U,V]=meshgrid(u,v);
R=sqrt(U.^2+V.^2)+eps;
Pg -75-
Pg -76-
contour(Z, val)
Pg -77-
axis([xmin,xmax,ymin,ymax,zmin,zmax])
Pg -78-
octave:2>save
Pg -79-
Pg -80-
octave:32>diary filename
Pg -81-
Pg -82-
6.4.2
Integracin
Numrica
de
Ecuaciones
Diferenciales
Ordinarias
GNU Octave dispone de varias funciones capaces de realizar la integracin de
ecuaciones diferenciales; si hacemos uso del fichero tiropar.m:
function deriv=tiropar(t,y)
fac=-(0.001/1.0)*sqrt((y(1)^2+y(2)^2));
deriv=zeros(4,1);
deriv(1)=fac*y(1);
deriv(2)=fac*y(2)-9.8;
deriv(3)=y(1);
deriv(4)=y(2);
end
donde se han supuesto unas constantes con los valores de c=0.001, m=1 y g=9.8.
Falta fijar los valores iniciales de posicin y velocidad. Se supondr que el proyectil
parte del origen con una velocidad de 100 m/seg y con un ngulo de 30, lo que conduce
a los valores iniciales siguientes:
u(0)=100*cos(pi/6), v(0)=100*sin(pi/6), x(0)=0, y(0)=0.
Los comandos para realizar la integracin son los siguientes (se podran agrupar en un
fichero llamado tiroparMain.m):
t0=0;
tf=9;
y0=[100*cos(pi/6) 100*sin(pi/6) 0 0]';
[t,Y]=ode23('tiropar',[t0,tf],y0);
plot(t,Y(:,4))
Pg -83-
GNUFreeDocumentationLicense
GNUFreeDocumentationLicense
Version1.2,November2002
Copyright(C)2000,2001,2002FreeSoftwareFoundation,Inc.
51FranklinSt,FifthFloor,Boston,MA021101301USA
Everyoneispermittedtocopyanddistributeverbatimcopies
ofthislicensedocument,butchangingitisnotallowed.
0.PREAMBLE
ThepurposeofthisLicenseistomakeamanual,textbook,orotherfunctionalandusefuldocument
"free"inthesenseoffreedom:toassureeveryonetheeffectivefreedomtocopyandredistributeit,
withorwithoutmodifyingit,eithercommerciallyornoncommercially.
Secondarily,thisLicensepreservesfortheauthorandpublisherawaytogetcreditfortheirwork,
whilenotbeingconsideredresponsibleformodificationsmadebyothers.
ThisLicenseisakindof"copyleft",whichmeansthatderivativeworksofthedocumentmust
themselvesbefreeinthesamesense.ItcomplementstheGNUGeneralPublicLicense,whichisa
copyleftlicensedesignedforfreesoftware.
WehavedesignedthisLicenseinordertouseitformanualsforfreesoftware,becausefreesoftware
needsfreedocumentation:afreeprogramshouldcomewithmanualsprovidingthesamefreedoms
thatthesoftwaredoes.ButthisLicenseisnotlimitedtosoftwaremanuals;itcanbeusedforany
textual work, regardless of subject matter or whether it is published as a printed book. We
recommendthisLicenseprincipallyforworkswhosepurposeisinstructionorreference.
1.APPLICABILITYANDDEFINITIONS
ThisLicenseappliestoanymanualorotherwork,inanymedium,thatcontainsanoticeplacedby
thecopyrightholdersayingitcanbedistributedunderthetermsofthisLicense. Suchanotice
grants a worldwide, royaltyfree license, unlimited in duration, to use that work under the
conditionsstatedherein.The"Document",below,referstoanysuchmanualorwork.Anymember
ofthepublicisalicensee,andisaddressedas"you".Youacceptthelicenseifyoucopy,modifyor
distributetheworkinawayrequiringpermissionundercopyrightlaw.
A"ModifiedVersion"oftheDocumentmeansanyworkcontainingtheDocumentoraportionofit,
eithercopiedverbatim,orwithmodificationsand/ortranslatedintoanotherlanguage.
A"SecondarySection"isanamedappendixorafrontmattersectionoftheDocumentthatdeals
exclusivelywiththerelationshipofthepublishersorauthorsoftheDocumenttotheDocument's
overallsubject(ortorelatedmatters)andcontainsnothingthatcouldfalldirectlywithinthatoverall
subject.(Thus,iftheDocumentisinpartatextbookofmathematics,aSecondarySectionmaynot
explainanymathematics.) Therelationshipcouldbeamatterofhistoricalconnectionwiththe
subjectorwithrelatedmatters,oroflegal,commercial,philosophical,ethicalorpoliticalposition
regardingthem.
The"InvariantSections"arecertainSecondarySectionswhosetitlesaredesignated,asbeingthose
ofInvariantSections,inthenoticethatsaysthattheDocumentisreleasedunderthisLicense.Ifa
sectiondoesnotfittheabovedefinitionofSecondarythenitisnotallowedtobedesignatedas
Invariant.TheDocumentmaycontainzeroInvariantSections.IftheDocumentdoesnotidentify
anyInvariantSectionsthentherearenone.
The"CoverTexts"arecertainshortpassagesoftextthatarelisted,asFrontCoverTextsorBack
CoverTexts,inthenoticethatsaysthattheDocumentisreleasedunderthisLicense.AFrontCover
Textmaybeatmost5words,andaBackCoverTextmaybeatmost25words.
A"Transparent"copyoftheDocumentmeansamachinereadablecopy,representedinaformat
whosespecificationisavailabletothegeneralpublic,thatissuitableforrevisingthedocument
straightforwardly with generic text editors or (for images composed of pixels) generic paint
programsor(fordrawings)somewidelyavailabledrawingeditor,andthatissuitableforinputto
text formatters or for automatic translation to a variety of formats suitable for input to text
formatters. AcopymadeinanotherwiseTransparentfileformatwhosemarkup,orabsenceof
markup, has been arranged to thwart or discourage subsequent modification by readers is not
Transparent.AnimageformatisnotTransparentifusedforanysubstantialamountoftext.Acopy
thatisnot"Transparent"iscalled"Opaque".
ExamplesofsuitableformatsforTransparentcopiesincludeplainASCIIwithoutmarkup,Texinfo
inputformat,LaTeXinputformat,SGMLorXMLusingapubliclyavailableDTD,andstandard
conforming simple HTML, PostScript or PDF designed for humanmodification. Examples of
transparent image formats include PNG, XCF and JPG. Opaque formats include proprietary
formatsthatcanbereadandeditedonlybyproprietarywordprocessors,SGMLorXMLforwhich
theDTDand/orprocessingtoolsarenotgenerallyavailable,andthemachinegeneratedHTML,
PostScriptorPDFproducedbysomewordprocessorsforoutputpurposesonly.
The"TitlePage"means,foraprintedbook,thetitlepageitself,plussuchfollowingpagesasare
neededtohold,legibly,thematerialthisLicenserequirestoappearinthetitlepage.Forworksin
formats which do not have any title page as such, "Title Page" means the text near the most
prominentappearanceofthework'stitle,precedingthebeginningofthebodyofthetext.
Asection"EntitledXYZ"meansanamedsubunitoftheDocumentwhosetitleeitherisprecisely
XYZorcontainsXYZinparenthesesfollowingtextthattranslatesXYZinanotherlanguage.(Here
XYZ stands for a specific section name mentioned below, such as "Acknowledgements",
"Dedications","Endorsements",or"History".)To"PreservetheTitle"ofsuchasectionwhenyou
modifytheDocumentmeansthatitremainsasection"EntitledXYZ"accordingtothisdefinition.
TheDocumentmayincludeWarrantyDisclaimersnexttothenoticewhichstatesthatthisLicense
appliestotheDocument.TheseWarrantyDisclaimersareconsideredtobeincludedbyreferencein
thisLicense,butonlyasregardsdisclaimingwarranties:anyotherimplicationthattheseWarranty
DisclaimersmayhaveisvoidandhasnoeffectonthemeaningofthisLicense.
2.VERBATIMCOPYING
You may copy and distribute the Document in any medium, either commercially or
noncommercially,providedthatthisLicense,thecopyrightnotices,andthelicensenoticesaying
this License applies to the Document are reproduced in all copies, and that you add no other
conditionswhatsoevertothoseofthisLicense.Youmaynotusetechnicalmeasurestoobstructor
controlthereadingorfurthercopyingofthecopiesyoumakeordistribute. However,youmay
acceptcompensationinexchangeforcopies.Ifyoudistributealargeenoughnumberofcopiesyou
mustalsofollowtheconditionsinsection3.
Youmayalsolendcopies,underthesameconditionsstatedabove,andyoumaypubliclydisplay
copies.
3.COPYINGINQUANTITY
If you publish printed copies (or copies in media that commonly have printed covers) of the
Document,numberingmorethan100,andtheDocument'slicensenoticerequiresCoverTexts,you
mustenclosethecopiesincoversthatcarry,clearlyandlegibly,alltheseCoverTexts:FrontCover
Textsonthefrontcover,andBackCoverTextsonthebackcover.Bothcoversmustalsoclearlyand
legiblyidentifyyouasthepublisherofthesecopies.Thefrontcovermustpresentthefulltitlewith
allwordsofthetitleequallyprominentandvisible.Youmayaddothermaterialonthecoversin
addition. Copyingwithchanges limited tothecovers,as longas theypreservethe titleof the
Documentandsatisfytheseconditions,canbetreatedasverbatimcopyinginotherrespects.
Iftherequiredtextsforeithercoveraretoovoluminoustofitlegibly,youshouldputthefirstones
listed(asmanyasfitreasonably)ontheactualcover,andcontinuetherestontoadjacentpages.
IfyoupublishordistributeOpaquecopiesoftheDocumentnumberingmorethan100,youmust
eitherincludeamachinereadableTransparentcopyalongwitheachOpaquecopy,orstateinor
witheachOpaquecopyacomputernetworklocationfromwhichthegeneralnetworkusingpublic
hasaccesstodownloadusingpublicstandardnetworkprotocolsacompleteTransparentcopyofthe
Document,freeofaddedmaterial.Ifyouusethelatteroption,youmusttakereasonablyprudent
steps,whenyoubegindistributionofOpaquecopiesinquantity,toensurethatthisTransparentcopy
willremainthusaccessibleatthestatedlocationuntilatleastoneyearafterthelasttimeyou
distributeanOpaquecopy(directlyorthroughyouragentsorretailers)ofthateditiontothepublic.
It is requested, but not required, that you contact the authors of the Document well before
redistributinganylargenumberofcopies,togivethemachancetoprovideyouwithanupdated
versionoftheDocument.
4.MODIFICATIONS
YoumaycopyanddistributeaModifiedVersionoftheDocumentundertheconditionsofsections
2and3above,providedthatyoureleasetheModifiedVersionunderpreciselythisLicense,withthe
ModifiedVersionfillingtheroleoftheDocument,thuslicensingdistributionandmodificationof
theModifiedVersiontowhoeverpossessesacopyofit.Inaddition,youmustdothesethingsinthe
ModifiedVersion:
A.UseintheTitlePage(andonthecovers,ifany)atitledistinctfromthatoftheDocument,and
fromthoseofpreviousversions(whichshould,iftherewereany,belistedintheHistorysection
oftheDocument).Youmayusethesametitleasapreviousversioniftheoriginalpublisherofthat
versiongivespermission.
B.ListontheTitlePage,asauthors,oneormorepersonsorentitiesresponsibleforauthorshipof
themodificationsintheModifiedVersion,togetherwithatleastfiveoftheprincipalauthorsofthe
Document(allofitsprincipalauthors,ifithasfewerthanfive),unlesstheyreleaseyoufromthis
requirement.
C.StateontheTitlepagethenameofthepublisheroftheModifiedVersion,asthepublisher.
D.PreserveallthecopyrightnoticesoftheDocument.
E. Add an appropriate copyright notice for your modifications adjacent to the other copyright
notices.
F.Include,immediatelyafterthecopyrightnotices,alicensenoticegivingthepublicpermissionto
usetheModifiedVersionunderthetermsofthisLicense,intheformshownintheAddendum
below.
G.PreserveinthatlicensenoticethefulllistsofInvariantSectionsandrequiredCoverTextsgiven
intheDocument'slicensenotice.
H.IncludeanunalteredcopyofthisLicense.
I.PreservethesectionEntitled"History",PreserveitsTitle,andaddtoitanitemstatingatleastthe
title,year,newauthors,andpublisheroftheModifiedVersionasgivenontheTitlePage.Ifthereis
no section Entitled "History" in the Document, create one stating the title, year, authors, and
publisheroftheDocumentasgivenonitsTitlePage,thenaddanitemdescribingtheModified
Versionasstatedintheprevioussentence.
J.Preservethenetworklocation,ifany,givenintheDocumentforpublicaccesstoaTransparent
copyoftheDocument,andlikewisethenetworklocationsgivenintheDocumentforprevious
versionsitwasbasedon.Thesemaybeplacedinthe"History"section.Youmayomitanetwork
locationforaworkthatwaspublishedatleastfouryearsbeforetheDocumentitself,orifthe
originalpublisheroftheversionitreferstogivespermission.
K.ForanysectionEntitled"Acknowledgements"or"Dedications",PreservetheTitleofthesection,
andpreserveinthesectionallthesubstanceandtoneofeachofthecontributoracknowledgements
and/ordedicationsgiventherein.
L.PreservealltheInvariantSectionsoftheDocument,unalteredintheirtextandintheirtitles.
Sectionnumbersortheequivalentarenotconsideredpartofthesectiontitles.
M. Delete any section Entitled "Endorsements". Such a section may not be included in the
ModifiedVersion.
N.DonotretitleanyexistingsectiontobeEntitled"Endorsements"ortoconflictintitlewithany
InvariantSection.
O.PreserveanyWarrantyDisclaimers.
IftheModifiedVersionincludesnewfrontmattersectionsorappendicesthatqualifyasSecondary
SectionsandcontainnomaterialcopiedfromtheDocument,youmayatyouroptiondesignate
someorallofthesesectionsasinvariant.Todothis,addtheirtitlestothelistofInvariantSections
intheModifiedVersion'slicensenotice.Thesetitlesmustbedistinctfromanyothersectiontitles.
YoumayaddasectionEntitled"Endorsements",provideditcontainsnothingbutendorsementsof
yourModifiedVersionbyvariouspartiesforexample,statementsofpeerrevieworthatthetexthas
beenapprovedbyanorganizationastheauthoritativedefinitionofastandard.
YoumayaddapassageofuptofivewordsasaFrontCoverText,andapassageofupto25words
asaBackCoverText,totheendofthelistofCoverTextsintheModifiedVersion. Onlyone
passageofFrontCoverTextandoneofBackCoverTextmaybeaddedby(orthrougharrangements
made by) any one entity. If the Document already includes a cover text for the same cover,
previouslyaddedbyyouorbyarrangementmadebythesameentityyouareactingonbehalfof,you
maynotaddanother;butyoumayreplacetheoldone,onexplicitpermissionfromtheprevious
publisherthataddedtheoldone.
Theauthor(s)andpublisher(s)oftheDocumentdonotbythisLicensegivepermissiontousetheir
namesforpublicityforortoassertorimplyendorsementofanyModifiedVersion.
5.COMBININGDOCUMENTS
YoumaycombinetheDocumentwithotherdocumentsreleasedunderthisLicense,undertheterms
definedinsection4aboveformodifiedversions,providedthatyouincludeinthecombinationallof
theInvariantSectionsofalloftheoriginaldocuments,unmodified,andlistthemallasInvariant
Sections of your combinedworkinits licensenotice,andthatyoupreservealltheirWarranty
Disclaimers.
ThecombinedworkneedonlycontainonecopyofthisLicense,andmultipleidenticalInvariant
Sectionsmaybereplacedwithasinglecopy.IftherearemultipleInvariantSectionswiththesame
namebutdifferentcontents,makethetitleofeachsuchsectionuniquebyaddingattheendofit,in
parentheses,thenameoftheoriginalauthororpublisherofthatsectionifknown,orelseaunique
number.MakethesameadjustmenttothesectiontitlesinthelistofInvariantSectionsinthelicense
noticeofthecombinedwork.
In the combination, you must combine any sections Entitled "History" in the various original
documents, forming one section Entitled "History"; likewise combine any sections Entitled
"Acknowledgements", and any sections Entitled "Dedications". You must delete all sections
Entitled"Endorsements".
6.COLLECTIONSOFDOCUMENTS
YoumaymakeacollectionconsistingoftheDocumentandotherdocumentsreleasedunderthis
License,andreplacetheindividualcopiesofthisLicenseinthevariousdocumentswithasingle
copy that is included in the collection, provided that you follow the rules of this License for
verbatimcopyingofeachofthedocumentsinallotherrespects.
Youmayextractasingledocumentfromsuchacollection,anddistributeitindividuallyunderthis
License,providedyouinsertacopyofthisLicenseintotheextracteddocument,andfollowthis
Licenseinallotherrespectsregardingverbatimcopyingofthatdocument.
7.AGGREGATIONWITHINDEPENDENTWORKS
AcompilationoftheDocumentoritsderivativeswithotherseparateandindependentdocumentsor
works, in or on a volume of a storage or distribution medium, is called an "aggregate" if the
copyrightresultingfromthecompilationisnotusedtolimitthelegalrightsofthecompilation's
usersbeyondwhattheindividualworkspermit.WhentheDocumentisincludedinanaggregate,
thisLicensedoesnotapplytotheotherworksintheaggregatewhicharenotthemselvesderivative
worksoftheDocument.
IftheCoverTextrequirementofsection3isapplicabletothesecopiesoftheDocument,thenifthe
Documentislessthanonehalfoftheentireaggregate,theDocument'sCoverTextsmaybeplaced
oncoversthatbrackettheDocumentwithintheaggregate,ortheelectronicequivalentofcoversif
theDocumentisinelectronicform.Otherwisetheymustappearonprintedcoversthatbracketthe
wholeaggregate.
8.TRANSLATION
Translationisconsideredakindofmodification,soyoumaydistributetranslationsoftheDocument
under the terms of section 4. Replacing Invariant Sections with translations requires special
permissionfromtheircopyrightholders,butyoumayincludetranslationsofsomeorallInvariant
Sections in addition to the original versions of these Invariant Sections. You may include a
translation of this License, and all the license notices in the Document, and any Warranty
Disclaimers,providedthatyoualsoincludetheoriginalEnglishversionofthisLicenseandthe
originalversionsofthosenoticesanddisclaimers.Incaseofadisagreementbetweenthetranslation
andtheoriginalversionofthisLicenseoranoticeordisclaimer,theoriginalversionwillprevail.
If a section intheDocumentisEntitled"Acknowledgements","Dedications", or"History", the
requirement(section4)toPreserveitsTitle(section1)willtypicallyrequirechangingtheactual
title.
9.TERMINATION
Youmaynotcopy,modify,sublicense,ordistributetheDocumentexceptasexpresslyprovidedfor
underthisLicense. Anyotherattempttocopy,modify,sublicenseordistributetheDocumentis
void,andwillautomaticallyterminateyourrightsunderthisLicense.However,partieswhohave
receivedcopies,orrights,fromyouunderthisLicensewillnothavetheirlicensesterminatedso
longassuchpartiesremaininfullcompliance.
10.FUTUREREVISIONSOFTHISLICENSE
TheFreeSoftwareFoundationmaypublishnew,revisedversionsoftheGNUFreeDocumentation
Licensefromtimetotime.Suchnewversionswillbesimilarinspirittothepresentversion,but
maydifferindetailtoaddressnewproblemsorconcerns.Seehttp://www.gnu.org/copyleft/.
EachversionoftheLicenseisgivenadistinguishingversionnumber.IftheDocumentspecifiesthat
aparticularnumberedversionofthisLicense"oranylaterversion"appliestoit,youhavetheoption
offollowingthetermsandconditionseitherofthatspecifiedversionorofanylaterversionthathas
beenpublished(notasadraft)bytheFreeSoftwareFoundation.IftheDocumentdoesnotspecify
aversionnumberofthisLicense,youmaychooseanyversioneverpublished(notasadraft)bythe
FreeSoftwareFoundation.