add_block
R2026b모델에 블록 추가
설명
예제
myModel이라는 모델이 있다고 가정하겠습니다. Customizable Blocks 라이브러리에서 모델로 Circular Gauge 블록을 추가합니다. 새 블록의 이름을 myBlock으로 지정합니다. 이름이 고유한지 확인합니다. 예를 들어, 이름이 myBlock인 블록이 이미 존재하는 경우 블록의 이름을 myBlock1로 지정합니다.
라이브러리 블록의 경로를 찾습니다. 먼저, 이 블록을 포함하는 라이브러리를 엽니다.
빠른 삽입 메뉴를 사용하여 이 작업을 수행할 수 있습니다. 모델 캔버스를 더블 클릭하여 빠른 삽입 메뉴를 엽니다. 그런 다음, 블록 이름을 입력합니다. 화살표 키를 사용하여 원하는 검색 결과로 이동합니다. 오른쪽의 세부 정보 창에서 라이브러리 이름을 클릭합니다.

라이브러리가 열리면 Circular Gauge 블록을 선택합니다.
MATLAB® 명령 창에 다음 명령을 입력하여 블록 경로를 가져옵니다.
libBlockPath = gcb
libBlockPath =
'simulink_hmi_customizable_blocks/Circular Gauge'블록을 myModel에 추가하고 이름을 myBlock으로 지정합니다. 이름이 고유하도록 MakeNameUnique를 "on"으로 설정합니다.
add_block(libBlockPath,"myModel/myBlock,"MakeNameUnique="on")
myBlock이라는 블록이 포함된 myModel이라는 모델이 있다고 가정하겠습니다.
블록의 복사본을 만듭니다. 복사본의 이름을 myBlock1로 지정합니다.
add_block("myModel/myBlock","myModel/myBlock1");
myModel이라는 모델이 있다고 가정하겠습니다.
Constant 블록을 모델에 추가하고 값을 0.1로 설정합니다. 새 블록의 이름을 myBlock으로 지정하고 이름이 고유하도록 설정합니다.
add_block("simulink/Sources/Constant","myModel/myBlock",MakeNameUnique="on",Value="0.1");
포트에 대한 블록을 추가하는 방법은 목적에 따라 다릅니다. 새 포트 또는 기존 포트에 대한 블록을 추가할 수 있습니다. 또한 입력 포트에 대응하는 블록을 복제할 수도 있습니다.
새 포트에 대한 블록 추가하기
PortBlockCreation이라는 이름의 모델을 만들고 엽니다.
mdl = "PortBlockCreation";
new_system(mdl);
open_system(mdl);포트 번호로 식별되는 포트를 만들기 위해 In1 블록과 Out1 블록을 추가합니다. 기본적으로 In1 블록이나 Out1 블록을 추가하면 포트가 생성됩니다.
add_block("simulink/Ports & Subsystems/In1",... "PortBlockCreation/In1") add_block("simulink/Ports & Subsystems/Out1",... "PortBlockCreation/Out1")
포트 이름으로 식별되는 포트를 만들려면 In Bus Element 블록과 Out Bus Element 블록을 추가합니다. 기본적으로 새 In Bus Element 블록과 새 Out Bus Element 블록은 각각 InBus와 OutBus라는 이름의 포트에 대응됩니다. 이러한 포트는 포트 번호도 가지고 있습니다. 선택적으로 PortName 블록 파라미터를 사용하여 포트에 대한 사용자 지정 이름을 지정합니다.
add_block("simulink/Ports & Subsystems/In Bus Element",... "PortBlockCreation/InBusElement") add_block("simulink/Ports & Subsystems/Out Bus Element",... "PortBlockCreation/OutBusElement")
In Bus Element 블록 또는 Out Bus Element 블록을 추가할 때 포트를 만들려면 CreateNewPort를 "on"으로 설정합니다.
add_block("simulink/Ports & Subsystems/In Bus Element",... "PortBlockCreation/InBusElement1",CreateNewPort="on") add_block("simulink/Ports & Subsystems/Out Bus Element",... "PortBlockCreation/OutBusElement1",CreateNewPort="on")
CreateNewPort를 "on"으로 설정하지 않으면 동작이 달라집니다.
InBus와OutBus라는 이름의 포트가 있다고 가정하겠습니다. 추가된 블록은 이들 포트 중 하나에 대응됩니다. 블록을 추가할 때 포트 이름을 지정하면 지정된 포트 이름을 사용하기 위해InBus포트 또는OutBus포트의 이름이 변경됩니다.사용자 지정 이름을 가진 포트만 있다고 가정하겠습니다. 추가된 블록은 새 포트에 대응됩니다. 블록을 추가할 때 포트 이름을 지정하면 새 포트에 지정된 포트 이름이 사용됩니다.
새 포트 요소에 대한 블록 추가하기
In Bus Element 블록과 Out Bus Element 블록을 사용하면 하나의 입력 포트에서 여러 요소를 선택하고, 여러 요소를 하나의 출력 포트에 연결할 수 있습니다.
In Bus Element 블록에 요소를 추가하려면 포트에 대응하는 기존 블록을 복사하고 새 요소에 대한 고유한 이름을 지정합니다.
add_block("PortBlockCreation/InBusElement",... "PortBlockCreation/InBusElement2",Element="signal2")
Out Bus Element 블록에 요소를 추가하려면 포트에 대응하는 기존 블록을 복사합니다. 선택적으로 고유한 요소 이름을 지정합니다.
add_block("PortBlockCreation/OutBusElement",... "PortBlockCreation/OutBusElement2")
입력 포트에 대한 블록 복제하기
블록 다이어그램에 있는 여러 블록은 입력 포트의 동일한 입력을 사용할 수 있습니다. 입력 포트에 대응하는 블록을 복제하면 선 라우팅을 단순화할 수 있습니다.
In1 블록을 복제하기 위해 블록 다이어그램에서 블록을 복사하고 CopyOption을 "duplicate"로 설정합니다.
add_block("PortBlockCreation/In1",... "PortBlockCreation/In1Dup",CopyOption="duplicate")
In Bus Element 블록을 복제하기 위해 해당 블록을 복사합니다.
add_block("PortBlockCreation/InBusElement",... "PortBlockCreation/InBusElementDup")
복제 블록은 원래 블록과 동일한 포트 번호를 사용합니다. 이름 기반 포트의 경우 블록은 원래 블록과 동일한 포트의 동일한 요소를 선택합니다.
입력 인수
추가할 블록의 경로로, string형 또는 문자형 벡터로 지정됩니다. 블록은 라이브러리 블록일 수도 있고 모델에 있는 블록일 수도 있습니다. 추가하는 블록은 지정하는 소스 블록과 동일한 파라미터 값을 갖습니다.
내장 라이브러리에서 블록의 경로를 가져오려면 다음 단계를 따르십시오.
블록을 추가할 라이브러리를 엽니다.
빠른 삽입 메뉴를 사용하여 이 작업을 수행할 수 있습니다. 모델 캔버스를 더블 클릭하여 빠른 삽입 메뉴를 엽니다. 그런 다음, 블록 이름을 입력합니다. 화살표 키를 사용하여 원하는 검색 결과로 이동합니다. 오른쪽의 세부 정보 창에서 라이브러리 이름을 클릭합니다. 라이브러리가 열립니다.
추가할 라이브러리 블록을 선택합니다.
MATLAB 명령 창에 다음 명령을 입력하여 블록 경로를 가져옵니다.
gcb
블록 경로를 가져오는 방법에 대한 자세한 내용은 Get Handles and Paths 항목을 참조하십시오.
특정 블록 유형으로 블록을 만들려면 블록 유형을 'built-in/으로 지정합니다. 여기서 blocktype'은 프로그래밍 방식의 블록 이름입니다. 블록에 대한 blocktypeBlockType 파라미터 값을 가져오려면 Common Block Properties 항목을 참조하십시오. 'built-in/을 사용하여 추가된 블록은 라이브러리 블록과 구성이 다를 수 있습니다.blocktype'
여러 라이브러리 블록은 SubSystem을 BlockType으로 가집니다. 소스 블록을 "built-in/SubSystem"으로 지정하면 새 블록은 하나의 입력과 하나의 출력을 갖는 서브시스템을 나타냅니다. 다른 서브시스템과 마스크 처리된 블록의 경우 BlockType 값 대신에 라이브러리 블록 경로를 사용하십시오.
예: "simulink/Math Operations/Gain"
예: "built-in/Gain"
예: "myModel/myOriginalBlock"
데이터형: string | character vector
새 블록의 경로로, string형으로 지정됩니다.
블록 경로를 가져오는 방법에 대한 자세한 내용은 Get Handles and Paths 항목을 참조하십시오.
예: "myModel/myNewBlock"
데이터형: string | character vector
이름-값 인수
선택적 인수 쌍을 Name1=Value1,...,NameN=ValueN으로 지정합니다. 여기서 Name은 인수 이름이고 Value는 대응값입니다. 이름-값 인수는 다른 인수 뒤에 와야 하지만, 인수 쌍의 순서는 상관없습니다.
예: add_block("simulink/Math Operations/Gain","myModel/myNewBlock",Gain="5")는 이름이 myBlock인 Gain 블록을 추가하고 이득 값을 5로 설정합니다.
add_block 함수의 경우 블록 파라미터와 속성값을 이름-값 인수로 지정합니다. 블록 파라미터와 속성에 대한 자세한 내용은 Programmatically Specify Block Parameters and Properties 항목을 참조하십시오.
고유한 이름으로 블록을 추가하는 옵션으로, "off" 또는 "on"으로 지정됩니다. 옵션이 켜져 있고 지정된 블록 이름이 있는 경우, 블록 이름의 끝에 숫자를 추가하거나 블록 이름의 끝에 있는 숫자를 증가시킵니다.
예: add_block("simulink/Math Operations/Gain","myModel/myNewBlock",MakeNameUnique="on")
데이터형: string | character vector
복사 옵션으로, "", "nolink" 또는 "duplicate"로 지정됩니다.
"nolink"— 새 블록이 소스 블록이 포함된 사용자 지정 라이브러리에 연결되지 않습니다."duplicate"— 새 블록은 입력 포트 블록을 복제하며 소스 블록과 동일한 포트 번호를 갖습니다. 포트를 생성하거나 선을 추가하지 않고 입력 포트에서 신호를 분기하려면 입력 포트에 대응하는 블록을 복제합니다. 자세한 내용은 복제 Inport 블록 만들기 항목을 참조하십시오.
예: add_block("myLibrary/CustomBlock","myModel/CustomBlock",CopyOption="nolink")
예: add_block("myModel/mySubsystem/Inport","myModel/mySubsystem/InportDup",CopyOption="duplicate")
데이터형: string | character vector
새 버스 요소 포트용 블록을 추가하는 옵션으로, "off" 또는 "on"으로 지정됩니다. 소스 블록은 In Bus Element 블록이거나 Out Bus Element 블록이어야 합니다.
옵션을 켜면 선택적으로 PortName 파라미터를 사용하여 새 포트의 이름을 지정할 수 있습니다. 기본적으로 새 포트의 이름은 복사된 블록의 포트 이름과 숫자의 조합입니다. 복사된 블록의 포트 이름이 숫자로 끝나는 경우, 해당 숫자는 고유성을 위해 증분됩니다.
CreateNewPort를 "off"로 설정해도 포트 생성이 막히는 것은 아닙니다. 예를 들어, 모델에 첫 번째 In Bus Element 블록 또는 Out Bus Element 블록을 추가하면 포트가 생성됩니다. 블록을 추가하고 PortName을 사용하여 고유한 포트 이름을 지정해도 포트를 생성할 수 있습니다.
CreateNewPort를 "off"로 설정하면 추가된 블록이 기존 포트에 대응되도록 할 수 있습니다. 예를 들어, 모델에서 In Bus Element 블록 또는 Out Bus Element 블록을 복사하는 경우 Element 파라미터로 요소 이름을 지정하여 새 블록이 포트의 새 요소를 나타내도록 할 수 있습니다.
프로그래밍 방식으로 버스 요소 포트를 작성하는 방법에 대한 자세한 내용은 Programmatically Create Bus Element Ports 항목을 참조하십시오.
예: add_block("simulink/Ports & Subsystems/In Bus Element","myModel/InBusElement1",CreateNewPort="on")
데이터형: string | character vector
출력 인수
새 블록으로, 핸들로 반환됩니다.
팁
블록이 겹치지 않게 하려면 Position 블록 속성을 사용하여 새 블록의 위치를 지정합니다. 자세한 내용은 Programmatically Specify Block Parameters and Properties 항목을 참조하십시오.
버전 내역
R2006a 이전에 개발됨
MATLAB Command
You clicked a link that corresponds to this MATLAB command:
Run the command by entering it in the MATLAB Command Window. Web browsers do not support MATLAB commands.
웹사이트 선택
번역된 콘텐츠를 보고 지역별 이벤트와 혜택을 살펴보려면 웹사이트를 선택하십시오. 현재 계신 지역에 따라 다음 웹사이트를 권장합니다:
또한 다음 목록에서 웹사이트를 선택하실 수도 있습니다.
사이트 성능 최적화 방법
최고의 사이트 성능을 위해 중국 사이트(중국어 또는 영어)를 선택하십시오. 현재 계신 지역에서는 다른 국가의 MathWorks 사이트 방문이 최적화되지 않았습니다.
미주
- América Latina (Español)
- Canada (English)
- United States (English)
유럽
- Belgium (English)
- Denmark (English)
- Deutschland (Deutsch)
- España (Español)
- Finland (English)
- France (Français)
- Ireland (English)
- Italia (Italiano)
- Luxembourg (English)
- Netherlands (English)
- Norway (English)
- Österreich (Deutsch)
- Portugal (English)
- Sweden (English)
- Switzerland
- United Kingdom (English)