주요 콘텐츠

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

roadrunnerAPI

RoadRunner 저작 API

R2025a 이후

    설명

    roadrunnerAPI 객체를 사용하면 MATLAB®을 사용하여 도로와 차선을 만들고, 액터를 추가하고, 시나리오 논리를 구축하는 등 RoadRunner 장면과 시나리오를 프로그래밍 방식으로 작성할 수 있습니다. 장면과 시나리오를 프로그래밍 방식으로 작성하면 반복적인 작성 작업을 빠르게 자동화하고, 자동화된 테스트를 위한 변형을 생성하고, 애플리케이션 간에 전환하지 않고도 시뮬레이션 파라미터를 빌드하고 수정할 수 있습니다. MATLAB에서 RoadRunner 저작 API를 사용하려면 먼저 RoadRunner 세션에 대한 roadrunnerAPI 객체를 만들어야 합니다.

    생성

    설명

    rrApi = roadrunnerAPI(rrApp)은 현재 RoadRunner 세션 rrApp에 대한 RoadRunner 저작 API 객체 rrApi를 반환합니다.

    입력 인수

    모두 확장

    RoadRunner 애플리케이션으로, 객체로 지정됩니다.

    속성

    모두 확장

    읽기 전용 속성입니다.

    현재의 RoadRunner 장면은 Scene 객체로 표현됩니다.

    예: scn = rrApi.SceneRoadRunner 저작 API rrApiScene 속성에서 장면 객체 scn을 추출합니다.

    읽기 전용 속성입니다.

    현재의 RoadRunner 시나리오는 Scenario (RoadRunner Scenario) 객체로 표현됩니다.

    예: scnro = rrApi.ScenarioRoadRunner 저작 API rrApiScenario 속성에서 시나리오 객체 scnro를 추출합니다.

    읽기 전용 속성입니다.

    현재 RoadRunner 프로젝트는 Project 객체로 표현됩니다.

    예제

    모두 축소

    기존 프로젝트의 경로를 지정하여 roadrunner 객체를 만듭니다. 예를 들어, 이 코드는 "C:\RR\MyProject"에 있는 Windows® 컴퓨터의 프로젝트 경로를 보여줍니다. 이 코드는 RoadRunner가 기본 위치에 설치되어 있다고 가정하고 장면과 프로젝트를 열고, 닫고, 저장하는 등의 기본 작업을 수행하기 위한 함수를 제공하는 객체 rrApp을 반환합니다.

    rrApp = roadrunner(ProjectFolder="C:\RR\MyProject");

    참고

    처음으로 MATLAB에서 RoadRunner를 여는 경우 또는 마지막으로 MATLAB에서 연 이후 RoadRunner 설치 위치를 변경한 경우, 이 함수를 사용하여 RoadRunner를 열 때 사용할 새로운 기본 프로젝트와 설치 폴더를 지정할 수 있습니다. 해당 드롭다운에서 Across MATLAB sessions 옵션을 선택하면 MATLAB 세션 사이에 이러한 폴더를 저장할 수 있습니다.

    openScene 함수를 사용하여 RoadRunner에서 기존 장면을 열고, roadrunner 객체 rrApp과 열려는 특정 장면의 파일 이름을 지정합니다. 그런 다음 newScenario 함수를 사용하여 새로운 시나리오를 만듭니다.

    openScene(rrApp,"ScenarioBasic.rrscene")
    newScenario(rrApp)

    현재 RoadRunner 인스턴스 rrApp에 대한 객체를 참조하는 RoadRunner 저작 API rrAPI에 대한 객체를 생성합니다. rrApi 객체를 사용하면 MATLAB을 사용하여 도로, 차선, 액터, 논리 컴포넌트를 추가하고 수정하는 등의 방식으로 장면과 시나리오를 프로그래밍 방식으로 작성할 수 있습니다.

    rrApi = roadrunnerAPI(rrApp);
    

    제한 사항

    • roadrunner 함수를 사용하여 MATLAB에서 RoadRunner를 열지 않거나 MATLAB을 열기 전에 RoadRunner 세션을 여는 경우, RoadRunner 저작 API 함수를 사용하기 전에 RoadRunner 저작 API가 포함된 폴더의 경로를 MATLAB 세션에 추가해야 합니다. 기본적으로 Windows의 RoadRunner 저작 API 폴더의 위치는 C:\Program Files\RoadRunner R20NNx\bin\win64\Tools\MATLAB\api이고, 여기서 R20NNx는 사용 중인 릴리스 버전입니다.

    버전 내역

    R2025a에 개발됨

    참고 항목

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