Questa pagina è stata tradotta con la traduzione automatica. Fai clic qui per vedere l'ultima versione in inglese.

roadrunner

Avvia l'applicazione RoadRunner utilizzando MATLAB

Da R2022a

espandi tutto nella pagina

    Descrizione

    Un oggetto roadrunner consente di eseguire attività comuni del flusso di lavoro nell'applicazione RoadRunner , come l'apertura, la chiusura e il salvataggio di scene e progetti, dalla riga di comando MATLAB® . Puoi anche utilizzare le funzioni oggetto per importare dati da file ed esportare scene da RoadRunner in altri formati.

    Prima di creare un oggetto roadrunner per la prima volta, è necessario installare RoadRunner e attivare la licenza RoadRunner in modo interattivo. Per ulteriori informazioni, vedere Installa e attiva RoadRunner.

    L'oggetto roadrunner richiede una licenza per Automated Driving Toolbox™.

    Creazione

    Sintassi

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

    Descrizione

    rrApp = roadrunner(ProjectFolder=projectFolder) avvia RoadRunner dalla posizione della cartella di installazione predefinita e apre una nuova scena in un progetto esistente nella posizione specificata da ProjectFolder.

    esempio

    rrApp = roadrunner apre RoadRunner per una cartella di progetto e una cartella di installazione definite utilizzando l'API o la funzione MATLAB di settings .

    esempio

    rrApp = roadrunner(Name=Value) imposta le proprietà utilizzando coppie nome-valore.

    Proprietà

    espandi tutto

    Percorso della cartella del progetto RoadRunner , specificato come stringa scalare. È possibile personalizzare il valore di ProjectFolder utilizzando l'API o la funzione MATLAB di settings. Per dettagli sulla struttura delle cartelle del progetto RoadRunner , vedere Progetto RoadRunner e sistema di scena.

    Esempio roadrunner("C:\My Project") apre il progetto che si trova nella cartella C:\My Project nell'applicazione RoadRunner su una macchina Windows® .

    Tipi di dati: string

    Posizione della cartella di installazione locale RoadRunner , specificata come stringa scalare. È possibile personalizzare il valore di InstallationFolder utilizzando l'API o la funzione MATLAB di settings

    Queste sono le posizioni di installazione predefinite RoadRunner sulle piattaforme Windows e Linux® :

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

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

    R20NNx è la versione in uso. Per personalizzare il valore predefinito della cartella di installazione RoadRunner , utilizzare l'API delle impostazioni MATLAB .

    Tipi di dati: char | string

    Avvia RoadRunner in modalità console in un ambiente non grafico, specificato come logical 0 (false) o logical 1 (true). Per ulteriori dettagli sull'avvio RoadRunner in modalità console, vedere Controlla RoadRunner in modo programmatico in modalità console.

    Tipi di dati: logical

    Avvia RoadRunner sul apiPort e cosimPort specificati, specificati come matrice di dimensione 1 per 2. La porta del server API RoadRunner (apiPort) e la porta del server API di simulazione RoadRunner Scenario (cosimPort) vengono assegnate automaticamente per impostazione predefinita quando si avvia l'applicazione RoadRunner . Il server viene eseguito localmente su localhost:port dopo aver aperto un progetto RoadRunner . Se le porte assegnate non sono libere si verifica un errore di connessione. In questo caso, è possibile assegnare esplicitamente valori a apiPort e cosimPort utilizzando l'oggetto roadrunner o l' connect funzione.

    Esempio rrApp= roadrunner(projectFolder, Ports= [54321, 54322]) avvia RoadRunner e RoadRunner Scenario su apiPort e cosimPort 54321 e 54322 rispettivamente.

    Tipi di dati: int

    Funzioni oggetto

    espandi tutto

    newProjectCrea un nuovo progetto RoadRunner utilizzando MATLAB
    openProjectApri il progetto RoadRunner utilizzando MATLAB
    saveProjectSalva il progetto RoadRunner utilizzando MATLAB
    newSceneCrea una nuova scena RoadRunner utilizzando MATLAB
    openSceneApri la scena RoadRunner utilizzando MATLAB
    saveSceneSalva la scena RoadRunner utilizzando MATLAB
    exportSceneEsporta la scena RoadRunner utilizzando MATLAB
    exportCustomFormatEsporta la scena RoadRunner in un formato personalizzato utilizzando MATLAB
    importSceneImporta la scena in RoadRunner utilizzando 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.connectConnettersi all'istanza aperta di RoadRunner utilizzando MATLAB
    closeChiudi RoadRunner utilizzando MATLAB
    statusOttieni lo stato attuale di RoadRunner utilizzando MATLAB

    Esempi

    comprimi tutto

    Questo esempio utilizza:

    Apri live script

    Specificare il percorso di un progetto esistente utilizzando la variabile ProjectFolder. Ad esempio, questo codice mostra il percorso di un progetto, su un computer Windows®, situato in C:\RR\MyProject. 

    projectFolder = "C:\RR\MyProject";

    Crea un oggetto roadrunner e apri RoadRunner specificando il tuo progetto come posizione in cui desideri creare una scena. Questo esempio presuppone che RoadRunner sia installato nella posizione predefinita.

    rrApp = roadrunner(ProjectFolder=projectFolder);

    Questo esempio utilizza:

    Apri live script

    Modificare le impostazioni predefinite della cartella di installazione RoadRunner utilizzando la funzione MATLAB settings .

    È possibile specificare un valore per la proprietà InstallationFolder di un oggetto roadrunner che persiste attraverso le sessioni MATLAB o per una determinata sessione MATLAB , utilizzando la settings Funzione $ .

    Per impostare un valore predefinito persistente per InstallationFolder property, modifica il valore di PersonalValue. Il valore specificato persiste tra più sessioni MATLAB per un singolo utente.

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

    È inoltre possibile impostare un valore predefinito temporaneo per la proprietà InstallationFolder . il valore specificato persiste solo per la sessione MATLAB corrente e viene cancellato alla fine della sessione.

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

    Questo esempio utilizza:

    Apri live script

    Aprire più applicazioni RoadRunner creando più istanze dell'oggetto roadrunner . Puoi utilizzare ciascuna istanza per interagire a livello di codice con l'applicazione RoadRunner che apre. Le scene utilizzate in questo codice sono incluse nei progetti RoadRunner per impostazione predefinita.

    Apri una prima istanza di RoadRunner specificando il progetto Lane Keep . In questo esempio il progetto si trova nel percorso C:\RR\Lane Keep. 

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

    Apri la scena FourWaySignal nel primo progetto. 

    openScene(rrApp1,"FourWaySignal.rrscene");

    Apri una seconda istanza di RoadRunner specificando il progetto USCity . In questo esempio il progetto si trova nel percorso C:\RR\USCity.

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

    Apri la scena SanAntonio nel secondo progetto

    openScene(rrApp2,"SanAntonio.rrscene");

    Questo esempio utilizza:

    Apri live script

    Specificare il percorso di un progetto esistente utilizzando la variabile projectFolder . Ad esempio, questo codice mostra il percorso di un progetto, su un computer Windows®, situato in C:\RR\MyProject. 

    projectFolder = "C:\RR\MyProject";

    Crea un oggetto roadrunner e apri RoadRunner specificando il tuo progetto come posizione in cui desideri creare una scena. Questo esempio presuppone che RoadRunner sia installato nella posizione predefinita. Specificare la proprietà NoDisplay per avviare l'applicazione in modalità console utilizzando un terminale non grafico.

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

    Limitazioni

    • L'oggetto roadrunner e le funzioni associate sono supportati solo in RoadRunner R2022a e versioni successive.

    • Il progetto specificato utilizzando l'argomento projectFolder , quando si crea l'oggetto roadrunner deve già esistere.

    • L'argomento projectFolder e la proprietà InstallationFolder non supportano i caratteri Unicode nel percorso.

    • L'oggetto roadrunner e le funzioni associate non sono supportati in MATLAB Online™.

    Suggerimenti

    • L'eliminazione dell'oggetto roadrunner dall'area di lavoro MATLAB non chiude l'applicazione RoadRunner ad esso associata. È necessario chiudere manualmente l'applicazione RoadRunner . Inoltre, l'uscita dalla sessione corrente MATLAB non chiude alcuna applicazione RoadRunner creata da roadrunner.

    Cronologia versioni

    Introdotto in R2022a

    Vedi anche

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

    Argomenti