Class: Plot2DSeries

Plot2DSeries

new Plot2DSeries()

Plot2DSeries 클래스는 Plot2DChart 클래스 인스턴스의 series 속성에 설정됩니다.

Plot2DChart 컨트롤의 series 속성에 할당되는 데이터 시리즈 입니다.

차트에 설정된 데이터를 처리하고, X, Y 좌표상에 도형을 표현합니다.

레이아웃은 다음과 같은 형식으로 작성됩니다.

<rMateChart>
  <Options>
    <Caption text="Annual Report" />
  </Options>
  <Plot2DChart showDataTips="true">
    <horizontalAxis>
      <CategoryAxis categoryField="Month" />
    </horizontalAxis>
    <series>
      <Plot2DSeries yField="Profit"/>
      <Plot2DSeries yField="Cost" />
      <Plot2DSeries yField="Revenue" />
    </series>
  </Plot2DChart>
</rMateChart>

Extends

Members

displayNameString

시리즈의 이름을 설정합니다.

설정된 값은 기본적으로 데이터 팁(툴팁)에서 보여지게 되고 범례의 항목으로 표시됩니다.

Default Value:
  • null

downLabelFieldString

labelPosition 속성값이 down 또는 both 인 경우 라벨로 표시될 데이터 필드명을 설정합니다.

downLabelJsFunction 속성이 설정되어 자바스크립트에 의한 사용자 정의 라벨이 표시될 경우 이 속성은 무시됩니다.

Default Value:
  • null

downLabelXOffsetNumber

labelPosition 속성값이 down 또는 both 인 경우 가로위치(X축 값)에 대한 오프셋(Offset) 값을 설정합니다. (픽셀 단위)

Default Value:
  • 0

downLabelYOffsetNumber

labelPosition 속성값이 down 또는 both 인 경우 세로위치(Y축 값)에 대한 오프셋(Offset) 값을 설정합니다. (픽셀 단위)

Default Value:
  • 6

errorBarDirectionString

오차 범위의 모양을 설정합니다.

유효값은 both, plus, minus 입니다.

Default Value:
  • both

errorBarFixedValueNumber

오차 범위에 고정값을 설정합니다.

Default Value:
  • NaN

errorBarLengthNumber

오차 범위 모양의 가로 크기를 설정합니다.

Default Value:
  • 7

errorBarPercentValueNumber

오차 범위에 퍼센트 값을 설정합니다.

Default Value:
  • NaN

errorBarStrokeObject

오차 범위 선의 스타일을 설정합니다.

유효값은 Stroke 클래스 인스턴스입니다.

Default Value:
  • Stroke("#000000")

fillObject

시리즈 아이템렌더러의 채우기 색을 설정합니다.

Default Value:
  • null

fillsArray

차트에 표시되는 데이터가 여러개 일 때, 각 데이터에 서로 다른 색상을 설정합니다.

만약 데이터 수만큼의 색상 객체(SolidColor)가 설정되지 않으면 설정된 색상이 반복 적용됩니다.

예를 들어, 시리즈의 데이터 수가 10 이고 5 개의 색상 객체(SolidColor)가 설정되었다면, 5 개의 색상 객체가 처음 5 개의 데이터에 순서대로 적용되고 나머지 5 개의 데이터에는 5 개의 색상 객체가 다시 순차적으로 적용됩니다.

유효값은 SolidColor 클래스의 인스턴스 배열입니다.

<fills>
  <SolidColor color="0xCC66FF" />
  <SolidColor color="0x9966CC" />
  <SolidColor color="0x9999CC" />
</fills>
Default Value:
  • null

formatterObject

숫자값을 원하는 숫자(통화, 날짜) 형식으로 표현하기 위한 포맷터(NumberFormatter, CurrencyFormatter, DateFormatter)를 설정합니다.

Default Value:
  • NumberFormatter

hideDataEffectObject

차트상에 데이터가 사라지는 모습을 보여줄 애니메이션 이펙트를 설정합니다.

유효값은 showDataEffect 속성과 동일합니다.

Default Value:
  • null

horizontalAxisObject

시리즈가 참조할 수평축을 설정합니다.

설정하지 않으면 차트의 horizontalAxis 속성에 설정된 축을 참조합니다.

Default Value:
  • null

idString

식별자(Identifier)를 설정합니다.

식별자(Identifier)는 사용자에 의해 정의된 임의의 고유값입니다.

설정된 식별자(Identifier)를 통해 해당 객체에 접근이 가능합니다.

Default Value:
  • null

interactiveBoolean

시리즈에 마우스 오버시 데이터 팁을 보여줄 지 여부를 설정합니다.

Default Value:
  • true

itemRendererObject

차트상의 데이터 포인트(데이터 아이템)에 표현될 도형을 렌더링하는 클래스를 설정합니다.

유효값은 다음과 같습니다.


  • DiamondItemRenderer

  • CircleItemRenderer

  • TriangleItemRenderer

  • CrossItemRenderer

  • XShapeItemRenderer

  • IShapeItemRenderer

  • RectangleItemRenderer

Default Value:
  • null

itemRollOverColorHexadecimal

데이터 아이템에 마우스 오버했을 때의 색상을 설정합니다.

Default Value:
  • null

itemRollOverEmphasizeBoolean

데이터 아이템에 마우스 오버했을 때의 아이템을 강조합니다.

Default Value:
  • false

itemSelectionColorHexadecimal

데이터 아이템을 선택했을 떄의 색상을 설정합니다.

Default Value:
  • null

labelBackgroundColorString

라벨 배경의 색상을 설정합니다.

Default Value:
  • transparent

labelBorderRadiusNumber

라벨 테두리의 둥근 정도를 설정합니다.

Default Value:
  • 0

labelBoxHeightOffsetNumber

라벨 배경의 추가 높이값을 설정합니다.

Default Value:
  • 0

labelBoxWidthOffsetNumber

라벨 배경의 추가 너비값을 설정합니다.

Default Value:
  • 0

labelPositionString

데이터 아이템의 라벨이 표시될 데이터 포인트 상의 위치를 설정합니다.

유효값은 up, down, both, none 입니다.

Default Value:
  • none

movingAveragePeriodNumber

trendLineType 속성값이 movingAverage 인 경우 이동 평균선의 구간을 설정합니다.

Default Value:
  • 2

polynomialOrderNumber

trendLineType 속성값이 polynomial 인 경우 다항식에 대한 차수를 설정합니다.

Default Value:
  • 2

radiusNumber

데이터 아이템 렌더러(itemRenderer)에 의해서 표현되는 도형의 반지름을 설정합니다.

Default Value:
  • 4

selectableBoolean

마우스로 데이터를 선택 가능하도록 할 지 여부를 설정합니다.

Default Value:
  • true

selectionRadiusNumber

마우스 오버시 데이터 아이템 렌더러(itemRenderer)에 의해서 표현되는 도형의 반지름을 설정합니다.

Default Value:
  • 8

showDataEffectObject

차트상에 데이터가 표현되는 모습을 보여줄 애니메이션 이펙트를 설정합니다.

유효값은 다음과 같습니다.


  • SeriesInterpolate - 축상의 최소값 지점에서 데이터 값에 해당되는 지점까지의 출력에 대한 애니메이션 이펙트를 표현합니다.

  • SeriesSlide - 슬라이딩 효과를 재생하는 이펙트입니다. 슬라이딩 방향은 좌우, 우좌, 상하, 하상과 같이 원하는 형태로 설정할 수 있습니다.

  • SeriesZoom - 설정된 기준점에서 시작하여 데이터 아이템들이 점점 확대되어 표시되는 형태의 애니메이션 이펙트를 표현합니다.

Default Value:
  • null

showErrorBarBoolean

에러 범위에 대한 표시 여부를 설정합니다.

Default Value:
  • false

showTrendLineBoolean

추세선을 표시할 지 여부를 설정합니다.

Default Value:
  • false

showTrendLineEquationBoolean

차트상의 데이터로부터 얻어진 추세선의 표현 공식을 표시할 지 여부를 설정합니다.

Default Value:
  • false

showTrendLineRSquaredBoolean

차트상의 데이터로부터 얻어진 추세선의 R-squared 값을 표시할 지 여부를 설정합니다.

Default Value:
  • false

sortOnXFieldBoolean

차트에서 사용될 데이터에 대해서 X축 데이터를 기준으로 자동으로 정렬할 지 여부를 설정합니다.

값이 false 이면 데이터가 입력된 순서로 차트에 표현됩니다.

정렬은 다음과 같은 방법으로 수행됩니다.

  1. X축은 숫자 축(LinearAxis)이어야 합니다.
  2. 시리즈의 xField 속성(X축 데이터)에 데이터 필드명을 설정합니다.
  3. sortOnXField 설정에 따라서 차트에 표현되는 데이터의 순서가 달라집니다.
  4. {"data":4},{"data":1},{"data":2},{"data":3} 순으로 데이터가 입력되었을 경우

    • true - 1, 2, 3, 4 의 순서로 데이터가 표현됩니다.

    • false - 4, 1, 2, 3 의 순서로 데이터가 표현됩니다.

Default Value:
  • true

sortOnYFieldBoolean

차트에서 사용될 데이터에 대해서 Y축 데이터를 기준으로 자동으로 정렬할 지 여부를 설정합니다.

값이 false 이면 데이터가 입력된 순서로 차트에 표현됩니다.

정렬은 다음과 같은 방법으로 수행됩니다.

  1. Y축은 숫자 축(LinearAxis)이어야 합니다.
  2. 시리즈의 yField 속성(Y축 데이터)에 데이터 필드명을 설정합니다.
  3. sortOnYField 설정에 따라서 차트에 표현되는 데이터의 순서가 달라집니다.
  4. {"data":4},{"data":1},{"data":2},{"data":3} 순으로 데이터가 입력되었을 경우

    • true - 1, 2, 3, 4 의 순서로 데이터가 표현됩니다.

    • false - 4, 1, 2, 3 의 순서로 데이터가 표현됩니다.

Default Value:
  • true

strokeObject

데이터 아이템 렌더러(itemRenderer)에 의해서 표현되는 도형의 선을 설정합니다.

유효값은 Stroke 클래스 인스턴스입니다.

Default Value:
  • null

styleNameString

스타일을 <Style> 노드에 설정할 경우, <Style> 노드에 정의된 이름을 설정합니다.

<Style> 노드에 스타일을 정의할 때는 반드시 스타일명 앞에 마침표가 위치해야 합니다.

레이아웃은 다음과 같은 형식으로 작성됩니다.

<Bar3DChart>
  <Bar3DSeries xField="Profit" styleName="seriesStyle">
  ...
</Bar3DChart>
<Style>
  .seriesStyle {fontFamily:"Malgun Gothic";labelPosition:inside;fontSize:11;paddingTop:4;color:0x000099;}
</Style>
Default Value:
  • null

trendLineColorHexadecimal

추세선 공식과 R-squared 값의 텍스트 색상을 설정합니다.

Default Value:
  • #777777

trendLineFormString

추세선에 대한 선의 유형을 설정합니다.

유효값은 다음과 같습니다.


  • segment

  • curve

  • step

  • reverseStep

Default Value:
  • curve

trendLineLabelHorizontalAlignString

추세선 공식과 R-squared 값 표시를 위한 수평 정렬을 설정합니다.

유효값은 none, left, center, right 입니다.

Default Value:
  • none

trendLineLabelOrderString

추세선 공식과 R-squared 값의 출력 순서를 설정합니다.

유효값은 none, reverse 입니다.

Default Value:
  • none

trendLineLabelVerticalAlignString

추세선 공식과 R-squared 값 표시를 위한 수직 정렬을 설정합니다.

유효값은 none, top, middle, bottom 입니다.

Default Value:
  • none

trendLineStrokeObject

추세선에 대한 선의 스타일을 설정합니다.

유효값은 Stroke 클래스 인스턴스입니다.

Default Value:
  • Stroke("#777777")

trendLineTypeString

추세선의 유형을 설정합니다.

유효값은 다음과 같습니다.


  • linear - 선형

  • logarithmic - 로그

  • exponential - 지수

  • polynomial - 다항식

  • power - 거듭제곱

  • movingAverage - 이동 평균선

Default Value:
  • linear

upLabelFieldString

labelPosition 속성값이 up 또는 both 인 경우 라벨로 표시될 데이터 필드명을 설정합니다.

upLabelJsFunction 속성이 설정되어 자바스크립트에 의한 사용자 정의 라벨이 표시될 경우 이 속성은 무시됩니다.

Default Value:
  • null

upLabelXOffsetNumber

labelPosition 속성값이 up 또는 both 인 경우 가로위치(X축 값)에 대한 오프셋(Offset) 값을 설정합니다. (픽셀 단위)

Default Value:
  • 0

upLabelYOffsetNumber

labelPosition 속성값이 up 또는 both 인 경우 세로위치(Y축 값)에 대한 오프셋(Offset) 값을 설정합니다. (픽셀 단위)

Default Value:
  • -6

verticalAxisObject

시리즈가 참조할 수직축을 설정합니다.

설정하지 않으면 차트의 verticalAxis 속성에 설정된 축을 참조합니다.

Default Value:
  • null

visibleBoolean

시리즈를 차트에 출력할 지 여부를 설정합니다.

Default Value:
  • true

xFieldString

데이터 아이템의 X 좌표값(수평축에서의 위치)을 결정하는 데이터 필드명을 설정합니다.

Default Value:
  • null

yFieldString

데이터 아이템의 Y 좌표값(수직축에서의 위치)을 결정하는 데이터 필드명을 설정합니다.

Default Value:
  • null

Methods

downLabelJsFunction(seriesId, index, data, values)

labelPosition 속성값이 down 또는 both 인 경우 사용자 정의 라벨을 출력할 자바스크립트 함수명을 설정합니다.

 <Plot2DSeries xField="x" yField="y" downLabelJsFunction="downLabelFunc">
 ...
 downLabelFunc(seriesId, index, data, values) {
   ...
 }
Name Type Description
seriesId String

시리즈 식별자(Identifier)
index Number

데이터 아이템의 인덱스
data Object

데이터 아이템의 데이터 객체
values Array

데이터 아이템의 데이터 배열
0 : x축 값, 1 : y축 값

inherited fillJsFunction(seriesId, index, data, values)

사용자 정의 색상을 설정하는 자바스크립트 함수명을 설정합니다.

차트 레이아웃 설정시 Series 클래스 인스턴스의 fillJsFunction 속성값에 자바스크립트 함수명을 설정합니다.

<Column2DSeries yField="Profit" fillJsFunction="fillJsFunc">
...
fillJsFunc(seriesId, index, data, values) {
  ...
}

values 값은 배열로 전달되며 차트의 종류에 따라 다음과 같습니다.
1.  바 시리즈(Bar2DSeries, Bar3DSeries) - 0 : x축 값, 1 : y축 값
2.  컬럼 시리즈(Column2DSeries, Column3DSeries) - 0 : x축 값, 1 : y축 값
3.  영역 시리즈(Area2DSeries, CandleArea2DSeries) - 0 : x축 값, 1 : y축 값
4.  버블 시리즈(Bubble2DSeries, Bubble3DSeries) - 0 : x축 값, 1 : y축 값, 2 : radius 값
5.  라인 시리즈(Line2DSeries, CandleLine2DSeries) - 0 : x축 값, 1 : y축 값
6.  파이 시리즈(Pie2DSeries, Pie3DSeries) - 0 : 값, 1 : 퍼센티지, 2 : nameField 값
7.  캔들 시리즈(Candlestick2DSeries) - 0 : x축 값, 1 : openField 값, 2 : closeField 값, 3 : highField 값, 4 : lowField 값
8.  윙 시리즈(Column2DWingSeries, Bar2DWingSeries) - 0 : x축 값, 1 : y축 값, 2 : xOpp 값, 3 : yOpp 값
9.  히스토그램 시리즈(Histogram2D, Histogram3DSeries) - 0 : x축 값, 1 : y축 값
10. 트리맵 시리즈(TreeMapSeries) - 0 : weight 값, 1 : text 값
11. 박스플롯 시리즈(BoxPlotSeries) - 0 : upper 값, 1 : median 값, 2 : lower 값, 3 : min 값, 4 : hidden 값
12. 벡터 시리즈(Vector2DSeries) - 0 : degree 값, 1 : velocity 값, 2 : meter 값
13. 워드클라우드 시리즈(WordCloudSeries) - 0 : text 값, 1 : weight 값
14. 피라미드, 퓨넬 시리즈(Pyramid2DSeries) - 0 : weight 값, 1 : nameField 값
15. 오버레이버블 시리즈(OverlayBubbleSeries) - 0 : field 값, 1 : nameField 값
16. 이미지매트릭스 시리즈(ImageMatrixSeries) - 0 : value 값
17. 윈드로즈 시리즈(WindRoseSeries) - 0 : field 값
Name Type Description
seriesId String

시리즈 식별자(Identifier)
index Number

데이터 아이템의 인덱스
data Object

데이터 아이템의 데이터 객체
values Array

데이터 아이템의 데이터 배열

inherited htmlJsFunction(seriesId, index, data, values)

차트의 데이터 아이템들 중에서 설정된 조건을 만족하는 데이터 아이템에 대해서 실핼될 자바스크립트 함수명을 설정합니다.

차트 레이아웃 설정시 Series 클래스 인스턴스의 htmlJsFunction 속성값에 자바스크립트 함수명을 설정합니다.

<Column2DSeries yField="Profit" htmlJsFunction="userElementFunc">
...
userElementFunc(seriesId, index, data, values) {
  ...
}

values 값은 배열로 전달되며 차트의 종류에 따라 다음과 같습니다.
1.  바 시리즈(Bar2DSeries, Bar3DSeries) - 0 : x축 값, 1 : y축 값
2.  컬럼 시리즈(Column2DSeries, Column3DSeries) - 0 : x축 값, 1 : y축 값
3.  영역 시리즈(Area2DSeries, CandleArea2DSeries) - 0 : x축 값, 1 : y축 값
4.  버블 시리즈(Bubble2DSeries, Bubble3DSeries) - 0 : x축 값, 1 : y축 값, 2 : radius 값
5.  라인 시리즈(Line2DSeries, CandleLine2DSeries) - 0 : x축 값, 1 : y축 값
6.  파이 시리즈(Pie2DSeries, Pie3DSeries) - 0 : 값, 1 : 퍼센티지, 2 : nameField 값
7.  캔들 시리즈(Candlestick2DSeries) - 0 : x축 값, 1 : openField 값, 2 : closeField 값, 3 : highField 값, 4 : lowField 값
8.  윙 시리즈(Column2DWingSeries, Bar2DWingSeries) - 0 : x축 값, 1 : y축 값, 2 : xOpp 값, 3 : yOpp 값
9.  히스토그램 시리즈(Histogram2D, Histogram3DSeries) - 0 : x축 값, 1 : y축 값
10. 트리맵 시리즈(TreeMapSeries) - 0 : weight 값, 1 : text 값
11. 박스플롯 시리즈(BoxPlotSeries) - 0 : upper 값, 1 : median 값, 2 : lower 값, 3 : min 값, 4 : hidden 값
12. 벡터 시리즈(Vector2DSeries) - 0 : degree 값, 1 : velocity 값, 2 : meter 값
13. 워드클라우드 시리즈(WordCloudSeries) - 0 : text 값, 1 : weight 값
14. 피라미드, 퓨넬 시리즈(Pyramid2DSeries) - 0 : weight 값, 1 : nameField 값
15. 오버레이버블 시리즈(OverlayBubbleSeries) - 0 : field 값, 1 : nameField 값
16. 이미지매트릭스 시리즈(ImageMatrixSeries) - 0 : value 값
17. 윈드로즈 시리즈(WindRoseSeries) - 0 : field 값
Name Type Description
seriesId String

시리즈 식별자(Identifier)
index Number

데이터 아이템의 인덱스
data Object

데이터 아이템의 데이터 객체
values Array

데이터 아이템의 데이터 배열

inherited strokeJsFunction(seriesId, index, data, values)

아이템 렌더러에 의해 표현되는 아이템 테두리에 대한 사용자 정의 함수를 설정합니다.

차트 레이아웃 설정시 Series 클래스 인스턴스의 strokeJsFunction 속성값에 자바스크립트 함수명을 설정합니다.

<Column2DSeries yField="Profit" strokeJsFunction="strokeJsFunc">
...
strokeJsFunc(seriesId, index, data, values) {
  ...
}

values 값은 배열로 전달되며 차트의 종류에 따라 다음과 같습니다.
1.  바 시리즈(Bar2DSeries, Bar3DSeries) - 0 : x축 값, 1 : y축 값
2.  컬럼 시리즈(Column2DSeries, Column3DSeries) - 0 : x축 값, 1 : y축 값
3.  영역 시리즈(Area2DSeries, CandleArea2DSeries) - 0 : x축 값, 1 : y축 값
4.  버블 시리즈(Bubble2DSeries, Bubble3DSeries) - 0 : x축 값, 1 : y축 값, 2 : radius 값
5.  라인 시리즈(Line2DSeries, CandleLine2DSeries) - 0 : x축 값, 1 : y축 값
6.  파이 시리즈(Pie2DSeries, Pie3DSeries) - 0 : 값, 1 : 퍼센티지, 2 : nameField 값
7.  캔들 시리즈(Candlestick2DSeries) - 0 : x축 값, 1 : openField 값, 2 : closeField 값, 3 : highField 값, 4 : lowField 값
8.  윙 시리즈(Column2DWingSeries, Bar2DWingSeries) - 0 : x축 값, 1 : y축 값, 2 : xOpp 값, 3 : yOpp 값
9.  히스토그램 시리즈(Histogram2D, Histogram3DSeries) - 0 : x축 값, 1 : y축 값
10. 트리맵 시리즈(TreeMapSeries) - 0 : weight 값, 1 : text 값
11. 박스플롯 시리즈(BoxPlotSeries) - 0 : upper 값, 1 : median 값, 2 : lower 값, 3 : min 값, 4 : hidden 값
12. 벡터 시리즈(Vector2DSeries) - 0 : degree 값, 1 : velocity 값, 2 : meter 값
13. 워드클라우드 시리즈(WordCloudSeries) - 0 : text 값, 1 : weight 값
14. 피라미드, 퓨넬 시리즈(Pyramid2DSeries) - 0 : weight 값, 1 : nameField 값
15. 오버레이버블 시리즈(OverlayBubbleSeries) - 0 : field 값, 1 : nameField 값
16. 이미지매트릭스 시리즈(ImageMatrixSeries) - 0 : value 값
17. 윈드로즈 시리즈(WindRoseSeries) - 0 : field 값
Name Type Description
seriesId String

시리즈 식별자(Identifier)
index Number

데이터 아이템의 인덱스
data Object

데이터 아이템의 데이터 객체
values Array

데이터 아이템의 데이터 배열

upLabelJsFunction(seriesId, index, data, values)

labelPosition 속성값이 up 또는 both 인 경우 사용자 정의 라벨을 출력할 자바스크립트 함수명을 설정합니다.

 <Plot2DSeries xField="x" yField="y" upLabelJsFunction="upLabelFunc">
 ...
 upLabelFunc(seriesId, index, data, values) {
   ...
 }
Name Type Description
seriesId String

시리즈 식별자(Identifier)
index Number

데이터 아이템의 인덱스
data Object

데이터 아이템의 데이터 객체
values Array

데이터 아이템의 데이터 배열
0 : x축 값, 1 : y축 값