set_param

Establece el valor del parámetro de Simulink

Sintaxis

set_param(object,parameter1,value1,...,parameterN,valueN)

Descripción

set_param(object,parameter1,value1,...,parameterN,valueN) establece el parámetro especificado parameter de Simulink^® en el valor especificado value para el objeto objetivo especificado por object. El objetivo puede ser un modelo, subsistema, biblioteca, bloque, línea, puerto o un elemento del puerto de elementos de bus.

Para establecer múltiples valores de parámetros para el objetivo, llame a la función set_param una vez con múltiples argumentos nombre-valor en lugar de llamar a la función por separado para cada parámetro. Establecer múltiples parámetros con una llamada a función es más rápido porque una llamada evalúa los parámetros solo una vez. Si algún nombre o valor de parámetro no es válido, la función no establece ningún parámetro.

Para interactuar programáticamente con una simulación, utilice la función set_param con el argumento nombre-valor SimulationCommand. Para obtener más información, en la página Ejecutar simulaciones de forma programática, consulte la sección Interactuar con simulaciones generando comandos de simulación.

Para la mayoría de parámetros, ejecutar set_param independientemente de si el valor especificado es diferente del valor actual es más rápido que comparar los valores y ejecutar la función solo si los valores difieren.

Ejemplos

Establecer valores de parámetro de bloque utilizando rutas de bloque

Puede establecer el valor de un parámetro de bloque utilizando la función set_param con estos argumentos de entrada:

• Identificador de bloque o ruta completa del bloque, incluido el nombre del bloque; por ejemplo, 'myModel/mySubsystem/myblock'

• Nombre del parámetro

• Valor nuevo que desea asignar al parámetro

Para obtener más información sobre los identificadores de bloque y las rutas, consulte Get Handles and Paths. Para ver un ejemplo de cómo obtener la ruta del bloque, consulte Obtener rutas de bloque.

Para obtener información sobre cómo obtener los nombres de los parámetros, consulte Obtener nombres de parámetros de bloque.

En este ejemplo, establezca los coeficientes de la función de transferencia especificada por un bloque Transfer Function denominado Alpha-sensor Low-pass Filter.

• El bloque está ubicado en el subsistema Controller del modelo slexAircraftExample.

• Los coeficientes del numerador de la función de transferencia se almacenan en el parámetro Numerator. Los coeficientes del denominador de la función de transferencia se almacenan en el parámetro Denominator.

• El nuevo valor que desea asignar al numerador es 1.2. El nuevo valor que desea asignar al denominador es [0.8*Tal,1], donde Tal es una variable.

Abra el ejemplo. Luego, cargue el modelo slexAircraftExample.

mdl = 'slexAircraftExample';
load_system(mdl)

Establezca los coeficientes de la función de transferencia.

path = [mdl,'/Controller/Alpha-sensor Low-pass Filter'];
set_param(path,'Numerator','1.2','Denominator','[0.8*Tal,1]');

Para comprobar los valores de los parámetros Numerator y Denominator, utilice la función get_param.

num = get_param(path,'Numerator')

num = 
'1.2'

denom = get_param(path,'Denominator')

denom = 
'[0.8*Tal,1]'

Cuando la ruta del bloque es larga y desea establecer múltiples parámetros, considere utilizar identificadores de bloque.

Establecer valores de parámetros de bloque utilizando identificadores de bloque

Puede establecer el valor de un parámetro de bloque utilizando la función set_param con estos argumentos de entrada:

• Identificador de bloque o ruta completa del bloque, incluido el nombre del bloque; por ejemplo, 'myModel/mySubsystem/myblock'

• Nombre del parámetro

• Valor nuevo que desea asignar al parámetro

Para obtener información sobre cómo obtener la ruta del bloque, consulte Obtener rutas de bloque.

Para obtener información sobre cómo obtener los nombres de los parámetros, consulte Obtener nombres de parámetros de bloque.

En este ejemplo, establezca los coeficientes de la función de transferencia especificada por un bloque Transfer Function denominado Alpha-sensor Low-pass Filter.

• El bloque está ubicado en el subsistema Controller del modelo slexAircraftExample.

• Los coeficientes del numerador de la función de transferencia se almacenan en el parámetro Numerator. Los coeficientes del denominador de la función de transferencia se almacenan en el parámetro Denominator.

• El nuevo valor que desea asignar al numerador es 1.2. El nuevo valor que desea asignar al denominador es [0.8*Tal,1], donde Tal es una variable.

Abra el ejemplo. Luego, obtenga el identificador de bloque utilizando la función getSimulinkBlockHandle. Para obtener el identificador de bloque y cargar el modelo de forma simultánea, especifique el segundo argumento para la función getSimulinkBlockHandle como true.

path = 'slexAircraftExample/Controller/Alpha-sensor Low-pass Filter';
h = getSimulinkBlockHandle(path,true)

h = 
425.0134

Para establecer los valores del parámetro, especifique el bloque que usa el identificador. El identificador contiene un doble. No intente introducir manualmente el número de un identificador porque puede ser necesario especificar más dígitos de los que ilustra MATLAB®. En su lugar, asigne el identificador a una variable y utilice el nombre de variable para especificar el bloque.

set_param(h,'Numerator','1.2','Denominator','[0.8*Tal,1]');

Establecer los valores de los parámetros de configuración de un modelo

Puede establecer el valor de un parámetro de un modelo utilizando la función set_param con estos argumentos de entrada:

• Nombre del modelo

• Nombre del parámetro

• Valor nuevo que desea asignar al parámetro

Para obtener información sobre cómo obtener nombres de parámetros de modelo, consulte Obtener los nombres de los parámetros de un modelo.

Abra el ejemplo. Luego, cargue el modelo f14.

load_system('f14')

Establezca el solver del modelo f14 en ode15s y el tiempo de detención en 3000 segundos.

set_param('f14','SolverName','ode15s','StopTime','3000')

Para comprobar los valores de los parámetros SolverName y StopTime, utilice la función get_param.

solver = get_param('f14','SolverName')

solver = 
'ode15s'

stoptime = get_param('f14','StopTime')

stoptime = 
'3000'

Establecer la posición y el tamaño de un bloque

Abra el ejemplo. Luego, abra el modelo f14.

open_system('f14')

Obtenga el identificador del bloque Signal Generator denominado Pilot.

h = getSimulinkBlockHandle('f14/Pilot');

Obtenga la posición del bloque.

pos = get_param(h,'Position')

pos = 1×4

    15    18    55    42

La función devuelve la posición del bloque, especificada como un vector de coordenadas medido en píxeles: [left top right bottom].

Mueva el bloque a la derecha.

pos = [pos(1)+20 pos(2) pos(3)+20 pos(4)];
set_param(h,'Position',pos);

Mueva el bloque hacia arriba.

pos = [pos(1) pos(2)-20 pos(3) pos(4)-20];
set_param(h,'Position',pos);

Alargue el bloque horizontalmente.

pos = [pos(1)/4 pos(2) pos(3) pos(4)];
set_param(h,'Position',pos);

Mover el nombre del bloque por encima del bloque

Abra el ejemplo. Luego, abra el modelo f14.

open_system('f14')

El modelo tiene un bloque Signal Generator denominado Pilot. Mueva el nombre del bloque por encima del bloque.

set_param('f14/Pilot','NameLocation','top')

Argumentos de entrada

object — Nombre, ruta o identificador del objeto

vector de caracteres | escalar de cadena | escalar numérico

Nombre, ruta o identificador del objeto, especificado como vector de caracteres, escalar de cadena o escalar numérico.

La forma de especificar el objetivo depende de su tipo.

• Modelo: nombre o identificador del modelo.

• Subsistema: nombre o identificador del subsistema.

• Biblioteca: nombre o identificador de la biblioteca.

• Bloque: ruta o identificador del bloque.

• Línea: identificador de la línea.

• Puerto: identificador del puerto.

• Elemento de puerto: ruta compuesta por el nombre del modelo o la ruta del bloque del subsistema, una barra diagonal y el nombre del puerto o la ruta del elemento de bus. En el caso de un puerto de elementos de bus, la ruta de elementos de bus proporciona la jerarquía desde el bus de nivel superior hasta el elemento objetivo, y separa cada nombre de la jerarquía con un punto.

Para obtener información sobre cómo obtener identificadores y rutas, consulte Get Handles and Paths. Para especificar múltiples objetos con un parámetro común, use un arreglo de celdas de vectores de caracteres, un arreglo de cadenas, o un arreglo de identificadores. Todos los objetos especificados deben tener el parámetro especificado, de lo contrario, la función devuelve un error.

Ejemplo: 'vdp/Mu'

Ejemplo: 'mymodel/Subsystem1/Out1.nonsinusoidal.saw'

Sugerencias

• Si realiza múltiples llamadas a set_param para el mismo bloque, especifique el bloque con un identificador numérico. Este método es más eficiente que utilizar la ruta completa del bloque con set_param. Utilice getSimulinkBlockHandle para obtener un identificador de bloque.

• No intente especificar manualmente el número de un identificador; por ejemplo 5.007, porque normalmente necesita especificar más dígitos de los que ilustra MATLAB^®. Asigne el identificador a una variable y utilice ese nombre de variable.

Tipos de datos: char | string | double

parameter — Nombre de parámetro, propiedad o atributo

vector de caracteres | escalar de cadena

Nombre de parámetro, propiedad o atributo, especificados como vector de caracteres o escalar de cadena. Algunos nombres distinguen entre mayúsculas y minúsculas.

Para obtener información sobre parámetros, propiedades o atributos, consulte la información de uso programático de las correspondientes páginas de referencia. Por ejemplo:

• Modelos: consulte las páginas de referencia del parámetro de configuración.

• Bloques: consulte Common Block Properties y las páginas de referencia de bloques.

• Puertos: consulte la página de referencia de la herramienta Signal Properties.

• Elementos de puerto: consulte las páginas de referencia de los bloques In Bus Element y Out Bus Element.

Para obtener todos los parámetros de un objetivo, utilice la función get_param con la opción 'ObjectParameters'. Es posible que algunos de los parámetros devueltos sean únicamente para uso interno.

Ejemplo: 'SolverName'

Ejemplo: 'SimulationCommand'

Ejemplo: 'Position'

Ejemplo: 'NameLocation'

Tipos de datos: char | string

value — Valor del parámetro

formato determinado por el tipo de parámetro

Valor del parámetro, especificado en el formato determinado por el tipo de parámetro. Algunos valores de los parámetros distinguen entre mayúsculas y minúsculas. Los valores suelen ser vectores de caracteres o escalares de cadena, pero también pueden ser escalares numéricos, arreglos y de otros tipos.

Muchos valores de los parámetros de bloques están especificados como vectores de caracteres o escalares de cadena. Dos excepciones son Position, que está especificado como un vector y UserData, que puede ser cualquier tipo de datos.

Limitaciones

• Si utiliza matlab -nodisplay para iniciar una sesión, no puede utilizar set_param para ejecutar una simulación. El modo -nodisplay no admite la simulación con set_param. Use la función sim en su lugar.

• Cuando use la función set_param para modificar el nombre de un bloque o señal, estos nombres no son válidos: nombres vacíos, nombres que contienen únicamente caracteres de nueva línea y nombres que comienzan o terminan con /.

Historial de versiones

Introducido antes de R2006a

Consulte también

Funciones

• get_param | getSimulinkBlockHandle | gcs | gcb | bdroot | open_system | new_system

Herramientas

• Signal Properties

Bloques

• In Bus Element | Out Bus Element

Temas

• Get Handles and Paths
• Common Block Properties
• Programmatically Specify Block Parameters and Properties
• Establecer parámetros de configuración de modelo
• Associating User Data with Blocks
• Ejecutar simulaciones de forma programática