Skip to content

Kotlin Notebook에 종속성 추가하기

이것은 Kotlin Notebook 시작하기 튜토리얼의 세 번째 파트입니다. 계속 진행하기 전에 이전 단계를 완료했는지 확인하세요.

First step 환경 설정
Second step Kotlin Notebook 만들기
Third step Kotlin Notebook에 종속성 추가하기

첫 번째 Kotlin Notebook을 이미 만드셨군요! 이제 고급 기능을 활용하는 데 필요한 라이브러리 종속성(dependency)을 추가하는 방법을 배워보겠습니다.

Kotlin 표준 라이브러리는 별도의 설정 없이 즉시 사용할 수 있으므로 따로 임포트할 필요가 없습니다.

임의의 코드 셀에 Gradle 방식의 구문을 사용하여 Maven 저장소의 라이브러리를 로드할 수 있습니다. 하지만 Kotlin Notebook은 %use을 통해 인기 라이브러리를 로드하는 더 간편한 방법을 제공합니다:

kotlin
// 추가하려는 라이브러리 종속성으로 libraryName을 대체하세요
%use libraryName
// 필요한 경우 버전을 지정하세요
%use libraryName(version)
// 자동 완성을 활성화하려면 v=를 추가하세요
%use libraryName(v=version)
// 예시: kotlinx.datetime:0.7.1
%use datetime(v=0.7.1)

Kotlin Notebook의 자동 완성 기능을 사용하면 사용 가능한 라이브러리에 빠르게 접근할 수 있습니다:

Kotlin Notebook의 자동 완성 기능

Kotlin Notebook에는 딥러닝부터 HTTP 네트워킹에 이르기까지 다양한 작업을 수행하기 위한 통합 라이브러리 세트가 포함되어 있습니다. 지원되는 라이브러리 가져오기를 참조하세요.

또한 아직 Kotlin Notebook에 통합되지 않은 라이브러리를 추가하여 사용할 수도 있습니다. 새 라이브러리 통합을 참조하세요.

Kotlin Notebook에 Kotlin DataFrame 및 Kandy 라이브러리 추가하기

Kotlin Notebook에 두 개의 인기 있는 Kotlin 라이브러리 종속성을 추가해 보겠습니다:

이 라이브러리들을 추가하려면:

  1. Add Code Cell을 클릭하여 새 코드 셀을 만듭니다.

  2. 코드 셀에 다음 코드를 입력합니다:

    kotlin
    // 사용 가능한 최신 라이브러리 버전이 사용되도록 보장합니다
    %useLatestDescriptors
    
    // Kotlin DataFrame 라이브러리를 가져옵니다
    %use dataframe
    
    // Kotlin Kandy 라이브러리를 가져옵니다
    %use kandy
  3. 코드 셀을 실행합니다.

    %use 문이 실행되면 라이브러리 종속성을 다운로드하고 노트북에 기본 임포트(import)를 추가합니다.

    라이브러리에 의존하는 다른 코드 셀을 실행하기 전에 %use libraryName 줄이 포함된 코드 셀을 먼저 실행해야 합니다.

  4. Kotlin DataFrame 라이브러리를 사용하여 CSV 파일에서 데이터를 가져오려면 새 코드 셀에서 .read() 함수를 사용합니다:

    kotlin
    // "netflix_titles.csv" 파일에서 데이터를 가져와 DataFrame을 생성합니다.
    val rawDf = DataFrame.read("netflix_titles.csv")
    
    // 원시 DataFrame 데이터를 표시합니다
    rawDf

    이 예제 CSV는 Kotlin DataFrame 예제 GitHub 저장소에서 다운로드할 수 있습니다. 프로젝트 디렉터리에 추가하세요.

    DataFrame을 사용하여 데이터 표시하기

  5. 새 코드 셀에서 .plot 메서드를 사용하여 DataFrame에 있는 TV 프로그램(TV Shows)과 영화(Movies)의 분포를 시각적으로 표현해 보겠습니다:

    kotlin
    rawDf
        // "type" 열의 각 고유 값의 발생 횟수를 계산합니다
        .valueCounts(sort = false) { type }
        // 색상을 지정하여 데이터를 막대 차트로 시각화합니다
        .plot {
            bars {
                x(type)
                y("count")
                fillColor(type) {
                    scale = categorical(range = listOf(Color.hex("#00BCD4"), Color.hex("#009688")))
                }
            }
    
            // 차트의 레이아웃을 구성하고 제목을 설정합니다
            layout {
                title = "Count of TV Shows and Movies"
                size = 900 to 550
            }
        }

결과 차트:

Kandy 라이브러리를 사용한 시각화

Kotlin Notebook에서 이러한 라이브러리들을 성공적으로 추가하고 활용하신 것을 축하합니다! 이것은 Kotlin Notebook과 지원되는 라이브러리로 달성할 수 있는 것들의 일부에 불과합니다.

다음 단계