batteryChart

배터리 객체 시각화

R2022b 이후

페이지 내 모두 확장

설명

batteryChart를 사용하여 Simscape™ Battery™ 객체를 시각화하기 위한 배터리 차트를 생성합니다.

참고

BatteryChart 객체는 표시하는 객체의 독립적 복사본을 저장하고 객체의 속성은 수정하지 않습니다.

BatteryChart 객체는 배터리의 전역 좌표계에 따라 다음과 같이 배터리 객체를 표시합니다.

이러한 레이블을 차트에서 활성화하려면 setDefaultLabels 함수를 사용하십시오. 레이블 설정에 대한 자세한 내용은 BatteryChart 객체에 대한 레이블 설정하기 항목을 참조하십시오.

BatteryChart 객체를 사용하면 배터리 컴포넌트의 현재 시뮬레이션 전략과 모델 분해능도 확인할 수 있습니다. 차트에서 시뮬레이션 전략을 시각화하려면 SimulationStrategyVisible 속성을 "on"으로 설정하거나 차트의 오른쪽 위 코너에 있는 "시뮬레이션 전략 표시/숨기기" 버튼을 클릭합니다.

예를 들어 ParallelAssembly 객체의 ModelResolution 속성을 "Lumped"로 설정하면 객체는 NumParallelCells 속성을 사용하여 셀 모델 블록의 전기 파라미터를 자동으로 스케일링합니다. 다음 Figure는 일괄 병렬 어셈블리에 대한 시뮬레이션 전략을 보여줍니다.

단 하나의 셀 모델 블록으로 주황색 상자 내부의 모든 셀 컴포넌트를 나타냅니다.

ParallelAssembly 객체의 ModelResolution 속성을 "Grouped"로 설정하면 대신에 NumParallelCells 속성의 값과 동일한 개수의 셀 모델 블록들이 각각의 셀 컴포넌트를 나타냅니다.

생성

구문

chart = batteryChart(Parent,Battery)

chart = batteryChart(Battery)

chart = batteryChart(___,Name=Value)

설명

예제

chart = batteryChart(Parent,Battery)는 Battery 속성에 지정된 배터리 객체를 시각화하는 BatteryChart 객체를 Parent 속성에 지정된 컨테이너에 생성합니다.

chart = batteryChart(Battery)는 Battery 속성에 지정된 배터리 객체를 시각화하는 BatteryChart 객체를 생성합니다.

chart = batteryChart(___,Name=Value)는 하나 이상의 이름-값 인수를 사용하여 속성를 설정합니다. 이전 구문의 모든 인수 뒤에 이름-값 인수를 지정하십시오.

속성

모두 확장

`Parent` — 배터리 시각화를 위한 컨테이너
`Figure` 객체 (디폴트 값)

배터리 시각화를 위한 컨테이너로, Figure 객체로 지정됩니다.

`Battery` — 시각화할 배터리 객체
`Cell` 객체 | `ParallelAssembly` 객체 | `Module` 객체 | `ModuleAssembly` 객체 | `Pack` 객체

시각화할 배터리 객체로, Cell 객체, ParallelAssembly 객체, Module 객체, ModuleAssembly 객체 또는 Pack 객체로 지정됩니다.

`AxesVisible` — 차트의 좌표축을 시각화하기 위한 옵션
`"on"` (디폴트 값) | `"off"`

차트의 좌표축을 시각화하기 위한 옵션으로, "on" 또는 "off"로 지정됩니다.

`AxesXDir` — x축을 따라 값이 증가하는 방향
`"normal"` (디폴트 값) | `"reverse"`

x축을 따라 값이 증가하는 방향으로, 다음과 같이 지정됩니다.

"normal" — 값이 차트의 중심에서 바깥쪽으로 증가합니다.
"reverse" — 값이 차트의 중심에서 바깥쪽으로 감소합니다.

`AxesYDir` — y축을 따라 값이 증가하는 방향
`"normal"` (디폴트 값) | `"reverse"`

y축을 따라 값이 증가하는 방향으로, 다음과 같이 지정됩니다.

"normal" — 값이 차트의 중심에서 바깥쪽으로 증가합니다.
"reverse" — 값이 차트의 중심에서 바깥쪽으로 감소합니다.

`AxesZDir` — z축을 따라 값이 증가하는 방향
`"normal"` (디폴트 값) | `"reverse"`

z축을 따라 값이 증가하는 방향으로, 다음과 같이 지정됩니다.

"normal" — 값이 차트의 중심에서 바깥쪽으로 증가합니다.
"reverse" — 값이 차트의 중심에서 바깥쪽으로 감소합니다.

`SimulationStrategyVisible` — 차트의 좌표축을 시각화하기 위한 옵션
`"on"` (디폴트 값) | `"off"`

차트에 강조 표시되는 시뮬레이션 전략을 표시할지 여부로, "on" 또는 "off"로 지정됩니다.

`SimulationStrategyLineColor` — 시뮬레이션 전략의 선 색
`[0.8500 0.3250 0.0980]` (디폴트 값) | RGB 3색 | 16진수 색 코드 | `'r'` | `'g'` | `'b'` | ...

차트에 강조 표시되는 시뮬레이션 전략의 선 색으로, RGB 3색, 16진수 색 코드, 색 이름 또는 짧은 이름으로 지정됩니다.

사용자 지정 색의 경우에는 RGB 3색 또는 16진수 색 코드를 지정하십시오.

RGB 3색은 요소를 3개 가진 행 벡터로, 각 요소는 색을 구성하는 빨간색, 녹색, 파란색의 농도를 지정합니다. 농도의 범위는 [0,1]이어야 합니다(예: [0.4 0.6 0.7]).
16진수 색 코드는 문자형 벡터 또는 string형 스칼라로, 해시 기호(#)로 시작하고 그 뒤에 3자리 또는 6자리의 16진수 숫자(0에서 F 사이일 수 있음)가 옵니다. 이 값은 대/소문자를 구분하지 않습니다. 따라서 색 코드 '#FF8800', '#ff8800', '#F80', '#f80'은 모두 동일합니다.

몇몇의 흔한 색은 이름으로 지정할 수도 있습니다. 다음 표에는 명명된 색 옵션과 그에 해당하는 RGB 3색 및 16진수 색 코드가 나와 있습니다.

색 이름	짧은 이름	RGB 3색	16진수 색 코드	모양
`'red'`	`'r'`	`[1 0 0]`	`'#FF0000'`
`'green'`	`'g'`	`[0 1 0]`	`'#00FF00'`
`'blue'`	`'b'`	`[0 0 1]`	`'#0000FF'`
`'cyan'`	`'c'`	`[0 1 1]`	`'#00FFFF'`
`'magenta'`	`'m'`	`[1 0 1]`	`'#FF00FF'`
`'yellow'`	`'y'`	`[1 1 0]`	`'#FFFF00'`
`'black'`	`'k'`	`[0 0 0]`	`'#000000'`
`'white'`	`'w'`	`[1 1 1]`	`'#FFFFFF'`
`'none'`	해당 없음	해당 없음	해당 없음	색 없음

다음은 디폴트 색에 대한 RGB 3색과 16진수 색 코드입니다.

RGB 3색	16진수 색 코드	모양
`[0 0.4470 0.7410]`	`'#0072BD'`
`[0.8500 0.3250 0.0980]`	`'#D95319'`
`[0.9290 0.6940 0.1250]`	`'#EDB120'`
`[0.4940 0.1840 0.5560]`	`'#7E2F8E'`
`[0.4660 0.6740 0.1880]`	`'#77AC30'`
`[0.3010 0.7450 0.9330]`	`'#4DBEEE'`
`[0.6350 0.0780 0.1840]`	`'#A2142F'`

`SimulationStrategyLineStyle` — 시뮬레이션 전략의 선 스타일
`":"` (디폴트 값) | 문자형 벡터 | string형

차트에 강조 표시되는 시뮬레이션 전략의 선 스타일로, 기호를 포함하는 문자형 벡터 또는 string형으로 지정됩니다.

예: '--'는 파선입니다

선 스타일	설명	결과 선
`'-'`	실선
`'--'`	파선
`':'`	점선
`'-.'`	일점 쇄선

`SimulationStrategyLineWidth` — 시뮬레이션 전략의 선 너비
`1.5` (디폴트 값) | 양의 값

차트에 강조 표시되는 시뮬레이션 전략의 선 너비로, 양의 값으로 지정됩니다(단위: 포인트). 여기서 1포인트는 1/72인치와 같습니다.

선 너비는 픽셀 너비보다 가늘 수 없습니다. 선 너비를 시스템의 픽셀 너비보다 작은 값으로 설정할 경우 선은 1픽셀 너비로 표시됩니다.

`LightColor` — 조명 색
`[1 1 1]` (디폴트 값) | RGB 3색 | 16진수 색 코드 | `'r'` | `'g'` | `'b'` | ...

조명 색으로, RGB 3색, 16진수 색 코드, 색 이름 또는 짧은 이름으로 지정됩니다. 디폴트 RGB 3색인 [1 1 1]은 흰색에 대응됩니다.

RGB 3색과 16진수 색 코드는 사용자 지정 색을 지정할 때 유용합니다.

RGB 3색은 요소를 3개 가진 행 벡터로, 각 요소는 색을 구성하는 빨간색, 녹색, 파란색의 농도를 지정합니다. 농도의 범위는 [0,1]이어야 합니다(예: [0.4 0.6 0.7]).
16진수 색 코드는 문자형 벡터 또는 string형 스칼라로, 해시 기호(#)로 시작하고 그 뒤에 3자리 또는 6자리의 16진수 숫자(0에서 F 사이일 수 있음)가 옵니다. 이 값은 대/소문자를 구분하지 않습니다. 따라서 색 코드 '#FF8800', '#ff8800', '#F80', '#f80'은 모두 동일합니다.

몇몇의 흔한 색은 이름으로 지정할 수도 있습니다. 다음 표에는 명명된 색 옵션과 그에 해당하는 RGB 3색 및 16진수 색 코드가 나와 있습니다.

색 이름	짧은 이름	RGB 3색	16진수 색 코드
`'red'`	`'r'`	`[1 0 0]`	`'#FF0000'`
`'green'`	`'g'`	`[0 1 0]`	`'#00FF00'`
`'blue'`	`'b'`	`[0 0 1]`	`'#0000FF'`
`'cyan'`	`'c'`	`[0 1 1]`	`'#00FFFF'`
`'magenta'`	`'m'`	`[1 0 1]`	`'#FF00FF'`
`'yellow'`	`'y'`	`[1 1 0]`	`'#FFFF00'`
`'black'`	`'k'`	`[0 0 0]`	`'#000000'`
`'white'`	`'w'`	`[1 1 1]`	`'#FFFFFF'`

다음은 디폴트 색에 대한 RGB 3색과 16진수 색 코드입니다.

RGB 3색	16진수 색 코드	모양
`[0 0.4470 0.7410]`	`'#0072BD'`
`[0.8500 0.3250 0.0980]`	`'#D95319'`
`[0.9290 0.6940 0.1250]`	`'#EDB120'`
`[0.4940 0.1840 0.5560]`	`'#7E2F8E'`
`[0.4660 0.6740 0.1880]`	`'#77AC30'`
`[0.3010 0.7450 0.9330]`	`'#4DBEEE'`
`[0.6350 0.0780 0.1840]`	`'#A2142F'`

예: 'green'

`LightStyle` — 광원의 유형
`'infinite'` (디폴트 값) | `'local'`

광원 유형으로, 다음과 같이 지정됩니다.

'infinite' — 조명을 무한대에 배치합니다. LightPosition 속성을 사용하여 조명이 평행 광선으로 비추는 방향을 지정합니다.
'local' — 조명을 LightPosition 속성으로 지정된 위치에 배치합니다. 이 조명은 해당 위치에서 모든 방향을 비추는 점 광원입니다.

`LightPosition` — 광원의 위치
`[-1 -1 1]` (디폴트 값) | `[x y z]` 형식의, 요소를 3개 가진 벡터

광원 위치로, [x y z] 형식의, 요소를 3개 가진 벡터로 지정됩니다. 좌표축 원점에서 (x, y, z) 좌표까지의 벡터 요소를 데이터 단위로 정의합니다. 조명의 실제 위치는 LightStyle 속성값에 따라 달라집니다.

예: [-40 -4 140]

`LightVisible` — 광원의 조명 표시 여부
`'on'` (디폴트 값) | on/off 논리값

광원의 조명을 표시할지 여부로, 'on' 또는 'off'나 숫자형 값 또는 논리값 1(true) 또는 0 (false)으로 지정됩니다. 값 'on'은 true와 동일하고, 값 'off'는 false와 동일합니다. 따라서 이 속성의 값을 논리값으로 사용할 수 있습니다.

예제

모두 축소

원통형 기하 형태로 셀 객체 시각화하기

원통형 Cell 객체를 만들고 위치를 수정합니다.

cell = batteryCell(batteryCylindricalGeometry,Position=[1 1 1])

batteryChart를 사용하여 Cell 객체를 시각화합니다.

cellChart = batteryChart(cell)

`BatteryChart` 객체에 대한 레이블 설정하기

BatteryChart 객체에 대한 레이블을 설정하려면 원통형 기하 형태로 셀 객체 시각화하기의 단계에 따라 BatteryChart 객체를 만든 다음 setDefaultLabels 메서드를 사용합니다.

cellChart.setDefaultLabels

버전 내역

R2022b에 개발됨

참고 항목

앱

배터리 빌더

객체

Cell | ParallelAssembly | Module | ModuleAssembly | Pack | BatterySimulationLog | BatterySimulationChart

batteryChart

설명

생성

구문

설명

속성

Parent — 배터리 시각화를 위한 컨테이너 Figure 객체 (디폴트 값)

Battery — 시각화할 배터리 객체 Cell 객체 | ParallelAssembly 객체 | Module 객체 | ModuleAssembly 객체 | Pack 객체

AxesVisible — 차트의 좌표축을 시각화하기 위한 옵션 "on" (디폴트 값) | "off"

AxesXDir — x축을 따라 값이 증가하는 방향 "normal" (디폴트 값) | "reverse"

AxesYDir — y축을 따라 값이 증가하는 방향 "normal" (디폴트 값) | "reverse"

AxesZDir — z축을 따라 값이 증가하는 방향 "normal" (디폴트 값) | "reverse"

SimulationStrategyVisible — 차트의 좌표축을 시각화하기 위한 옵션 "on" (디폴트 값) | "off"

SimulationStrategyLineColor — 시뮬레이션 전략의 선 색 [0.8500 0.3250 0.0980] (디폴트 값) | RGB 3색 | 16진수 색 코드 | 'r' | 'g' | 'b' | ...

SimulationStrategyLineStyle — 시뮬레이션 전략의 선 스타일 ":" (디폴트 값) | 문자형 벡터 | string형

SimulationStrategyLineWidth — 시뮬레이션 전략의 선 너비 1.5 (디폴트 값) | 양의 값

LightColor — 조명 색 [1 1 1] (디폴트 값) | RGB 3색 | 16진수 색 코드 | 'r' | 'g' | 'b' | ...

LightStyle — 광원의 유형 'infinite' (디폴트 값) | 'local'

LightPosition — 광원의 위치 [-1 -1 1] (디폴트 값) | [x y z] 형식의, 요소를 3개 가진 벡터

LightVisible — 광원의 조명 표시 여부 'on' (디폴트 값) | on/off 논리값

예제