VisActor VBI
  • 한국어

      • RoseParallel

      권장

      - 권장 필드 구성: 1개 지표, 1개 차원

      - 데이터 리셰이프 지원: 최소 1개 지표, 0개 차원

      인코딩 매핑

      그룹형 로즈 차트는 다음 시각 채널을 지원합니다:

      angle : 각도 채널, 여러 차원을 지원하며 차원 값을 각도 축에 매핑합니다

      radius : 반지름 채널, 여러 지표를 지원하며 지표 값을 반지름 축에 매핑합니다

      detail : 세부 채널, 여러 차원을 지원하며 같은 색상 계열 내에서 더 세분화된 데이터를 표시할 때 사용합니다

      color : 색상 채널, 여러 차원 또는 하나의 지표를 지원합니다. 차원 색상은 데이터 계열을 구분하는 데 사용되고, 지표 색상은 지표 값을 그래픽 색상에 선형 매핑하는 데 사용됩니다

      tooltip: 툴팁 채널, 여러 차원과 여러 지표를 지원하며 데이터 포인트에 마우스를 올릴 때 표시됩니다

      label : 라벨 채널, 여러 차원과 여러 지표를 지원하며 데이터 포인트에 데이터 라벨을 표시합니다

      설명

      그룹형 로즈 차트. 극좌표계에서 부채꼴 호와 반지름으로 데이터 크기를 표시하며 다차원 데이터 비교에 적합합니다

      적용 시나리오:

      - 다차원 데이터의 분포 비교

      - 주기성 데이터의 강약 비교

      - 범주형 데이터의 수치와 비율 동시 표시

      Warning

      데이터 요구 사항:

      - 최소 1개의 숫자 필드(지표)

      - 첫 번째 차원은 각도 축에 배치되고, 나머지 차원은 지표 이름(여러 지표가 있는 경우)과 병합되어 범례 항목으로 표시됩니다

      - 모든 지표는 자동으로 하나의 지표로 병합됩니다

      기본으로 활성화되는 기능:

      - 범례, 극좌표계, 데이터 라벨, 툴팁, 값 스케일링이 기본으로 활성화됩니다

      chartType

      Type: "roseParallel"

      설명

      그룹형 로즈 차트

      그룹형 로즈 차트. 극좌표계로 다차원 데이터 비교 관계를 표시합니다

      예시 'roseParallel'

      dataset

      Type: Record[]

      설명

      데이터셋

      TidyData 사양을 따르는 집계된 데이터셋으로, 차트의 데이터 소스와 구조를 정의하는 데 사용됩니다. 사용자가 입력한 데이터셋은 별도 처리할 필요가 없으며, VSeed의 강력한 데이터 리셰이프 기능이 데이터를 자동으로 리셰이프합니다. 로즈 차트 데이터는 최종적으로 2개의 차원과 1개의 지표로 변환됩니다.

      예시 [{month:'Jan', value:100}, {month:'Feb', value:150}, {month:'Mar', value:120}]

      dimensions

      Type: RadarDimension[] | undefined

      설명

      차원

      로즈 차트의 첫 번째 차원은 각도 축에 매핑되고, 나머지 차원은 지표 이름(여러 지표가 있는 경우)과 병합되어 범례 항목으로 표시됩니다.

      예시 [{id: 'category', alias: 'Category'}]

      id

      Type: string

      설명

      차원에 해당하는 field ID

      alias

      Type: string | undefined

      설명

      차원 별칭

      timeFormat

      Type: TimeFormat | undefined

      설명

      차원 날짜 형식 구성

      type

      Type: "year" | "quarter" | "month" | "week" | "day" | "hour" | "minute" | "second"

      설명

      시간 입도이며 날짜 표시 정밀도를 결정합니다

      encoding

      Type: "color" | "detail" | "tooltip" | "label" | "row" | "column" | "angle" | undefined

      설명

      차원이 매핑되는 채널

      - angle: 여러 차원을 각도 채널에 매핑할 수 있습니다

      - color: 여러 차원을 색상 채널에 매핑할 수 있습니다

      - detail: 여러 차원을 detail 채널에 매핑할 수 있습니다

      - tooltip: 여러 차원을 tooltip 채널에 매핑할 수 있습니다

      - label: 여러 차원을 label 채널에 매핑할 수 있습니다

      - row: 여러 차원을 행 채널에 매핑할 수 있습니다

      - column: 여러 차원을 열 채널에 매핑할 수 있습니다

      measures

      Type: RadarMeasure[] | undefined

      설명

      지표

      로즈 차트의 지표는 자동으로 하나의 지표로 병합되어 반지름 축에 매핑됩니다. 여러 지표가 있는 경우 지표 이름은 다른 차원과 병합되어 범례 항목으로 표시됩니다.

      예시 [{id: 'value', alias: 'Value'}]

      id

      Type: string

      설명

      지표 ID. 중복될 수 없습니다

      alias

      Type: string | undefined

      설명

      지표 별칭. 중복을 허용하며, 입력하지 않으면 alias는 id가 됩니다

      autoFormat

      Type: boolean | undefined

      설명

      자동 숫자 포맷. 기본으로 활성화되며 우선순위가 가장 높습니다

      autoFormat=true이면 모든 numFormat 설정을 덮어씁니다

      활성화되면 차트 레이블과 툴팁이 지표 값과 locale에 따라 적절한 포맷을 자동 선택합니다

      포맷 규칙: 10진수, compact notation 활성화, 소수점 최소 0자리 및 최대 2자리, 자동 반올림, 브라우저 Intl.NumberFormat 사용

      예:

      - locale=zh-CN: 749740.264 → 74.45万

      - locale=en-US: 749740.264 → 744.5K

      numFormat

      Type: NumFormat | undefined

      설명

      지표의 사용자 지정 숫자 포맷으로, label과 tooltip에 자동 적용됩니다

      주의: 사용자 지정 포맷을 사용하려면 autoFormat=false를 명시적으로 설정해야 합니다. 그렇지 않으면 autoFormat이 이 설정을 덮어씁니다

      type

      Type: "number" | "percent" | "permille" | "scientific" | undefined

      설명

      숫자 포맷 유형. 숫자(10진수), 백분율(%), 퍼밀(‰), 과학적 표기법을 지원합니다

      ratio

      Type: number | undefined

      설명

      숫자 포맷 비율. 0일 수 없습니다

      예시 - 100000는 10万, ratio:10000, symbol:"万" - 100000은 10K로 변환됩니다, ratio:1000, symbol:"K"

      symbol

      Type: string | undefined

      설명

      숫자 포맷 기호. 예: %, ‰

      예시 - 100000는 10万, ratio:10000, symbol:"万" - 100000은 10K로 변환됩니다, ratio:1000, symbol:"K"

      thousandSeparator

      Type: boolean | undefined

      설명

      숫자 포맷 천 단위 구분 기호

      suffix

      Type: string | undefined

      설명

      숫자 포맷 접미사

      prefix

      Type: string | undefined

      설명

      숫자 포맷 접두사

      fractionDigits

      Type: number | undefined

      설명

      숫자 포맷 소수 자릿수. 브라우저 Intl.NumberFormat의 minimumFractionDigits와 maximumFractionDigits를 사용합니다. significantDigits보다 우선순위가 낮습니다

      예시 - 1234.5678은 1235로 변환됩니다, fractionDigits:0 (roundingMode:halfCeil) - 1234.5678은 1234.6으로 변환됩니다, fractionDigits:1 (roundingMode:halfCeil) - 1234.5678은 1234.57로 변환됩니다, fractionDigits:2 (roundingMode:halfCeil) - 1234.5678은 1230.568로 변환됩니다, fractionDigits:3 (roundingMode:halfCeil) - 1234.5678은 1234.5678로 변환됩니다, fractionDigits:4 (roundingMode:halfCeil) - 1234.5678은 1234.56780으로 변환됩니다, fractionDigits:5 (roundingMode:halfCeil)

      significantDigits

      Type: number | undefined

      설명

      숫자 포맷 유효 자릿수. 브라우저 Intl.NumberFormat의 minimumSignificantDigits와 maximumSignificantDigits를 사용합니다. fractionDigits보다 우선순위가 높습니다

      예시 - 1234.5678은 1000으로 변환됩니다, significantDigits:1 - 1234.5678은 1200으로 변환됩니다, significantDigits:2 - 1234.5678은 1230으로 변환됩니다, significantDigits:3 - 1234.5678은 1234로 변환됩니다, significantDigits:4 - 1234.5678은 1234.6으로 변환됩니다, significantDigits:5 (roundingMode:halfCeil) - 1234.5678은 1234.57로 변환됩니다, significantDigits:6 (roundingMode:halfCeil) - 1234.5678은 1234.568로 변환됩니다, significantDigits:7 (roundingMode:halfCeil) - 1234.5678은 1234.5678로 변환됩니다, significantDigits:8 (roundingMode:halfCeil)

      roundingPriority

      Type: "morePrecision" | "lessPrecision" | undefined

      설명

      significantDigits와 fractionDigits가 동시에 설정된 경우의 숫자 포맷 반올림 우선순위입니다. 브라우저 Intl.NumberFormat을 사용하며 Intl.NumberFormat의 roundingPriority와 같은 규칙을 따릅니다

      예시 - 1234.5678은 1230으로 변환됩니다, significantDigits:3 (roundingPriority:lessPrecision) - 1234.5678은 1234.5678로 변환됩니다, significantDigits:3 (roundingPriority:morePrecision)

      roundingMode

      Type: "floor" | "ceil" | "expand" | "trunc" | "halfCeil" | "halfFloor" | "halfExpand" | "halfTrunc" | "halfEven" | undefined

      설명

      숫자 포맷 반올림 모드입니다. 브라우저 Intl.NumberFormat을 사용하며 Intl.NumberFormat의 roundingMode와 같은 규칙을 따릅니다

      format

      Type: NumFormat | undefined

      type

      Type: "number" | "percent" | "permille" | "scientific" | undefined

      설명

      숫자 포맷 유형. 숫자(10진수), 백분율(%), 퍼밀(‰), 과학적 표기법을 지원합니다

      ratio

      Type: number | undefined

      설명

      숫자 포맷 비율. 0일 수 없습니다

      예시 - 100000는 10万, ratio:10000, symbol:"万" - 100000은 10K로 변환됩니다, ratio:1000, symbol:"K"

      symbol

      Type: string | undefined

      설명

      숫자 포맷 기호. 예: %, ‰

      예시 - 100000는 10万, ratio:10000, symbol:"万" - 100000은 10K로 변환됩니다, ratio:1000, symbol:"K"

      thousandSeparator

      Type: boolean | undefined

      설명

      숫자 포맷 천 단위 구분 기호

      suffix

      Type: string | undefined

      설명

      숫자 포맷 접미사

      prefix

      Type: string | undefined

      설명

      숫자 포맷 접두사

      fractionDigits

      Type: number | undefined

      설명

      숫자 포맷 소수 자릿수. 브라우저 Intl.NumberFormat의 minimumFractionDigits와 maximumFractionDigits를 사용합니다. significantDigits보다 우선순위가 낮습니다

      예시 - 1234.5678은 1235로 변환됩니다, fractionDigits:0 (roundingMode:halfCeil) - 1234.5678은 1234.6으로 변환됩니다, fractionDigits:1 (roundingMode:halfCeil) - 1234.5678은 1234.57로 변환됩니다, fractionDigits:2 (roundingMode:halfCeil) - 1234.5678은 1230.568로 변환됩니다, fractionDigits:3 (roundingMode:halfCeil) - 1234.5678은 1234.5678로 변환됩니다, fractionDigits:4 (roundingMode:halfCeil) - 1234.5678은 1234.56780으로 변환됩니다, fractionDigits:5 (roundingMode:halfCeil)

      significantDigits

      Type: number | undefined

      설명

      숫자 포맷 유효 자릿수. 브라우저 Intl.NumberFormat의 minimumSignificantDigits와 maximumSignificantDigits를 사용합니다. fractionDigits보다 우선순위가 높습니다

      예시 - 1234.5678은 1000으로 변환됩니다, significantDigits:1 - 1234.5678은 1200으로 변환됩니다, significantDigits:2 - 1234.5678은 1230으로 변환됩니다, significantDigits:3 - 1234.5678은 1234로 변환됩니다, significantDigits:4 - 1234.5678은 1234.6으로 변환됩니다, significantDigits:5 (roundingMode:halfCeil) - 1234.5678은 1234.57로 변환됩니다, significantDigits:6 (roundingMode:halfCeil) - 1234.5678은 1234.568로 변환됩니다, significantDigits:7 (roundingMode:halfCeil) - 1234.5678은 1234.5678로 변환됩니다, significantDigits:8 (roundingMode:halfCeil)

      roundingPriority

      Type: "morePrecision" | "lessPrecision" | undefined

      설명

      significantDigits와 fractionDigits가 동시에 설정된 경우의 숫자 포맷 반올림 우선순위입니다. 브라우저 Intl.NumberFormat을 사용하며 Intl.NumberFormat의 roundingPriority와 같은 규칙을 따릅니다

      예시 - 1234.5678은 1230으로 변환됩니다, significantDigits:3 (roundingPriority:lessPrecision) - 1234.5678은 1234.5678로 변환됩니다, significantDigits:3 (roundingPriority:morePrecision)

      roundingMode

      Type: "floor" | "ceil" | "expand" | "trunc" | "halfCeil" | "halfFloor" | "halfExpand" | "halfTrunc" | "halfEven" | undefined

      설명

      숫자 포맷 반올림 모드입니다. 브라우저 Intl.NumberFormat을 사용하며 Intl.NumberFormat의 roundingMode와 같은 규칙을 따릅니다

      encoding

      Type: "color" | "tooltip" | "label" | "radius" | undefined

      설명

      지표가 매핑되는 채널

      - radius: 반지름 채널에 매핑되는 지표

      - color: 색상 채널에 매핑되는 지표

      - label: label 채널에 매핑되는 지표

      - tooltip: tooltip 채널에 매핑되는 지표

      parentId

      Type: string | undefined

      설명

      평면 지표 설정 형태에서 트리 형태의 지표 그룹을 구성합니다. parentId는 부모 지표 그룹의 id를 가리키며 지표 트리를 구성하는 데 사용됩니다

      Tip

      지표 트리를 설정하는 방법은 두 가지입니다. 옵션 1은 children이 있는 지표 트리를 직접 설정하는 방식이고, 옵션 2는 parentId가 있는 평면 지표 목록을 설정하는 방식입니다. 두 방식은 동시에 사용할 수 없습니다

      page

      Type: Page | undefined

      설명

      페이지네이션 설정입니다. 페이지네이션에 사용할 필드명을 지정하며 반드시 차원이어야 합니다

      field

      Type: string

      설명

      페이지네이션 필드입니다. 페이지네이션에 사용할 필드명을 지정하며, 반드시 차원이어야 합니다

      currentValue

      Type: string

      설명

      현재 페이지네이션 값입니다. 현재 페이지를 판별하는 기준 값을 지정합니다

      예시 '2023-01-01'

      backgroundColor

      Type: BackgroundColor

      설명

      차트 배경색

      배경색은 색상 문자열(예: 'red', 'blue') 또는 hex, rgb, rgba 값(예: '#ff0000', 'rgba(255,0,0,0.5)')일 수 있습니다

      color

      Type: Color | undefined

      설명

      색상 구성으로, 색상 목록, 색상 매핑, 색상 그라데이션 등 차트의 색상 체계를 정의하는 데 사용됩니다.

      colorScheme

      Type: string[] | undefined

      설명

      이산 색상 팔레트. 차트의 여러 요소 색상을 정의하는 데 사용합니다

      예시 ['#FFCDD2,#F8BBD0,#E1BEE7,#D1C4E9,#C5CAE9,#BBDEFB,#B3E5FC,#B2EBF2,#B2DFDB,#C8E6C9,#DCEDC8,#F0F4C3,#FFF9C4,#FFECB3,#FFE0B2']

      linearColorScheme

      Type: string[] | undefined

      설명

      선형 그라데이션 색상 팔레트. 차트의 여러 요소 색상을 정의하는 데 사용합니다

      예시 ['#FFCDD2, #F8BBD0]

      colorMapping

      Type: Record<string, string> | undefined

      설명

      색상 매핑. 데이터 값을 구체적인 색상에 매핑하는 데 사용합니다

      예시 { 'profit': 'red', 'sales': 'blue', }

      positiveColor

      Type: string | undefined

      설명

      양수/음수 색상 설정으로, 차트에서 양수 값의 색상을 정의합니다

      negativeColor

      Type: string | undefined

      설명

      양수/음수 색상 설정으로, 차트에서 음수 값의 색상을 정의합니다

      label

      Type: PieLabel | undefined

      설명

      레이블

      그래프 데이터 레이블 설정으로, 데이터 레이블의 위치, 형식, 스타일 등을 정의합니다.

      enable

      Type: false | true

      설명

      레이블 기능을 활성화할지 여부

      wrap

      Type: boolean | undefined

      설명

      레이블을 줄바꿈할지 여부

      showValue

      Type: boolean | undefined

      설명

      레이블에 지표 값을 표시할지 여부

      여러 지표가 있는 시나리오에서도 값 충돌을 걱정할 필요가 없습니다. 모든 그리기 관련 지표는 foldMeasures 처리를 거쳐 하나의 데이터 포인트를 나타내는 하나의 지표로 병합되기 때문입니다.

      주의: encoding.label의 우선순위가 더 높으며, 이 설정은 encoding.label에 영향을 주지 않습니다

      showValuePercent

      Type: boolean | undefined

      설명

      레이블에 지표 값의 백분율을 표시할지 여부

      여러 지표가 있는 시나리오에서도 값 충돌을 걱정할 필요가 없습니다. 모든 그리기 관련 지표는 foldMeasures 처리를 거쳐 하나의 데이터 포인트를 나타내는 하나의 지표로 병합되기 때문입니다.

      주의: encoding.label의 우선순위가 더 높으며, 이 설정은 encoding.label에 영향을 주지 않습니다

      showDimension

      Type: boolean | undefined

      설명

      레이블에 차원 레이블을 표시할지 여부

      모든 차원 레이블을 표시합니다

      주의: encoding.label의 우선순위가 더 높으며, 이 설정은 encoding.label에 영향을 주지 않습니다

      autoFormat

      Type: boolean | undefined

      설명

      레이블 값을 자동으로 포맷할지 여부. autoFormat이 true이면 numFormat 설정은 무시됩니다

      numFormat

      Type: NumFormat | undefined

      설명

      레이블 값 포맷 설정입니다. measure의 format과 병합되며, measure의 format 우선순위가 더 높습니다. numFormat의 우선순위는 autoFormat보다 낮습니다

      type

      Type: "number" | "percent" | "permille" | "scientific" | undefined

      설명

      숫자 포맷 유형. 숫자(10진수), 백분율(%), 퍼밀(‰), 과학적 표기법을 지원합니다

      ratio

      Type: number | undefined

      설명

      숫자 포맷 비율. 0일 수 없습니다

      예시 - 100000는 10万, ratio:10000, symbol:"万" - 100000은 10K로 변환됩니다, ratio:1000, symbol:"K"

      symbol

      Type: string | undefined

      설명

      숫자 포맷 기호. 예: %, ‰

      예시 - 100000는 10万, ratio:10000, symbol:"万" - 100000은 10K로 변환됩니다, ratio:1000, symbol:"K"

      thousandSeparator

      Type: boolean | undefined

      설명

      숫자 포맷 천 단위 구분 기호

      suffix

      Type: string | undefined

      설명

      숫자 포맷 접미사

      prefix

      Type: string | undefined

      설명

      숫자 포맷 접두사

      fractionDigits

      Type: number | undefined

      설명

      숫자 포맷 소수 자릿수. 브라우저 Intl.NumberFormat의 minimumFractionDigits와 maximumFractionDigits를 사용합니다. significantDigits보다 우선순위가 낮습니다

      예시 - 1234.5678은 1235로 변환됩니다, fractionDigits:0 (roundingMode:halfCeil) - 1234.5678은 1234.6으로 변환됩니다, fractionDigits:1 (roundingMode:halfCeil) - 1234.5678은 1234.57로 변환됩니다, fractionDigits:2 (roundingMode:halfCeil) - 1234.5678은 1230.568로 변환됩니다, fractionDigits:3 (roundingMode:halfCeil) - 1234.5678은 1234.5678로 변환됩니다, fractionDigits:4 (roundingMode:halfCeil) - 1234.5678은 1234.56780으로 변환됩니다, fractionDigits:5 (roundingMode:halfCeil)

      significantDigits

      Type: number | undefined

      설명

      숫자 포맷 유효 자릿수. 브라우저 Intl.NumberFormat의 minimumSignificantDigits와 maximumSignificantDigits를 사용합니다. fractionDigits보다 우선순위가 높습니다

      예시 - 1234.5678은 1000으로 변환됩니다, significantDigits:1 - 1234.5678은 1200으로 변환됩니다, significantDigits:2 - 1234.5678은 1230으로 변환됩니다, significantDigits:3 - 1234.5678은 1234로 변환됩니다, significantDigits:4 - 1234.5678은 1234.6으로 변환됩니다, significantDigits:5 (roundingMode:halfCeil) - 1234.5678은 1234.57로 변환됩니다, significantDigits:6 (roundingMode:halfCeil) - 1234.5678은 1234.568로 변환됩니다, significantDigits:7 (roundingMode:halfCeil) - 1234.5678은 1234.5678로 변환됩니다, significantDigits:8 (roundingMode:halfCeil)

      roundingPriority

      Type: "morePrecision" | "lessPrecision" | undefined

      설명

      significantDigits와 fractionDigits가 동시에 설정된 경우의 숫자 포맷 반올림 우선순위입니다. 브라우저 Intl.NumberFormat을 사용하며 Intl.NumberFormat의 roundingPriority와 같은 규칙을 따릅니다

      예시 - 1234.5678은 1230으로 변환됩니다, significantDigits:3 (roundingPriority:lessPrecision) - 1234.5678은 1234.5678로 변환됩니다, significantDigits:3 (roundingPriority:morePrecision)

      roundingMode

      Type: "floor" | "ceil" | "expand" | "trunc" | "halfCeil" | "halfFloor" | "halfExpand" | "halfTrunc" | "halfEven" | undefined

      설명

      숫자 포맷 반올림 모드입니다. 브라우저 Intl.NumberFormat을 사용하며 Intl.NumberFormat의 roundingMode와 같은 규칙을 따릅니다

      labelFontSize

      Type: number | undefined

      설명

      레이블 글꼴 크기

      labelFontWeight

      Type: string | number | undefined

      설명

      레이블 글꼴 두께

      labelBackgroundColor

      Type: string | undefined

      설명

      레이블 배경색

      labelStroke

      Type: string | undefined

      설명

      레이블 스트로크 색상

      labelColor

      Type: string | undefined

      설명

      레이블 글꼴 색상

      labelColorSmartInvert

      Type: boolean | undefined

      설명

      마크 색상에 따라 레이블 글꼴 색상을 자동 반전할지 여부

      labelPosition

      Type: "inside" | "outside" | undefined

      설명

      레이블 위치

      labelOverlap

      Type: boolean | undefined

      설명

      레이블 겹침 방지를 활성화할지 여부

      selector

      Type: Selector | Selectors | undefined

      설명

      레이블 필터입니다. 기본적으로 selectors 사이의 조건 관계는 OR입니다

      field

      Type: string

      설명

      차원 필드, dimensions 항목 중 하나의 id

      operator

      Type: "in" | "not in" | undefined

      설명

      연산자

      - in: 차원 필드 값이 value 안에 있는 데이터 항목을 선택합니다

      - not in: 차원 필드 값이 value 안에 없는 데이터 항목을 선택합니다

      op

      Type: "in" | "not in" | undefined

      설명

      연산자

      - in: 차원 필드 값이 value 안에 있는 데이터 항목을 선택합니다

      - not in: 차원 필드 값이 value 안에 없는 데이터 항목을 선택합니다

      operator와 동일합니다

      value

      Type: string | number | (string | number)[]

      설명

      데이터 항목에서 차원 필드의 값을 선택합니다. 배열을 지원합니다

      dynamicFilter

      Type: ChartDynamicFilter | undefined

      설명

      동적 필터(AI 생성 코드 실행)

      AI가 생성한 JavaScript 코드로 복잡한 데이터 필터링 로직을 구현합니다

      핵심 기능:

      - 임의로 복잡한 데이터 필터 조건 지원

      - 내장 유틸리티 함수로 데이터 작업 수행

      - 브라우저 환경에서 안전하게 실행(Web Worker 샌드박스)

      환경 요구 사항: 브라우저 환경에서만 지원되며 Node.js 환경에서는 fallback을 사용합니다

      주의: selector와 dynamicFilter는 동시에 사용할 수 없습니다. dynamicFilter의 우선순위가 더 높습니다

      차트 동적 필터 설정

      AI가 생성한 JavaScript 코드로 차트 마크(막대, 점 등)를 필터링합니다

      type

      Type: "row-with-field"

      description

      Type: string | undefined

      설명

      사용자의 필터 요구 사항 설명(자연어)

      예시 - 데이터 작업용 내장 유틸리티 함수 사용

      code

      Type: string

      설명

      AI가 생성한 JavaScript 필터 코드

      - 내장 유틸리티 함수만 사용할 수 있습니다(_ 또는 R을 통해 접근)

      - 입력 매개변수: data(배열), 각 item은 행 번호를 나타내는 __row_index 필드를 포함합니다

      - 행 인덱스와 필드 조합 배열을 반환해야 합니다: Array<{ __row_index: number, field: string }>

      - __row_index는 원본 데이터 항목의 행 번호이고, field는 하이라이트할 필드를 의미합니다

      - 금지: eval, Function, 비동기 작업, DOM API, 네트워크 요청

      예시 사용자의 필터링 요구 설명(자연어)

      const filtered = _.filter(data, item => item.sales > 1000);
return _.map(filtered, item => ({
__row_index: item.__row_index,
field: 'sales'
}));

      return _.flatten(

      const grouped = _.groupBy(data, 'area');
const maxItems = _.map(grouped, group =>
_.maxBy(group, item => item.profit / item.sales)
);
return _.flatten(
_.map(maxItems, item => [
{ __row_index: item.__row_index, field: 'product' },
{ __row_index: item.__row_index, field: 'profit' }
])
);

      return _.flatten(

      const filtered = _.filter(data, item => {
const profitRate = item.profit / item.sales;
return profitRate > 0.2 && item.sales > 5000;
});
return _.flatten(
_.map(filtered, item => [
{ __row_index: item.__row_index, field: 'product' },
{ __row_index: item.__row_index, field: 'sales' }
])
);

      fallback

      Type: Selector | Selectors | undefined

      설명

      코드 실행 실패 또는 지원되지 않는 환경에서의 fallback 방안

      field

      Type: string

      설명

      차원 필드, dimensions 항목 중 하나의 id

      operator

      Type: "in" | "not in" | undefined

      설명

      연산자

      - in: 차원 필드 값이 value 안에 있는 데이터 항목을 선택합니다

      - not in: 차원 필드 값이 value 안에 없는 데이터 항목을 선택합니다

      op

      Type: "in" | "not in" | undefined

      설명

      연산자

      - in: 차원 필드 값이 value 안에 있는 데이터 항목을 선택합니다

      - not in: 차원 필드 값이 value 안에 없는 데이터 항목을 선택합니다

      operator와 동일합니다

      value

      Type: string | number | (string | number)[]

      설명

      데이터 항목에서 차원 필드의 값을 선택합니다. 배열을 지원합니다

      result

      Type: DynamicFilterExecutionResult<RowWithFieldRes> | undefined

      설명

      동적 필터 실행 결과(런타임 필드)

      prepare() 단계에서 쓰이며 런타임에는 읽기 전용입니다

      success

      Type: false | true

      data

      Type: T[] | undefined

      error

      Type: string | undefined

      labelLayout

      Type: "arc" | "labelLine" | "edge" | undefined

      설명

      레이블 레이아웃 방식입니다. 파이 차트와 도넛 차트에서 labelPosition이 outside일 때만 적용됩니다

      - arc: 호 형태에 따라 레이블을 배치합니다

      - labelLine: 레이블 양끝을 정렬하고 가이드 라인으로 부채꼴 마크와 레이블을 연결합니다

      - edge: 레이블 양끝을 정렬하고 가이드 라인으로 부채꼴 마크와 레이블을 연결하며, 차트 양쪽 가장자리에 가깝게 배치합니다

      legend

      Type: Legend | undefined

      설명

      범례

      차트 범례 설정으로, 범례의 위치, 형식, 스타일 등을 정의합니다.

      enable

      Type: boolean | undefined

      설명

      범례 기능을 활성화할지 여부

      예시 sales가 1000보다 큰 데이터 항목의 sales 필드를 강조합니다

      border

      Type: boolean | undefined

      설명

      범례 테두리를 활성화할지 여부

      Warning

      이산 범례에만 적용됩니다

      예시 각 영역에서 이익률이 가장 높은 데이터 항목을 강조합니다

      labelColor

      Type: string | undefined

      설명

      범례 글꼴 색상

      pagerIconColor

      Type: string | undefined

      설명

      페이저 아이콘 색상

      pagerIconDisableColor

      Type: string | undefined

      설명

      비활성 페이저 아이콘 색상

      labelFontSize

      Type: number | undefined

      설명

      범례 글꼴 크기

      예시 연산자

      labelFontColor

      Type: string | undefined

      설명

      범례 글꼴 색상

      labelFontWeight

      Type: string | number | undefined

      설명

      범례 글꼴 두께

      예시 - not in: 차원 필드 값이 value에 포함되지 않는 데이터 항목을 선택합니다

      shapeType

      Type: "circle" | "cross" | "diamond" | "square" | "arrow" | "arrow2Left" | "arrow2Right" | "wedge" | "thinTriangle" | "triangle" | "triangleUp" | "triangleDown" | "triangleRight" | "triangleLeft" | "stroke" | "star" | "wye" | "rect" | "arrowLeft" | "arrowRight" | "rectRound" | "roundLine" | undefined

      설명

      범례 모양

      Warning

      이산 범례에만 적용됩니다

      예시 연산자

      position

      Type: "left" | "leftTop" | "leftBottom" | "lt" | "lb" | "top" | "topLeft" | "topRight" | "tl" | "tr" | "right" | "rightTop" | "rightBottom" | "rt" | "rb" | "bottom" | "bottomLeft" | "bottomRight" | "bl" | "br" | undefined

      설명

      범례 위치

      예시 - in: 차원 필드 값이 value에 포함되는 데이터 항목을 선택합니다

      maxSize

      Type: number | undefined

      설명

      범례 항목이 많을 때 최대 열 수 또는 최대 행 수

      position이 가로 방향(bottom, bottomLeft, bottomRight, bl, br, top, topLeft, topRight, tl, tr)이면 maxSize는 표시 열 수를 제어합니다

      position이 세로 방향(left, leftTop, leftBottom, lt, lb, right, rightTop, rightBottom, rt, rb)이면 maxSize는 표시 행 수를 제어합니다

      Warning

      이산 범례에만 적용됩니다

      예시 maxSize: 2

      tooltip

      Type: Tooltip | undefined

      설명

      툴팁

      차트 툴팁 설정으로, 툴팁의 위치, 형식, 스타일 등을 정의합니다.

      enable

      Type: false | true

      설명

      툴팁 정보를 활성화할지 여부

      brush

      Type: Brush | undefined

      설명

      브러시 선택

      brush 선택 기능을 켜거나 끄는 설정입니다.

      차트 브러시 선택 설정

      enable

      Type: boolean | undefined

      설명

      brush 선택을 활성화할지 여부

      brushType

      Type: "rect" | "x" | "y" | "polygon" | undefined

      설명

      brush 유형

      선택 영역의 모양과 선택 방향을 정의합니다.

      - rect: 사각형 선택. X축과 Y축 두 방향에서 동시에 선택할 수 있습니다

      - polygon: 다각형 선택. 여러 점을 클릭해 임의의 다각형을 그려 선택합니다

      - x: X축 방향 선택. X축 방향으로만 선택하며 Y축 방향은 제한하지 않습니다

      - y: Y축 방향 선택. Y축 방향으로만 선택하며 X축 방향은 제한하지 않습니다

      brushMode

      Type: "single" | "multiple" | undefined

      설명

      브러시 모드, 단일 선택 또는 다중 선택

      브러시 선택 모드를 정의합니다.

      - single: 단일 선택 모드. 한 번에 하나의 선택 영역만 존재할 수 있습니다

      - multiple: 다중 선택 모드. 여러 선택 영역이 동시에 존재할 수 있습니다

      removeOnClick

      Type: boolean | undefined

      설명

      브러시 선택 종료 후 선택 영역을 지울지 여부

      inBrushStyle

      Type: { opacity?: number; stroke?: string; lineWidth?: number; } | undefined

      설명

      브러시 영역 안 데이터의 스타일

      선택된 데이터 포인트의 스타일을 정의합니다

      opacity

      Type: number | undefined

      설명

      불투명도

      선택된 데이터 포인트의 불투명도이며 값 범위는 0-1입니다

      stroke

      Type: string | undefined

      설명

      스트로크 색상

      lineWidth

      Type: number | undefined

      설명

      스트로크 너비

      outOfBrushStyle

      Type: { opacity?: number; stroke?: string; lineWidth?: number; } | undefined

      설명

      브러시 영역 밖 데이터의 스타일

      선택되지 않은 데이터 포인트의 스타일을 정의합니다

      opacity

      Type: number | undefined

      설명

      불투명도

      선택되지 않은 데이터 포인트의 불투명도이며 값 범위는 0-1입니다

      stroke

      Type: string | undefined

      설명

      스트로크 색상

      lineWidth

      Type: number | undefined

      설명

      스트로크 너비

      animation

      Type: PieLikeAnimation | undefined

      설명

      애니메이션 설정

      차트 애니메이션 설정이며, 선택 가능한 효과는 차트 유형에 따라 제한됩니다

      enable

      Type: boolean | undefined

      설명

      파이/도넛/로즈 차트 애니메이션을 활성화할지 여부

      params

      Type: PieLikeAnimationParams | undefined

      설명

      파이/도넛/로즈 차트 애니메이션 매개변수

      appear

      Type: PieLikeAppearAnimation | undefined

      설명

      파이/도넛/로즈 차트 등장 애니메이션 설정

      effects

      Type: ("radial" | "scale")[] | undefined

      설명

      파이/도넛/로즈 차트 등장 효과로, 방사형 및 확대/축소 애니메이션을 지원합니다

      enable

      Type: boolean | undefined

      설명

      현재 애니메이션 단계를 활성화할지 여부

      ease

      Type: string | undefined

      설명

      애니메이션 easing 함수

      duration

      Type: number | undefined

      설명

      애니메이션 지속 시간, 단위는 밀리초

      color

      Type: string | undefined

      설명

      애니메이션 하이라이트 또는 분위기 색상

      update

      Type: PieLikeUpdateAnimation | undefined

      설명

      파이/도넛/로즈 차트 업데이트 애니메이션 설정

      effects

      Type: "radial"[] | undefined

      설명

      파이/도넛/로즈 차트 업데이트 효과로, 방사형 애니메이션을 지원합니다

      enable

      Type: boolean | undefined

      설명

      현재 애니메이션 단계를 활성화할지 여부

      ease

      Type: string | undefined

      설명

      애니메이션 easing 함수

      duration

      Type: number | undefined

      설명

      애니메이션 지속 시간, 단위는 밀리초

      color

      Type: string | undefined

      설명

      애니메이션 하이라이트 또는 분위기 색상

      loop

      Type: PieLikeAnimationLoop | undefined

      설명

      파이/도넛/로즈 차트 반복 애니메이션 설정

      enable

      Type: boolean | undefined

      설명

      루프 애니메이션을 활성화할지 여부

      interval

      Type: number | undefined

      설명

      루프 애니메이션 간격, 단위는 밀리초

      loop

      Type: PieLikeLoopAnimation | undefined

      설명

      파이/도넛/로즈 차트 반복 애니메이션 설정

      effects

      Type: PieLikeLoopEffect[] | undefined

      설명

      파이/도넛/로즈 차트 반복 효과

      enable

      Type: boolean | undefined

      설명

      현재 애니메이션 단계를 활성화할지 여부

      ease

      Type: string | undefined

      설명

      애니메이션 easing 함수

      duration

      Type: number | undefined

      설명

      애니메이션 지속 시간, 단위는 밀리초

      color

      Type: string | undefined

      설명

      애니메이션 하이라이트 또는 분위기 색상

      atmosphere

      Type: NoEffectAtmosphereConfig | undefined

      설명

      파이/도넛/로즈 차트 분위기 애니메이션 설정

      ease

      Type: string | undefined

      설명

      분위기 애니메이션 easing 함수

      color

      Type: string | undefined

      설명

      분위기 애니메이션 색상

      theme

      Type: Theme | undefined

      설명

      그래프 테마입니다. 테마는 우선순위가 낮은 기능 설정으로, 모든 그래프 유형이 공유하는 공통 설정과 단일 그래프 유형의 설정을 포함합니다.

      light와 dark 두 가지 내장 테마를 제공하며, 사용자는 Builder를 통해 테마를 사용자 지정할 수 있습니다.

      테마

      light와 dark 두 가지 내장 테마를 제공하며, 새 테마는 registerTheme으로 사용자 지정할 수 있습니다.

      예시 브러시 선택이 끝난 후 선택 영역을 지울지 여부

      선택되지 않은 데이터 포인트의 불투명도, 범위 0-1

      브러시 선택된 데이터 포인트의 스타일을 정의합니다

      length

      Type: number

      brand

      Type: brand

      locale

      Type: "zh-CN" | "en-US" | "ja-JP" | "de-DE" | "id-ID" | "fr-FR" | "ko-KR" | "vi-VN" | undefined

      설명

      언어

      차트 언어 설정입니다. 'zh-CN'과 'en-US'를 지원하며 intl.setLocale('zh-CN') 메서드로 언어를 설정할 수도 있습니다