Contenido principal

pzplot

Representar un mapa de polos y ceros del sistema dinámico

    Descripción

    La función pzplot representa el mapa de polos y ceros del modelo de sistema dinámico y devuelve un objeto de gráfico PZPlot. Para personalizar la gráfica, modifique las propiedades del objeto de gráfico utilizando la notación de puntos. Para obtener más información, consulte Customize Linear Analysis Plots at Command Line.

    La figura muestra mapas de polos y ceros para un modelo lineal variante en el tiempo de tiempo continuo (izquierda) y tiempo discreto (derecha). En los mapas, x y o representan polos y ceros, respectivamente.

    • En sistemas de tiempo continuo, todos los polos en el plano s complejo deben estar en la mitad izquierda del plano (región azul) para garantizar la estabilidad. El sistema es marginalmente estable si los distintos polos se encuentran en el eje imaginario, es decir, si las partes reales de los polos son cero.

    • En sistemas de tiempo discreto, todos los polos en el plano z complejo deben estar dentro del círculo unitario (región azul). El sistema es marginalmente estable si tiene uno o más polos situados en el círculo unitario.

    Para obtener las ubicaciones de los polos y los ceros, utilice la función pzmap.

    Creación

    Descripción

    pzp = pzplot(sys) representa los polos y los ceros de transmisión del modelo de sistema dinámico sys, y devuelve el objeto de gráfico correspondiente. En la gráfica, x y o representan polos y ceros, respectivamente.

    ejemplo

    pzp = pzplot(sys1,sys2,...,sysN) muestra los polos y los ceros de transmisión de varios modelos en una sola gráfica.

    ejemplo

    pzp = pzplot(sys1,ColorSpec1,...,sysN,ColorSpecN) establece el color para la gráfica de cada sistema.

    ejemplo

    pzp = pzplot(___,plotoptions) representa los polos y los ceros de transmisión con las opciones de gráfica indicadas en plotoptions. La configuración que especifica en plotoptions anula las preferencias de representación gráfica de la sesión de MATLAB® en curso. Puede utilizar plotoptions con cualquiera de las combinaciones de argumentos de entrada de sintaxis anteriores.

    ejemplo

    pzp = pzplot(parent,___) representa los polos y ceros en el contenedor de gráficos principal especificado, como un objeto Figure o TiledChartLayout, y establece la propiedad Parent. Utilice esta sintaxis cuando desee crear una gráfica en una figura abierta especificada o cuando cree aplicaciones en App Designer.

    Argumentos de entrada

    expandir todo

    Sistema dinámico, especificado como un modelo de sistema dinámico SISO o MIMO, o bien un arreglo de modelos de sistemas dinámicos. Puede utilizar los siguientes tipos de sistemas dinámicos:

    • Modelos LTI numéricos en tiempo continuo o en tiempo discreto, como modelos tf, zpk o ss.

    • Modelos dispersos en espacio de estados, como modelos sparss o mechss.

    • Modelos LTI generalizados o con incertidumbre, como modelos genss o uss (Robust Control Toolbox). El uso de modelos con incertidumbre requiere Robust Control Toolbox™.

      • En el caso de bloques de diseño de control ajustables, la función evalúa el modelo con su valor actual para representar la respuesta.

      • En el caso de los bloques de diseño de control con incertidumbre, la función representa el valor nominal y muestras aleatorias del modelo.

    • Modelos LTI identificados, como modelos idtf (System Identification Toolbox), idss (System Identification Toolbox) o idproc (System Identification Toolbox). El uso de modelos identificados requiere System Identification Toolbox™.

    Si sys es un arreglo de modelos, la gráfica muestra las respuestas de todos los modelos del arreglo en los mismos ejes.

    Color, especificado como uno de los siguientes valores.

    ColorDescripción
    "r"rojo
    "g"verde
    "b"azul
    "c"cian
    "m"magenta
    "y"amarillo
    "k"negro
    "w"blanco

    Opciones de las gráficas de polos y ceros, especificadas como un objeto pzoptions. Puede utilizar estas opciones para personalizar el aspecto de la gráfica PZ. La configuración que especifica en plotoptions anula la configuración de preferencias de la sesión de MATLAB en curso.

    Contenedor de gráficas principal, especificado como uno de estos objetos:

    • Figure

    • TiledChartLayout

    • UIFigure

    • UIGridLayout

    • UIPanel

    • UITab

    También puede especificar parent como un objeto Axes o UIAxes, que establece la gráfica principal como gráfica principal del objeto ejes especificado.

    Propiedades

    expandir todo

    Nota

    Las propiedades que aparecen aquí son solo un subconjunto. Para obtener una lista completa, consulte PZPlot Properties.

    Respuestas de modelos, especificadas como un objeto PZResponse o un arreglo de dichos objetos. Utilice esta propiedad para modificar el modelo de sistema dinámico o el aspecto de cada respuesta en la gráfica. Cada objeto PZResponse tiene estas propiedades.

    Fuente de datos de la respuesta, especificada como una estructura con estos campos.

    Sistema dinámico, especificado como un modelo de sistema dinámico SISO o MIMO, o bien un arreglo de modelos de sistemas dinámicos.

    Cuando se crea inicialmente una gráfica, Model coincide con el valor especificado para sys.

    Nombre de la respuesta, especificado como una cadena o un vector de caracteres y almacenado como una cadena.

    Visibilidad de la respuesta, especificada como uno de estos valores lógicos on/off:

    • "on", 1 o true: muestra la respuesta en la gráfica.

    • "off", 0 o false: no muestra la respuesta en la gráfica.

    El valor se almacena como un valor lógico on/off de tipo matlab.lang.OnOffSwitchState.

    Opción de incluir la respuesta en la leyenda, especificada como uno de estos valores lógicos on/off:

    • "on", 1 o true: incluye la respuesta en la leyenda.

    • "off", 0 o false: no incluye la respuesta en la leyenda.

    El valor se almacena como un valor lógico on/off de tipo matlab.lang.OnOffSwitchState.

    Color de la gráfica, especificado como un triplete RGB o un código de color hexadecimal y almacenado como un triplete RGB.

    Como alternativa, puede especificar algunos colores comunes por su nombre. Esta tabla enumera colores y sus correspondientes tripletes RGB y códigos de color hexadecimales.

    Nombre del colorTriplete RGBCódigo de color hexadecimal

    "red" o "r"

    [1 0 0]#FF0000

    "green" o "g"

    [0 1 0]#00FF00

    "blue" o "b"

    [0 0 1]#0000FF

    "cyan" o "c"

    [0 1 1]#00FFFF

    "magenta" o "m"

    [1 0 1]#FF00FF

    "yellow" o "y"

    [1 1 0]#FFFF00

    "black" o "k"

    [0 0 0]#000000

    "white" o "w"

    [1 1 1]#FFFFFF

    Tamaño del marcador, especificado como un escalar positivo.

    Ancho de línea, especificado como un escalar positivo.

    Unidades de tiempo, especificadas como uno de estos valores:

    • "nanoseconds"

    • "microseconds"

    • "milliseconds"

    • "seconds"

    • "minutes"

    • "hours"

    • "days"

    • "weeks"

    • "months"

    • "years"

    Dependencias

    De forma predeterminada, la respuesta utiliza las unidades de tiempo del sistema lineal de la gráfica. Puede anular las unidades predeterminadas especificando las preferencias de la toolbox. Para obtener más información, consulte Specify Toolbox Preferences for Linear Analysis Plots.

    Unidades de frecuencia, especificadas como uno de estos valores:

    • "Hz"

    • "rad/s"

    • "rpm"

    • "kHz"

    • "MHz"

    • "GHz"

    • "rad/nanosecond"

    • "rad/microsecond"

    • "rad/millisecond"

    • "rad/minute"

    • "rad/hour"

    • "rad/day"

    • "rad/week"

    • "rad/month"

    • "rad/year"

    • "cycles/nanosecond"

    • "cycles/microsecond"

    • "cycles/millisecond"

    • "cycles/hour"

    • "cycles/day"

    • "cycles/week"

    • "cycles/month"

    • "cycles/year"

    Dependencias

    De forma predeterminada, la respuesta utiliza las unidades de frecuencia del sistema lineal de la gráfica. Puede anular las unidades predeterminadas especificando las preferencias de la toolbox. Para obtener más información, consulte Specify Toolbox Preferences for Linear Analysis Plots.

    Visibilidad de la gráfica, especificada como uno de estos valores lógicos on/off:

    • "on", 1 o true: muestra la gráfica.

    • "off", 0 o false: oculta la gráfica sin eliminarla. Puede seguir accediendo a las propiedades de la gráfica aunque no esté visible.

    El valor se almacena como un valor lógico on/off de tipo matlab.lang.OnOffSwitchState.

    Funciones del objeto

    addResponseAdd dynamic system response to existing response plot

    Ejemplos

    contraer todo

    Represente los polos y ceros del sistema en tiempo continuo representado por la siguiente función de transferencia:

    sys(s)=2s2+5s+1s2+3s+5.

    sys = tf([2 5 1],[1 3 5]);
    pzp = pzplot(sys);
    grid on

    MATLAB figure

    Al activar la cuadrícula se muestran líneas de coeficiente de amortiguación constante (zeta) y líneas de frecuencia natural constante (wn). Este sistema tiene dos ceros reales, marcados con o en la gráfica. El sistema también tiene un par de polos complejos, marcados con x.

    Cambie el color del título de la gráfica.

    pzp.Title.Color = [1 0 0];

    MATLAB figure

    Para este ejemplo, cargue un arreglo de modelos de función de transferencia de 3 por 1.

    load('tfArrayMargin.mat','sys');
    size(sys)
    3x1 array of transfer functions.
    Each model has 1 outputs and 1 inputs.
    

    Represente los polos y ceros del arreglo de modelos. Defina los colores para cada modelo. Utilice rojo para el primer modelo, verde para el segundo y azul para el tercer modelo del arreglo.

    pzplot(sys(:,:,1),'r',sys(:,:,2),'g',sys(:,:,3),'b');

    MATLAB figure

    Represente los polos y ceros del sistema de tiempo continuo representado por la siguiente función de transferencia con un conjunto de opciones personalizado:

    sys(s)=2s2+5s+1s2+3s+5.

    Cree el conjunto de opciones personalizado con pzoptions.

    plotoptions = pzoptions;

    Para este ejemplo, especifique que la cuadrícula esté visible.

    plotoptions.Grid = 'on';

    Utilice las opciones indicadas para crear un mapa de polos y ceros de la función de transferencia.

    h = pzplot(tf([2 5 1],[1 3 5]),plotoptions);

    MATLAB figure

    Al activar la cuadrícula se muestran líneas de coeficiente de amortiguación constante (zeta) y líneas de frecuencia natural constante (wn). Este sistema tiene dos ceros reales, marcados con o en la gráfica. El sistema también tiene un par de polos complejos, marcados con x.

    Más acerca de

    expandir todo

    Sugerencias

    • Las gráficas creadas con pzplot no admiten títulos ni etiquetas multilínea especificados como arreglos de cadenas o arreglos de celdas de vectores de caracteres. Para especificar títulos y etiquetas multilínea, utilice una cadena única con un carácter newline.

      impulseplot(sys)
      title("first line" + newline + "second line");

    Historial de versiones

    Introducido antes de R2006a

    expandir todo