getoptions

(No se recomienda) Obtener opciones para un objeto de gráfica de análisis lineal

getoptions no se recomienda. Obtenga opciones de gráfica accediendo a las propiedades del objeto de gráfico usando la notación de puntos. Para obtener más información, consulte No recomendado.

getoptions todavía se recomienda para idplot y spectrumplot. Para más información, consulte getoptions (System Identification Toolbox).

Sintaxis

opts = getoptions(plotobj)

optValue = getoptions(plotobj,option)

Descripción

opts = getoptions(plotobj) devuelve las opciones para la gráfica asociada con el objeto de gráfico de análisis lineal plotobj.

• Puede utilizar opts cuando se crean nuevas gráficas del mismo tipo que plotobj.

• Para personalizar una gráfica existente, puede modificar opts y luego utilizar el objeto de opciones resultante con setoptions.

optValue = getoptions(plotobj,option) devuelve la opción específica, option, para la gráfica asociada con el objeto de gráfico plotobj.

Ejemplos

Gráfica de impulso con un color de cuadrícula especificado

Para este ejemplo, considere el modelo de espacio de estados MIMO con 3 entradas, 3 salidas y 3 estados. Cree una gráfica de impulso con líneas de cuadrícula de color rojo.

Cree el modelo de espacio de estados MIMO sys_mimo.

J = [8 -3 -3; -3 8 -3; -3 -3 8];
F = 0.2*eye(3);
A = -J\F;
B = inv(J);
C = eye(3);
D = 0;
sys_mimo = ss(A,B,C,D);
size(sys_mimo)

Cree una gráfica de impulso con el identificador de gráfica h y utilice getoptions para una lista de las opciones disponibles.

h = impulseplot(sys_mimo)

p = getoptions(h)

Utilice setoptions para actualizar la gráfica con la personalización necesaria.

setoptions(h,'Grid','on','GridColor',[1 0 0]);

La gráfica de impulso se actualiza automáticamente cuando se llama a setoptions. En el caso de modelos MIMO, impulseplot genera una cuadrícula de gráficas y cada gráfica muestra la respuesta al impulso de un par de E/S.

Argumentos de entrada

plotobj — Gráfica

objeto de gráfico

Gráfica, especificada como uno de los siguientes objetos de gráfico.

Objeto de gráfico	Descripción
impulseplot	Respuesta al impulso
initialplot	Respuesta a la condición inicial
lsimplot	Respuesta en el tiempo simulada a entradas arbitrarias
stepplot	Gráfica de escalón
bodeplot	Gráfica de respuesta en frecuencia
nicholsplot	Gráfica Nichols
nyquistplot	Diagrama de Nyquist
sigmaplot	Gráfica de valores singulares
pzplot	Gráfica de impulso
iopzplot	Mapa de polos y ceros para pares entrada-salida
rlocusplot	Gráfica del lugar de las raíces
hsvplot	Gráfica de valores singulares de Hankel

option — Nombre de la opción

cadena | vector de caracteres

Nombre de la opción, especificado como una cadena o un vector de caracteres. Para ver las opciones admitidas para un tipo de gráfica concreto, consulte la página del correspondiente objeto de opciones que se indica en opts.

Argumentos de salida

opts — Opciones de gráficas

objeto de opciones de gráficas

Opciones de gráficas, devueltas como uno de los siguientes objetos de opciones de gráficas dependiendo del objeto de gráfico especificado en plotobj.

Objeto de opciones	Tipo plotobj
timeoptions	impulseplot initialplot lsimplot stepplot
bodeoptions	bodeplot
nicholsoptions	nicholsplot
nyquistoptions	nyquistplot
sigmaoptions	sigmaplot
pzoptions	iopzplot pzplot rlocusplot
hsvoptions	hsvplot

optValue — Valor de las opciones

escalar | vector | vector de caracteres | valor lógico | estructura | arreglo de celdas

Valor de la opción, devuelto como un escalar, un vector, un vector de caracteres, un valor lógico, una estructura o un arreglo de celdas según la opción especificada en option.

Funcionalidad alternativa

También puede obtener valores de propiedades de objetos de gráfica de análisis lineal usando la notación de puntos. Por ejemplo, obtenga las unidades de fase para un diagrama de Bode.

bp = bodeplot(sys);
phaseUnits = bp.PhaseUnits;

Historial de versiones

Introducido antes de R2006a

R2024b: No recomendado

getoptions no se recomienda. Obtenga opciones de gráfica accediendo a las propiedades del objeto de gráfico usando la notación de puntos. getoptions sigue funcionando.

Esta tabla muestra algunos usos habituales de getoptions y cómo actualizar el código para acceder a las propiedades del objeto de gráfico en su lugar. Algunos nombres de propiedades de objeto de gráfico no coinciden con el nombre de opción correspondiente para getoptions.

Si el código tiene esta forma:	Use este código en su lugar:
bp = bodeplot(sys); phaseUnits = getoptions(bp,"PhaseUnits");	bp = bodeplot(sys); phaseUnits = bp.PhaseUnits;
bp = bodeplot(sys); phaseUnits = getoptions(bp,"FreqScale");	bp = bodeplot(sys); phaseUnits = bp.FrequencyScale;

Consulte también

setoptions

Temas

• Customize Linear Analysis Plots at Command Line