Skip to content

Kandy를 활용한 데이터 시각화 ​

Kotlin은 강력하고 유연한 데이터 시각화를 위한 올인원 솔루션을 제공하여, 복잡한 모델을 다루기 전에 데이터를 직관적으로 표현하고 탐색할 수 있도록 돕습니다.

이 튜토리얼에서는 Kandy 및 Kotlin DataFrame 라이브러리를 사용하여 IntelliJ IDEA에서 다양한 유형의 차트를 생성하는 방법을 살펴봅니다.

시작하기 전에 ​

IntelliJ IDEA 2026.2부터는 Kotlin Notebook이 IDE에 기본 번들로 제공되지 않으며 JetBrains에서 공식 지원하지 않습니다. 소스 코드는 GitHub에서 계속 확인할 수 있습니다.

자세한 내용은 블로그 게시글을 참고하세요.

이 튜토리얼을 진행하려면 다음 단계를 따르세요:

  1. File | New | Kotlin Notebook을 선택합니다.

  2. 노트북에서 Kandy와 Kotlin DataFrame을 가져옵니다.

    kotlin
    %use kandy
    %use dataframe

    노트북에서 DataFrame 라이브러리와 관련 API를 사용할 수 있도록 다른 코드 셀보다 먼저 %use dataframe 라인이 포함된 코드 셀을 실행하세요.

이 튜토리얼은 DataFrame을 Gradle 또는 Maven 종속성으로 추가하여 진행할 수도 있습니다.

DataFrame 생성하기 ​

먼저 시각화할 데이터가 포함된 DataFrame을 생성해 보겠습니다. 이 DataFrame에는 베를린, 마드리드, 카라카스의 시뮬레이션된 월별 평균 기온이 저장됩니다:

kotlin
// months 변수는 1년 12개월의 목록을 저장합니다.
val months = listOf(
    "January", "February",
    "March", "April", "May",
    "June", "July", "August",
    "September", "October", "November",
    "December"
)
// tempBerlin, tempMadrid, tempCaracas 변수는 
// 각 월의 기온 값 목록을 저장합니다.
val tempBerlin =
    listOf(-0.5, 0.0, 4.8, 9.0, 14.3, 17.5, 19.2, 18.9, 14.5, 9.7, 4.7, 1.0)
val tempMadrid =
    listOf(6.3, 7.9, 11.2, 12.9, 16.7, 21.1, 24.7, 24.2, 20.3, 15.4, 9.9, 6.6)
val tempCaracas =
    listOf(27.5, 28.9, 29.6, 30.9, 31.7, 35.1, 33.8, 32.2, 31.3, 29.4, 28.9, 27.6)

이제 새 변수(df)를 만들고 dataFrameOf() 함수를 사용하여 세 개의 열(Month, Temperature, City)로 구성된 DataFrame을 생성합니다:

kotlin
val df = dataFrameOf(
    "Month" to months + months + months,
    "Temperature" to tempBerlin + tempMadrid + tempCaracas,
    "City" to List(12) { "Berlin" } + List(12) { "Madrid" } + List(12) { "Caracas" }
)

데이터를 미리 보려면 .head() 함수를 사용하세요:

kotlin
df.head(4) // 처음 네 개 행을 반환합니다.

이 데이터셋에서 처음 네 개 행에는 1월부터 4월까지의 베를린 기온이 저장되어 있습니다:

Dataframe exploration

Kandy와 Kotlin DataFrame 라이브러리를 함께 사용할 때 타입 안전성(type safety)을 높이는 데 도움이 되는 열(column) 레코드 접근 방식이 여러 가지 제공됩니다. 자세한 내용은 Access APIs를 참고하세요.

꺾은선형 차트(Line chart) 생성하기 ​

이전 섹션의 df DataFrame을 사용하여 꺾은선형 차트를 생성해 보겠습니다:

  1. Kandy 라이브러리의 .plot() 함수를 호출합니다.
  2. line() 레이어를 적용합니다.
  3. Month와 Temperature 열을 각각 X축과 Y축에 매핑합니다.
  4. (선택 사항) 색상과 크기를 사용자 지정합니다.
kotlin
df.plot {
   line {
      x(Month)
      y(Temperature)

      color(City) {
         scale = categorical(
            "Berlin" to Color.hex("#6F4E37"),
            "Madrid" to Color.hex("#C2D4AB"),
            "Caracas" to Color.hex("#B5651D")
         )
      }
      width = 1.5
   }
   layout {
      size = 1000 to 450
   }
}

결과는 다음과 같습니다:

Line chart

점형 차트(Points chart) 생성하기 ​

이제 df DataFrame을 점형(산점도, scatter) 차트로 시각화해 보겠습니다:

  1. Kandy 라이브러리의 .plot() 함수를 호출합니다.
  2. points() 레이어를 적용합니다.
  3. Month와 Temperature 열을 각각 X축과 Y축에 매핑합니다.
  4. (선택 사항) 색상, 축 레이블, 점 크기, 차트 제목을 사용자 지정합니다.
kotlin
df.plot {
   points {
      x(Month) {
         axis.name = "Month"
      }
      y(Temperature) {
         axis.name = "Temperature"
      }

      color(City) {
         scale = categorical(
            "Berlin" to Color.hex("#6F4E37"),
            "Madrid" to Color.hex("#C2D4AB"),
            "Caracas" to Color.hex("#B5651D")
         )
      }
      size = 5.5
   }
   layout {
      title = "Temperature per month"
   }
}

결과는 다음과 같습니다:

Points chart

막대형 차트(Bar chart) 생성하기 ​

마지막으로 각 도시별 막대형 차트를 만들어 보겠습니다:

  1. .groupBy() 함수를 사용하여 City 열을 기준으로 DataFrame을 그룹화합니다.
  2. Kandy 라이브러리의 plot() 함수를 호출합니다.
  3. bars() 레이어를 적용합니다.
  4. (선택 사항) 차트 제목을 추가하고 색상을 사용자 지정합니다.
kotlin
df.groupBy { City }.plot {
    bars {
        x(Month)
        y(Temperature)
        
        fillColor(City) {
            scale = categorical(
                "Berlin" to Color.hex("#6F4E37"),
                "Madrid" to Color.hex("#C2D4AB"),
                "Caracas" to Color.hex("#B5651D")
            )
        }
    }
    layout.title {
       title = "Temperature per month"
    }
}

결과는 다음과 같습니다:

Bar chart

다음 단계 ​