이 페이지는 기계 번역을 사용하여 번역되었습니다. 최신 내용을 영문으로 보려면 여기를 클릭하십시오.

roadrunner

MATLAB를 사용하여 RoadRunner 애플리케이션을 시작하세요.

R2022a 이후

설명

roadrunner 객체를 사용하면 MATLAB^® 명령줄에서 장면과 프로젝트 열기, 닫기, 저장과 같은 RoadRunner 응용 프로그램의 일반적인 작업 흐름 작업을 수행할 수 있습니다. 또한 객체 기능을 사용하여 파일에서 데이터를 가져오고 RoadRunner에서 다른 형식으로 장면을 내보낼 수도 있습니다.

roadrunner 개체를 처음 생성하기 전에 대화형으로 RoadRunner를 설치하고 RoadRunner 라이센스를 활성화해야 합니다. 자세한 내용은 RoadRunner 설치 및 활성화 항목을 참조하십시오.

roadrunner 개체에는 Automated Driving Toolbox™에 대한 라이센스가 필요합니다.

생성

구문

rrApp = roadrunner(ProjectFolder=projectFolder)

rrApp = roadrunner

rrApp = roadrunner(Name=Value)

설명

rrApp = roadrunner(ProjectFolder=projectFolder)는 기본 설치 폴더 위치에서 RoadRunner를 시작하고 ProjectFolder로 지정된 위치에 있는 기존 프로젝트의 새 장면을 엽니다.

rrApp = roadrunner는 MATLAB의 settings API 또는 함수를 사용하여 정의된 ProjectFolder 및 InstallationFolder에 대해 RoadRunner를 엽니다.

rrApp = roadrunner(Name=Value)는 이름-값 쌍을 사용하여 속성을 설정합니다.

속성

ProjectFolder — RoadRunner 프로젝트 폴더 경로

string형 스칼라

RoadRunner 프로젝트 폴더 경로로, 문자열 스칼라로 지정됩니다. MATLAB의 settings API 또는 함수를 사용하여 ProjectFolder 값을 사용자 정의할 수 있습니다. RoadRunner 프로젝트 폴더 구조에 대한 자세한 내용은 RoadRunner 프로젝트 및 장면 시스템를 참조하세요.

예: roadrunner("C:\My Project")는 Windows^® 머신의 RoadRunner 애플리케이션에 있는 C:\My Project 폴더에 있는 프로젝트를 엽니다.

데이터형: string

InstallationFolder — 로컬 RoadRunner 설치 폴더 위치

string형 스칼라

로컬 RoadRunner 설치 폴더의 위치로, 문자열 스칼라로 지정됩니다. MATLAB의 settings API 또는 함수를 사용하여 InstallationFolder 값을 맞춤설정할 수 있습니다.

Windows 및 Linux^® 플랫폼의 기본 RoadRunner 설치 위치는 다음과 같습니다.

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

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

R20NNx는 사용 중인 릴리스 버전입니다. RoadRunner 설치 폴더의 기본값을 사용자 정의하려면 MATLAB 설정 API를 사용하십시오.

데이터형: char | string

NoDisplay — 콘솔 모드에서 RoadRunner 시작

false or 0 (디폴트 값) | true or 1

logical 0 (false) 또는 logical 1 (true)로 지정된 비그래픽 환경의 콘솔 모드에서 RoadRunner를 시작합니다. 콘솔 모드에서 RoadRunner 시작에 대한 자세한 내용은 콘솔 모드에서 프로그래밍 방식으로 RoadRunner 제어를 참조하세요.

데이터형: logical

Ports — 지정된 apiPort 및 cosimPort에서 RoadRunner를 시작합니다.

행렬

1×2 크기의 행렬로 지정된 지정된 apiPort 및 cosimPort에서 RoadRunner를 시작합니다. RoadRunner API 서버 포트(apiPort) 및 RoadRunner Scenario 시뮬레이션 API 서버 포트(cosimPort)는 RoadRunner 애플리케이션을 시작할 때 기본적으로 자동 할당됩니다. RoadRunner 프로젝트를 연 후 서버는 localhost:port에서 로컬로 실행됩니다. 할당된 포트가 비어 있지 않으면 연결 오류가 발생합니다. 이 경우 roadrunner 개체 또는 connect 함수를 사용하여 apiPort 및 cosimPort에 값을 명시적으로 할당할 수 있습니다.

예: rrApp= roadrunner(projectFolder,Ports= [54321, 54322])는 각각 apiPort 및 cosimPort 54321 및 54322에서 RoadRunner 및 RoadRunner Scenario를 시작합니다.

데이터형: int

객체 함수

프로젝트

newProject	MATLAB를 사용하여 새 RoadRunner 프로젝트 만들기
openProject	MATLAB를 사용하여 RoadRunner 프로젝트 열기
saveProject	MATLAB를 사용하여 RoadRunner 프로젝트 저장

장면

newScene	MATLAB를 사용하여 새로운 RoadRunner 장면 만들기
openScene	MATLAB를 사용하여 RoadRunner 장면 열기
saveScene	MATLAB를 사용하여 RoadRunner 장면을 저장하세요.
exportScene	MATLAB를 사용하여 RoadRunner 장면 내보내기
exportCustomFormat	MATLAB를 사용하여 RoadRunner 장면을 사용자 정의 형식으로 내보내기
importScene	MATLAB를 사용하여 장면을 RoadRunner로 가져오기

시나리오

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
prepareSimulation (RoadRunner Scenario)	Submit simulation data to RoadRunner Scenario simulation engine using MATLAB
simulateScenario (RoadRunner Scenario)	Simulate RoadRunner scenario 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
getAnchors (RoadRunner Scenario)	Retrieve anchor attributes from RoadRunner scenario using MATLAB
exportActorTrajectoryToCSV (RoadRunner Scenario)	Export trajectories of actors in RoadRunner scenario to comma-separated values (CSV) files using MATLAB

연결, 종료 및 상태

roadrunner.connect	MATLAB를 사용하여 RoadRunner의 공개 인스턴스에 연결합니다.
close	MATLAB를 사용하여 RoadRunner를 닫습니다.
status	MATLAB를 사용하여 RoadRunner의 현재 상태를 확인하세요.

예제

기본 설치 폴더에서 RoadRunner 응용 프로그램 시작

ProjectFolder 변수를 사용하여 기존 프로젝트의 경로를 지정합니다. 예를 들어, 이 코드는 C:\RR\MyProject 에 있는 Windows® 시스템의 프로젝트 경로를 보여줍니다.

projectFolder = "C:\RR\MyProject";

roadrunner 객체를 생성하고 장면을 생성하려는 위치로 프로젝트를 지정하여 RoadRunner를 엽니다. 이 예에서는 RoadRunner가 기본 위치에 설치되어 있다고 가정합니다.

rrApp = roadrunner(ProjectFolder=projectFolder, InstallationFolder='C:\Program Files\RoadRunner R2023b\bin\win64'); 

기본 RoadRunner 설치 폴더 설정 변경

MATLAB settings 기능을 사용하여 기본 RoadRunner 설치 폴더 설정을 수정합니다.

settings 함수를 사용하여 MATLAB 세션 전반에 걸쳐 지속되거나 특정 MATLAB 세션에 대해 지속되는 roadrunner 개체의 InstallationFolder 속성 값을 지정할 수 있습니다.

InstallationFolder property에 대한 영구 기본값을 설정하려면 PersonalValue 값을 편집합니다. 지정된 값은 개별 사용자에 대한 여러 MATLAB 세션에서 지속됩니다.

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

InstallationFolder 속성에 대한 임시 기본값을 설정할 수도 있습니다. 지정된 값은 현재 MATLAB 세션 동안만 유지되며 세션이 끝나면 지워집니다.

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

여러 RoadRunner 애플리케이션 인스턴스를 동시에 시작

roadrunner 개체의 여러 인스턴스를 생성하여 여러 RoadRunner 응용 프로그램을 엽니다. 각 인스턴스를 사용하여 열리는 RoadRunner 애플리케이션과 프로그래밍 방식으로 상호 작용할 수 있습니다. 이 코드에 사용된 장면은 기본적으로 RoadRunner 프로젝트에 포함되어 있습니다.

Lane Keep 프로젝트를 지정하여 RoadRunner의 첫 번째 인스턴스를 엽니다. 이 예에서 프로젝트는 C:\RR\Lane Keep 경로에 있습니다.

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

첫 번째 프로젝트에서 FourWaySignal 장면을 엽니다.

openScene(rrApp1,"FourWaySignal.rrscene");

USCity 프로젝트를 지정하여 RoadRunner의 두 번째 인스턴스를 엽니다. 이 예에서 프로젝트는 C:\RR\USCity 경로에 있습니다.

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

두 번째 프로젝트에서 SanAntonio 장면을 엽니다.

openScene(rrApp2,"SanAntonio.rrscene");

콘솔 모드에서 RoadRunner 애플리케이션 시작

projectFolder 변수를 사용하여 기존 프로젝트의 경로를 지정합니다. 예를 들어, 이 코드는 C:\RR\MyProject 에 있는 Windows® 시스템의 프로젝트 경로를 보여줍니다.

projectFolder = "C:\RR\MyProject";

roadrunner 객체를 생성하고 장면을 생성하려는 위치로 프로젝트를 지정하여 RoadRunner를 엽니다. 이 예에서는 RoadRunner가 기본 위치에 설치되어 있다고 가정합니다. 비그래픽 터미널을 사용하여 콘솔 모드에서 애플리케이션을 시작하려면 NoDisplay 속성을 지정합니다.

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

제한 사항

• roadrunner 개체 및 관련 기능은 RoadRunner R2022a 이상에서만 지원됩니다.

• roadrunner 객체를 생성할 때 projectFolder 인수를 사용하여 지정하는 프로젝트가 이미 존재해야 합니다.

• projectFolder 인수 및 InstallationFolder 속성은 경로에서 유니코드 문자를 지원하지 않습니다.

• roadrunner 개체 및 관련 기능은 MATLAB Online™에서 지원되지 않습니다.

팁

• MATLAB 작업 공간에서 roadrunner 개체를 삭제해도 이와 연결된 RoadRunner 응용 프로그램은 닫히지 않습니다. RoadRunner 애플리케이션을 수동으로 닫아야 합니다. 또한 현재 MATLAB 세션을 종료해도 roadrunner가 만든 RoadRunner 응용 프로그램은 닫히지 않습니다.

버전 내역

R2022a에 개발됨

R2025a: 시나리오에 등장하는 액터들의 궤적을 CSV 파일로 내보내기

이제 새로운 exportActorTrajectoryToCSV 객체 함수를 사용하여 시나리오에 있는 액터의 궤적을 CSV 파일로 내보낼 수 있습니다.

참고 항목

roadrunner.connect | newProject | openProject | newScenario (RoadRunner Scenario) | openScenario (RoadRunner Scenario) | close

도움말 항목

• RoadRunner 프로젝트 및 장면 시스템
• RoadRunner Scenario Fundamentals (RoadRunner Scenario)
• MATLAB를 사용하여 여러 장면 내보내기
• MATLAB 함수를 사용하여 형식 간 장면 변환