Main Content

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

roadrunner

Inicie la aplicación RoadRunner usando MATLAB

Desde R2022a

expandir todo en la página

    Descripción

    Un objeto roadrunner le permite realizar tareas de flujo de trabajo comunes en la aplicación RoadRunner , como abrir, cerrar y guardar escenas y proyectos, desde la línea de comando MATLAB® . También puede utilizar funciones de objetos para importar datos de archivos y exportar escenas de RoadRunner a otros formatos.

    Antes de crear un objeto roadrunner por primera vez, debe instalar RoadRunner y activar su licencia de RoadRunner de forma interactiva. Para obtener más información, consulte Instalar y activar RoadRunner.

    El objeto roadrunner requiere una licencia para Automated Driving Toolbox™.

    Creación

    Sintaxis

    rrApp = roadrunner(ProjectFolder=projectFolder)
    rrApp = roadrunner
    rrApp = roadrunner(Name=Value)

    Descripción

    ejemplo

    rrApp = roadrunner(ProjectFolder=projectFolder) inicia RoadRunner desde la ubicación predeterminada de la carpeta de instalación y abre una nueva escena en un proyecto existente en la ubicación especificada por ProjectFolder.

    ejemplo

    rrApp = roadrunner abre RoadRunner para una Carpeta de Proyecto y una Carpeta de Instalación definidas usando la API o función MATLAB de settings .

    rrApp = roadrunner(Name=Value) establece las propiedades utilizando pares nombre-valor.

    Propiedades

    expandir todo

    Ruta de la carpeta del proyecto RoadRunner , especificada como una cadena escalar. Puede personalizar el valor de ProjectFolder usando la API o función MATLAB de settings. Para obtener detalles sobre la estructura de carpetas del proyecto RoadRunner , consulte Proyecto RoadRunner y sistema de escena.

    Ejemplo: roadrunner("C:\My Project") abre el proyecto ubicado en la carpeta C:\My Project en la aplicación RoadRunner en una máquina Windows® .

    Tipos de datos: string

    Ubicación de la carpeta de instalación local de RoadRunner , especificada como una cadena escalar. Puede personalizar el valor de InstallationFolder usando la API o función MATLAB de settings

    Estas son las ubicaciones de instalación predeterminadas de RoadRunner en las plataformas Windows y Linux® :

    • Windows – C:\Program Files\RoadRunner R20NNx\bin\win64

    • Linux, Ubuntu® – /usr/local/RoadRunner_R20NNx/bin/glnxa64

    R20NNx es la versión de lanzamiento que está utilizando. Para personalizar el valor predeterminado de la carpeta de instalación de RoadRunner , use la API de configuración MATLAB .

    Tipos de datos: char | string

    Inicie RoadRunner en modo consola en un entorno no gráfico, especificado como logical 0 (false) o logical 1 (true). Para obtener más detalles sobre cómo iniciar RoadRunner en modo consola, consulte Controlar RoadRunner mediante programación en modo consola.

    Tipos de datos: logical

    Inicie RoadRunner en apiPort y cosimPort especificados, especificados como una matriz de tamaño 1 por 2. El puerto del servidor API de RoadRunner (apiPort) y el puerto del servidor API de simulación de RoadRunner Scenario (cosimPort) se asignan automáticamente de forma predeterminada cuando inicia la aplicación RoadRunner . El servidor se ejecuta localmente en localhost:port después de abrir un proyecto RoadRunner . Si los puertos asignados no están libres se produce un error de conexión. En este caso, puede asignar valores explícitamente a apiPort y cosimPort usando el objeto roadrunner o el connect. Función.

    Ejemplo: rrApp= roadrunner(projectFolder, Ports= [54321, 54322]) inicia RoadRunner y RoadRunner Scenario en apiPort y cosimPort 54321 y 54322 respectivamente.

    Tipos de datos: int

    Funciones del objeto

    expandir todo

    newProjectCree un nuevo proyecto RoadRunner usando MATLAB
    openProjectAbra el proyecto RoadRunner usando MATLAB
    saveProjectGuarde el proyecto RoadRunner usando MATLAB
    newSceneCrea una nueva escena de RoadRunner usando MATLAB
    openSceneAbra la escena RoadRunner usando MATLAB
    saveSceneGuarde la escena de RoadRunner usando MATLAB
    exportSceneExportar escena de RoadRunner usando MATLAB
    exportCustomFormatExportar escena de RoadRunner a formato personalizado usando MATLAB
    importSceneImportar escena a RoadRunner usando MATLAB
    newScenario (RoadRunner Scenario)Create new scenario in RoadRunner Scenario using MATLAB
    openScenario (RoadRunner Scenario)Open scenario in RoadRunner Scenario using MATLAB
    saveScenario (RoadRunner Scenario)Save scenario in RoadRunner Scenario using MATLAB
    exportScenario (RoadRunner Scenario)Export scenario from RoadRunner Scenario using MATLAB
    importScenario (RoadRunner Scenario)Import file into RoadRunner Scenario using MATLAB
    createSimulation (RoadRunner Scenario)Create RoadRunner Scenario simulation using MATLAB
    getScenarioVariable (RoadRunner Scenario)Get the value of RoadRunner scenario variable using MATLAB
    setScenarioVariable (RoadRunner Scenario)Set RoadRunner scenario variable using MATLAB
    remapAnchor (RoadRunner Scenario)Remap anchors in RoadRunner Scenario in MATLAB
    roadrunner.connectConéctese a la instancia abierta de RoadRunner usando MATLAB
    closeCerrar RoadRunner usando MATLAB
    statusObtenga el estado actual de RoadRunner usando MATLAB

    Ejemplos

    contraer todo

    Este ejemplo utiliza:

    Abrir script en vivo

    Especifique la ruta a un proyecto existente utilizando la variable ProjectFolder. Por ejemplo, este código muestra la ruta a un proyecto, en una máquina con Windows®, ubicado en C:\RR\MyProject. 

    projectFolder = "C:\RR\MyProject";

    Cree un objeto roadrunner y abra RoadRunner especificando su proyecto como la ubicación donde desea crear una escena. Este ejemplo supone que RoadRunner está instalado en su ubicación predeterminada.

    rrApp = roadrunner(ProjectFolder=projectFolder);

    Este ejemplo utiliza:

    Abrir script en vivo

    Modifique la configuración predeterminada de la carpeta de instalación de RoadRunner utilizando la función MATLAB settings .

    Puede especificar un valor para la propiedad InstallationFolder de un objeto roadrunner que persiste en todas las sesiones de MATLAB , o para una sesión de MATLAB determinada, utilizando la settings Función $ .

    Para establecer un valor predeterminado persistente para InstallationFolder property, edite el valor de PersonalValue. El valor especificado persiste en varias sesiones de MATLAB para un usuario individual.

    s = settings;
s.roadrunner.application.InstallationFolder.PersonalValue = "C:\Program Files\RoadRunner R2022a\bin\win64";

    También puede establecer un valor predeterminado temporal para la propiedad InstallationFolder . el valor especificado persiste solo durante la sesión actual de MATLAB y se borra al final de la sesión.

    s = settings;
s.roadrunner.application.InstallationFolder.TemporaryValue = "C:\MyRoadRunner Install\bin\win64";

    Este ejemplo utiliza:

    Abrir script en vivo

    Abra varias aplicaciones RoadRunner creando varias instancias del objeto roadrunner . Puede utilizar cada instancia para interactuar mediante programación con la aplicación RoadRunner que abre. Las escenas utilizadas en este código se incluyen en los proyectos RoadRunner de forma predeterminada.

    Abra una primera instancia de RoadRunner especificando el proyecto Lane Keep . En este ejemplo, el proyecto está ubicado en la ruta C:\RR\Lane Keep. 

    rrApp1 = roadrunner("C:\RR\Lane Keep");

    Abra la escena FourWaySignal en el primer proyecto. 

    openScene(rrApp1,"FourWaySignal.rrscene");

    Abra una segunda instancia de RoadRunner especificando el proyecto USCity . En este ejemplo, el proyecto está ubicado en la ruta C:\RR\USCity.

    rrApp2 = roadrunner("C:\RR\USCity");

    Abra la escena SanAntonio en el segundo proyecto

    openScene(rrApp2,"SanAntonio.rrscene");

    Este ejemplo utiliza:

    Abrir script en vivo

    Especifique la ruta a un proyecto existente utilizando la variable projectFolder . Por ejemplo, este código muestra la ruta a un proyecto, en una máquina con Windows®, ubicado en C:\RR\MyProject. 

    projectFolder = "C:\RR\MyProject";

    Cree un objeto roadrunner y abra RoadRunner especificando su proyecto como la ubicación donde desea crear una escena. Este ejemplo supone que RoadRunner está instalado en su ubicación predeterminada. Especifique la propiedad NoDisplay para iniciar la aplicación en modo consola utilizando un terminal no gráfico.

    rrApp = roadrunner(projectFolder,InstallationFolder="C:\Program Files\RoadRunner R2022b\bin\win64",NoDisplay=true);

    Limitaciones

    • El objeto roadrunner y sus funciones asociadas solo se admiten en RoadRunner R2022a y versiones posteriores.

    • El proyecto que especifique utilizando el argumento projectFolder , al crear el objeto roadrunner ya debe existir.

    • El argumento projectFolder y la propiedad InstallationFolder no admiten caracteres Unicode en la ruta.

    • El objeto roadrunner y sus funciones asociadas no son compatibles con MATLAB Online™.

    Sugerencias

    • Eliminar el objeto roadrunner del espacio de trabajo MATLAB no cierra la aplicación RoadRunner asociada a él. Debes cerrar manualmente la aplicación RoadRunner . Además, salir de la sesión actual de MATLAB no cierra ninguna aplicación RoadRunner creada por roadrunner.

    Historial de versiones

    Introducido en R2022a

    Consulte también

    | | | (RoadRunner Scenario) | (RoadRunner Scenario) |

    Temas