라인 플롯 개요

메트릭을 시각화하고 축을 사용자 지정하며 하나의 플롯에서 여러 선을 비교합니다

라인 플롯은 wandb.Run.log()으로 기록한 메트릭이 시간에 따라 기본적으로 표시됩니다. 라인 플롯은 여러 메트릭을 동시에 플로팅하고, 사용자 정의 축을 계산하는 등 다양한 기능을 지원합니다.

이 페이지에서는 Workspace에서 라인 플롯을 생성, 구성 및 관리하는 방법을 설명합니다.

CoreWeave 인프라에서 실행되는 runs의 경우, CoreWeave Mission Control이 컴퓨트 인프라를 모니터링합니다. 오류가 발생하면 W&B가 프로젝트의 Workspace에 있는 run의 플롯에 인프라 정보를 표시합니다. 자세한 내용은 CoreWeave 인프라 경고 시각화를 참조하세요.

​

선 그래프 추가

이 섹션에서는 단일 메트릭 또는 여러 메트릭에 대한 선 그래프를 생성하는 방법을 설명합니다.

단일 메트릭 라인 플롯

automatic workspace에서는 기록된 각 메트릭마다 단일 메트릭 라인 플롯이 자동으로 생성됩니다. automatic workspace에서 삭제된 라인 플롯을 다시 추가하거나 manual workspace에 라인 플롯을 추가하려면 다음 단계를 따르세요.

1. 해당 Workspace로 이동합니다.

2. Workspace 전체에 라인 플롯을 추가하려면 패널 검색 필드 근처의 컨트롤 바에서 Add panels를 클릭합니다.

   대신 특정 섹션에 직접 라인 플롯을 추가하려면 섹션의 작업 ... 메뉴를 클릭한 다음 + Add panels를 클릭합니다.

3. 기본 설정으로 단일 메트릭 플롯을 추가하려면 Quick panel builder를 클릭합니다.

   1. Single-key panels 탭에서 메트릭 위에 마우스를 올린 후 Add를 클릭합니다. 추가하려는 각 패널에 대해 이 단계를 반복합니다.
   2. Create <number> panels를 클릭합니다.

4. 사용자 지정 라인 플롯을 추가하려면 Line plot을 클릭합니다.

   1. 해당 탭을 사용해 라인 플롯의 데이터, 그룹화, 표시 설정을 구성합니다. 자세한 내용은 Edit line plot settings를 참조하세요.
   2. x축 또는 y축에 계산된 표현식을 추가하려면 Expressions를 클릭합니다. JavaScript regular expressions를 지원합니다. 추가할 패널 유형(예: 차트)을 선택합니다. 선택된 기본값과 함께 패널의 설정 세부 정보가 표시됩니다.

5. 필요에 따라 패널과 표시 설정을 사용자 지정합니다. 설정 옵션은 선택한 패널 유형에 따라 달라집니다. 각 패널 유형의 옵션에 대한 자세한 내용은 Line plots 또는 Bar plots와 같은 아래의 관련 섹션을 참조하세요.

6. Apply를 클릭합니다.

다중 메트릭 라인 플롯

이 기능은 초대받은 사용자에게만 제공되는 프리뷰 단계입니다. 사용 신청을 하려면 support에 문의하거나 담당 AISE에게 연락하세요.

자동 Workspace에서는 기록된 각 메트릭마다 단일 메트릭 라인 플롯이 자동으로 생성됩니다. 이 섹션에서는 JavaScript 정규식을 사용해 여러 메트릭을 함께 보여 주는 단일 라인 플롯을 만드는 방법을 설명합니다. 선택적으로 여러 개의 단일 메트릭 플롯을 하나의 멀티 메트릭 플롯으로 통합할 수 있습니다. 이렇게 하면 많은 메트릭이 기록된 워크스페이스의 성능을 개선하고, run 결과를 효율적으로 분석하는 데 도움이 됩니다.

1. 워크스페이스로 이동합니다.

2. 워크스페이스 전체에 라인 플롯을 추가하려면 패널 검색 필드 근처의 컨트롤 바에서 Add panels를 클릭합니다.

   대신 특정 섹션에 직접 라인 플롯을 추가하려면 섹션의 ... 작업 메뉴를 클릭한 다음 + Add panels를 클릭합니다.

3. Quick panel builder를 클릭한 다음 Multi-metric panels 탭을 클릭합니다.

4. Regex에 JavaScript 정규 표현식 형식의 표현식을 입력합니다. 입력하는 동안 어떤 메트릭이 해당 표현식과 일치하는지 UI에 표시됩니다. 기본적으로 플롯 이름에는 해당 플롯에서 사용된 정규식이 표시됩니다. 플롯에는 표현식과 일치하는 모든 메트릭(향후에 기록되는 메트릭 포함)의 선이 포함됩니다.

5. 멀티 메트릭 플롯을 생성할 때 중복된 단일 메트릭 패널을 선택적으로 제거하려면 Clean up auto-generated panels를 토글합니다. 어떤 패널이 정리될지 미리 보기가 표시됩니다.

6. Create <number> panels를 클릭합니다.

​

멀티 메트릭 정규식에 대한 추가 정보

멀티 메트릭 라인 플롯은 JavaScript 정규 표현식을 사용해 메트릭 이름을 매칭합니다. 이 섹션에서는 일반적인 사용 사례를 몇 가지 보여 주고, 캡처 그룹이 생성되는 패널에 어떤 영향을 미치는지 등 정규식이 동작하는 방식에 대해 더 자세히 설명합니다.

​

일반적인 사용 사례

이 섹션에서는 멀티 메트릭 패널을 사용해 실험 결과를 분석하는 몇 가지 방법을 설명합니다.

레이어 또는 모델 컴포넌트별 메트릭 비교 각 레이어의 메트릭마다 별도의 패널을 만드는 대신 하나의 패널에서 함께 볼 수 있습니다. 예를 들어, 다음 Python 예제 코드처럼 layer_0_loss, layer_1_loss, layer_2_loss와 같이 일관된 이름으로 메트릭을 기록하는 경우, layer_\d+_loss 정규식을 사용해 모든 레이어의 loss를 하나의 플롯에 표시할 수 있습니다.

with wandb.init(project="multi-layer-model") as run:
    for step in range(100):
        run.log({
            "layer_0_loss": loss_0,
            "layer_1_loss": loss_1,
            "layer_2_loss": loss_2,
            "step": step
        })

관련된 메트릭을 접두사나 접미사로 그룹화하기 공통된 이름 패턴을 공유하는 모든 메트릭을 매칭합니다. 예를 들어:

• train_.*는 train_loss, train_accuracy, train_f1_score와 같은 모든 트레이닝 메트릭과 일치합니다.
• .*_accuracy는 train_accuracy, val_accuracy, test_accuracy처럼 서로 다른 데이터셋 전반의 accuracy 메트릭과 일치합니다.

특정 메트릭 변형만 매칭하기 OR(또는) 연산자를 사용해 원하는 메트릭만 매칭합니다. 예를 들어, non-capturing 그룹 (?:layer_0|layer_10)_loss는 중간 레이어를 제외하고 첫 번째와 열 번째 레이어의 loss만 매칭합니다.

​

캡처 그룹 이해하기

정규식의 캡처 그룹은 다중 메트릭 패널이 생성되는 방식을 제어합니다. 이 동작은 미리 알지 못하면 헷갈릴 수 있습니다.

• 캡처 그룹은 여러 개의 패널을 생성합니다 정규식에 캡처 그룹을 이루는 괄호가 포함되어 있으면, UI는 해당 그룹이 캡처한 고유한 값마다 각각 별도의 패널을 생성합니다.

  예를 들어, 정규식 (layer_0|layer_10)_loss에는 캡처 그룹이 포함되어 있으며, 다음과 같이 두 개의 별도 패널을 생성합니다:

  1. layer_0와 일치하는 메트릭에 대한 패널 하나
  2. layer_10와 일치하는 메트릭에 대한 패널 하나

• Non-capturing 그룹은 메트릭을 한데 모읍니다 여러 대안을 매칭하면서도 별도의 패널을 만들지 않으려면 ?: 문법을 사용하는 non-capturing 그룹을 사용하세요. 정규식 (?:layer_0|layer_10)_loss는 앞의 예와 동일한 메트릭과 일치하지만, 하나의 패널에 함께 표시합니다.

차이는 다음과 같습니다:

• (layer_0|layer_10)_loss - 각 레이어에 대해 패널 두 개를 생성합니다.
• (?:layer_0|layer_10)_loss - 두 레이어를 함께 보여주는 패널 하나를 생성합니다.

이를 통해 분석 목적에 가장 잘 맞는 방식을 선택할 수 있는 유연성이 생깁니다. 메트릭을 별도의 패널로 분리하고 싶다면 캡처 그룹을 사용하세요. 단일 플롯에서 메트릭을 함께 비교하고 싶다면 non-capturing 그룹을 사용하세요.

​

라인 플롯 설정 수정

이 섹션에서는 개별 라인 플롯 패널, 섹션 내의 모든 라인 플롯 패널, 또는 Workspace의 모든 라인 플롯 패널 설정을 수정하는 방법을 설명합니다. 라인 플롯 설정에 대한 자세한 내용은 라인 플롯 참조를 참고하세요.

​

개별 라인 플롯

개별 라인 플롯 설정은 섹션 또는 워크스페이스 수준의 라인 플롯 설정보다 우선합니다. 라인 플롯을 사용자 지정하려면:

1. 워크스페이스로 이동합니다.
2. 패널 위에 마우스를 올린 다음 톱니바퀴 아이콘을 클릭합니다.
3. 나타나는 드로어에서 설정을 편집할 탭을 선택합니다.
4. Apply를 클릭합니다.

라인 플롯 설정은 다음과 같은 탭으로 구성됩니다:

• Data: x축, y축, 샘플링 방법, 스무딩, 이상치, 차트 유형을 구성합니다.
• Grouping: 플롯에서 run을 어떻게 그룹화하고 집계할지 설정합니다.
• Chart: 패널과 축의 제목을 지정하고, 범례의 표시 여부와 위치를 구성합니다.
• Legend: 패널 범례의 모양과 내용을 사용자 지정합니다.
• Expressions: 축에 사용할 사용자 정의 계산식을 추가합니다.

각 설정에 대한 자세한 내용은 Line plot reference를 참조하세요.

​

섹션의 모든 라인 플롯

섹션의 모든 라인 플롯에 대한 기본 설정을 사용자 지정하여, 라인 플롯에 대한 워크스페이스 설정을 재정의하려면:

1. 워크스페이스로 이동합니다.
2. 섹션의 톱니바퀴 아이콘을 클릭하여 설정을 엽니다.
3. 나타나는 드로어에서 Data 또는 Display preferences 탭을 선택해 섹션의 기본 설정을 설정합니다. 각 Data 설정에 대한 자세한 내용은 Line plot reference를 참조하세요. 각 표시 환경설정에 대한 자세한 내용은 Configure section layout을 참조하세요.

​

워크스페이스의 모든 선형 플롯

워크스페이스의 모든 선형 플롯에 대한 기본 설정을 변경하려면 다음을 수행하세요:

1. 워크스페이스로 이동합니다.
2. 기어 아이콘과 Settings 레이블이 있는 워크스페이스 설정 아이콘을 클릭합니다.
3. Line plots를 클릭합니다.
4. 표시되는 드로어에서 Data 또는 Display preferences 탭을 선택하여 워크스페이스의 기본 설정을 구성합니다.
   • 각 Data 설정에 대한 자세한 내용은 Line plot reference를 참조하세요.
   • 각 Display preferences 섹션에 대한 자세한 내용은 Workspace display preferences를 참조하세요. 워크스페이스 수준에서 선형 플롯에 대한 기본 Zooming 동작을 구성할 수 있습니다. 이 설정은 x-축 키가 동일한 선형 플롯 간에 확대/축소를 동기화할지 여부를 제어합니다. 기본값은 사용 안 함입니다.

​

플롯에서 평균값 시각화하기

여러 개의 서로 다른 실험이 있고 플롯에서 값들의 평균을 보고 싶다면, 테이블의 Grouping 기능을 사용할 수 있습니다. run 테이블 위의 “Group”을 클릭하고 “All”을 선택하면 그래프에 평균값이 표시됩니다.

다음은 평균을 내기 전 그래프의 모습입니다.

다음 이미지는 그룹화된 선을 사용해 run 전체에 대한 평균값을 나타내는 그래프입니다.

​

플롯에서 NaN 값 시각화하기

wandb.Run.log()을 사용하면 PyTorch 텐서를 포함한 NaN 값도 선 그래프에 시각화할 수 있습니다. 예를 들어:

with wandb.init() as run:
    # NaN 값 로깅
    run.log({"test": float("nan")})

​

하나의 차트에서 여러 메트릭 비교하기

1. 워크스페이스로 이동합니다.
2. 페이지 오른쪽 상단에서 Add panels 버튼을 선택합니다.
3. 나타나는 드로어에서 Evaluation 드롭다운을 펼칩니다.
4. Run comparer를 선택합니다.

​

선들의 색상 변경하기

기본 run 색상이 비교에 도움이 되지 않을 때가 있습니다. 이를 위해 wandb는 색상을 수동으로 변경할 수 있는 두 가지 방법을 제공합니다.

run 테이블에서 변경하기

각 run은 초기화 시 기본적으로 무작위 색상이 지정됩니다.

색상 중 하나를 클릭하면 색상 팔레트가 나타나며, 여기에서 원하는 색상을 수동으로 선택할 수 있습니다.

차트 범례 설정에서 변경하기

1. 워크스페이스로 이동합니다.
2. 설정을 변경하려는 패널 위로 마우스를 가져갑니다.
3. 나타나는 연필 아이콘을 선택합니다.
4. Legend 탭을 선택합니다.

​

다른 x축으로 시각화하기

실험에 소요된 절대 시간을 보거나, 실험이 어떤 날짜에 실행되었는지 확인하고 싶다면 x축을 변경할 수 있습니다. 아래는 스텝에서 상대 시간으로, 다시 wall time(실제 시간)으로 전환하는 예시입니다.

커스텀 x축을 사용하려면 y축을 로깅하는 것과 같은 wandb.Run.log() 호출에서 해당 메트릭을 함께 로깅하십시오. 예를 들면 다음과 같습니다:

with wandb.init() as run:
    for i in range(100):
        run.log({"accuracy": acc, "custom_x": i * 10})

자세한 내용은 로그 축 사용자 지정을 참고하세요.

​

확대/축소

차트 위에서 드래그해 사각형을 그리면 세로와 가로 방향을 동시에 확대/축소할 수 있습니다. 이렇게 하면 x축과 y축의 확대/축소가 함께 변경됩니다.

​

차트 범례 숨기기

이 간단한 토글을 사용해 선 그래프에서 범례를 숨길 수 있습니다:

​

run 메트릭 알림 만들기

Automations를 사용하여 지정한 조건을 run 메트릭이 만족하면 팀에 알림을 보낼 수 있습니다. Automation은 Slack 채널에 게시하거나 웹훅을 실행할 수 있습니다.

라인 플롯에서 플롯에 표시된 메트릭에 대해 바로 run 메트릭 알림을 생성할 수 있습니다:

1. 워크스페이스로 이동합니다.
2. 패널 위에 마우스를 올린 다음 종 모양 아이콘을 클릭합니다.
3. 기본 또는 고급 설정 컨트롤을 사용하여 automation을 설정합니다. 예를 들어 automation의 범위를 제한하기 위해 run 필터를 적용하거나, 절대 임계값을 설정할 수 있습니다.

Automations에 대해 더 알아보세요.