Esta página se ha traducido mediante traducción automática. Haga clic aquí para ver la última versión en inglés.

addstate

Agregar uno o más estados al gráfico

Desde R2024a

Sintaxis

stateIDs = addstate(graph,states)

stateIDs = addstate(graph,states,metadata1,...metadataN)

[stateIDs,status] = addstate(___)

Descripción

stateIDs = addstate(graph,states) agrega uno o más estados al gráfico de entrada especificado como un objeto navGraph. Utilice esta sintaxis si la tabla de estados del gráfico de entrada contiene solo una columna que representa los vectores de estados.

stateIDs = addstate(graph,states,metadata1,...metadataN) agrega uno o más estados y la información de metadatos asociada al gráfico de entrada especificado como un objeto navGraph. Utilice esta sintaxis si la tabla de estados del gráfico de entrada contiene varias columnas que incluyen metadatos como Names, además de los vectores de estado. Sin embargo, la primera columna de la tabla siempre debe especificar los vectores de estado.

[stateIDs,status] = addstate(___) también devuelve status, que indica si los nuevos estados se agregaron correctamente al gráfico. Si los estados o nombres de estados recién especificados entran en conflicto con los estados o nombres de estados existentes en el gráfico, la función ignora los estados en conflicto y los estados existentes permanecen sin cambios.

Ejemplos

Agregar estado al gráfico

Cargue el objeto navGraph en el espacio de trabajo MATLAB ® e inspeccione sus propiedades.

load("navGraphStates.mat")
disp(navGraphObj)

  navGraph with properties:

           States: [8×1 table]
            Links: [7×3 table]
    LinkWeightFcn: @nav.algs.distanceEuclidean

Inspeccione la tabla de estados del gráfico. Puedes observar que la tabla de estados solo tiene una columna, que contiene los vectores de estados.

disp(navGraphObj.States)

          StateVector      
    _______________________

    8          2    0.72176
    1          1    0.29188
    7          7    0.91777
    8         10    0.71458
    5          1    0.54254
    3          6    0.14217
    2          9    0.37334
    8          7    0.67413

Agregue un estado al gráfico de entrada especificando el vector de estado. La función addstate devuelve el índice del nuevo estado en la tabla de estados.

Id = addstate(navGraphObj,[2 9 0.5])

Id = 
9

Inspeccione la tabla de estados actualizada para ver el nuevo estado.

disp(navGraphObj.States)

          StateVector      
    _______________________

    8          2    0.72176
    1          1    0.29188
    7          7    0.91777
    8         10    0.71458
    5          1    0.54254
    3          6    0.14217
    2          9    0.37334
    8          7    0.67413
    2          9        0.5

Agregar múltiples estados y metadatos asociados al gráfico

Cargue el objeto navGraph en el espacio de trabajo MATLAB ® e inspeccione sus propiedades.

load("navGraphData.mat")
disp(navGraphObj)

  navGraph with properties:

           States: [8×3 table]
            Links: [7×3 table]
    LinkWeightFcn: @nav.algs.distanceEuclidean

Inspeccione la tabla de estados del gráfico de entrada. Tenga en cuenta que la tabla de estados contiene metadatos 'Name' y 'Lanes', además de los vectores de estado.

disp(navGraphObj.States)

          StateVector          Name     Lanes
    _______________________    _____    _____

    8          2    0.72176    {'A'}      2  
    1          1    0.29188    {'B'}      2  
    7          7    0.91777    {'C'}      2  
    8         10    0.71458    {'D'}      2  
    5          1    0.54254    {'E'}      2  
    3          6    0.14217    {'F'}      2  
    2          9    0.37334    {'G'}      3  
    8          7    0.67413    {'H'}      2  

Añade dos nuevos estados al gráfico de entrada. Debe especificar los metadatos 'Name' y 'Lanes', además de los vectores de estado. La función addstate devuelve los índices de los nuevos estados en la tabla de estados.

Id = addstate(navGraphObj,[8 8 0.6;5 7 0.5],{"I";"J"},[2;3])

Id = 2×1

     9
    10

Inspeccione la tabla de estados actualizada para ver si hay nuevos estados y los metadatos relacionados.

disp(navGraphObj.States)

          StateVector          Name     Lanes
    _______________________    _____    _____

    8          2    0.72176    {'A'}      2  
    1          1    0.29188    {'B'}      2  
    7          7    0.91777    {'C'}      2  
    8         10    0.71458    {'D'}      2  
    5          1    0.54254    {'E'}      2  
    3          6    0.14217    {'F'}      2  
    2          9    0.37334    {'G'}      3  
    8          7    0.67413    {'H'}      2  
    8          8        0.6    {'I'}      2  
    5          7        0.5    {'J'}      3  

Argumentos de entrada

graph — Objeto gráfico

objeto navGraph

Objeto gráfico, especificado como un objeto navGraph.

states — Vectores de estado

matriz

Vectores de estado, especificados como una matriz M por N. Cada fila de la matriz especifica un vector de estado. M denota la cantidad de estados que se agregarán al gráfico de entrada. N denota la longitud del vector de estado que define un estado. Los vectores de estado deben tener la misma longitud que los definidos en la tabla de estados del gráfico de entrada.

Nota

Si los vectores de estado especificados ya existen en la tabla de estados del gráfico de entrada, la función no agregará los vectores de estado duplicados al gráfico.

Tipos de datos: double

metadata — Metadatos que contienen información adicional

arreglo numérica | arreglo de celdas de vectores de caracteres | arreglo de cadenas | arreglo celular de cadenas

Metadatos que contienen información adicional sobre los estados, especificados como un arreglo numérico, un arreglo de celdas de vectores de caracteres, un arreglo de cadenas o un arreglo de celdas de cadenas.

Tipos de datos: double | string | cell

Argumentos de salida

stateIDs — Identificadores de estado

vector columna de números enteros positivos

Identificadores de estado, devueltos como un vector columna de números enteros positivos. Los identificadores de estado representan los índices de los estados agregados a la tabla de estados del gráfico. La longitud del vector especifica el número de estados agregados al gráfico de entrada.

status — Estado que indica si se agregan nuevos estados

vector columna de elementos M

Desde R2025a

Estado que indica si se agregan nuevos estados, devuelto como un vector columna de elemento M que contiene 0 y 1. Cada elemento indica si el estado correspondiente especificado en el argumento de entrada states se agrega al gráfico (1 para agregado, 0 para no agregado). El tamaño de este vector coincide con el número de estados especificado en states.

Tipos de datos: logical

Capacidades ampliadas

Generación de código C/C++

Genere código C y C++ mediante MATLAB® Coder™.

Para la generación de código,

• Declare la variable de estados en la tabla States del objeto navGraph como datos de tamaño variable, antes de construir la tabla.

  coder.varsize("states")

• No se admiten nombres de estados.

Historial de versiones

Introducido en R2024a

R2025a: Nuevo argumento de salida para indicar si se agregan nuevos estados

A partir de R2025a, la función addstate genera un segundo argumento states para indicar si cada estado especificado en la entrada se agrega al gráfico.

Consulte también

addlink | rmstate | rmlink | findlink | findstate | index2state | state2index | successors | show | copy