Contenido principal

rlocusplot

Gráfica del lugar de las raíces del sistema dinámico

    Descripción

    La función rlocusplot representa el lugar de las raíces del modelo de sistema dinámico y devuelve un objeto de gráfico RLocusPlot. 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.

    Para obtener las ganancias de retroalimentación y las ubicaciones de raíces complejas, utilice la función rlocus.

    Creación

    Descripción

    rlp = rlocusplot(sys) representa el lugar de las raíces del modelo de sistema dinámico SISO sys y devuelve el objeto de gráfico correspondiente.

    Para producir una gráfica suave, la función rlocusplot selecciona automáticamente un conjunto de ganancias de retroalimentación positivas.

    ejemplo

    rlp = rlocusplot(sys1,sys2,...,sysN) representa los lugares de las raíces de múltiples modelos en una sola gráfica.

    rlp = rlocusplot(sys1,LineSpec1,...,sysN,LineSpecN) establece el estilo de línea, el tipo de marcador y el color para la gráfica de cada sistema.

    rlp = rlocusplot(___,k) representa respuestas para las ganancias de retroalimentación especificadas en k. Puede especificar un rango de frecuencia o un vector de frecuencias. Puede utilizar k con cualquiera de las combinaciones de argumentos de entrada de sintaxis anteriores.

    rlp = rlocusplot(___,plotoptions) representa el lugar de las raíces 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.

    rlp = rlocusplot(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 modelo de sistema dinámico SISO o un arreglo de modelos de sistemas dinámicos. Se admiten 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.

    Estilo de línea, marcador y color, especificados como cadena o vector de caracteres con símbolos. Los símbolos pueden aparecer en cualquier orden. No es necesario que especifique las tres características. Por ejemplo, si especifica el marcador y omite el estilo de línea, la gráfica mostrará únicamente el marcador y ninguna línea.

    Ejemplo: '--or' es una línea discontinua roja con marcadores circulares.

    Estilo de líneaDescripción
    "-"Línea continua
    "--"Línea discontinua
    ":"Línea de puntos
    "-."Línea de puntos y rayas
    MarcadorDescripción
    "o"Círculo
    "+"Signo más
    "*"Asterisco
    "."Punto
    "x"Cruz
    "_"Línea horizontal
    "|"Línea vertical
    "s"Cuadrado
    "d"Rombo
    "^"Triángulo hacia arriba
    "v"Triángulo hacia abajo
    ">"Triángulo hacia la derecha
    "<"Triángulo hacia la izquierda
    "p"Pentagrama
    "h"Hexagrama
    ColorDescripción
    "r"rojo
    "g"verde
    "b"azul
    "c"cian
    "m"magenta
    "y"amarillo
    "k"negro
    "w"blanco

    Valores de ganancia de retroalimentación que conciernen a las ubicaciones de los polos, especificados como un vector. Las ganancias de retroalimentación definen la trayectoria de los polos, afectando así el formato de la gráfica del lugar de las raíces.

    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 RLocusPlot Properties.

    Respuestas de modelos, especificadas como un objeto RootLocusResponse 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 IOPZResponse tiene estas propiedades.

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

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

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

    Valores de ganancia de retroalimentación que conciernen a las ubicaciones de los polos, especificados como un vector. Las ganancias de retroalimentación definen la trayectoria de los polos, afectando así el formato de la gráfica del lugar de las raíces.

    Si especifica la propiedad FeedbackGainSpec como vacía, el software selecciona automáticamente un conjunto de ganancias de retroalimentación positivas que producen una gráfica suave.

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

    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 el lugar de la raíces del modelo de sistema dinámico SISO.

    sys = tf([2 5 1],[1 2 3]);
    rlp = rlocusplot(sys);

    MATLAB figure

    Más acerca de

    expandir todo

    Sugerencias

    • Las gráficas creadas con rlocusplot 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.

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

    Historial de versiones

    Introducido antes de R2006a

    expandir todo