W&B Workspace 는 차트를 맞춤 설정하고 모델 결과를 탐색할 수 있는 개인용 샌드박스입니다. W&B Workspace 는 Tables와 Panel sections로 구성됩니다:
- Tables: 프로젝트에 기록된 모든 Runs가 프로젝트 테이블에 나열됩니다. Runs를 켜거나 끄고, 색상을 변경하며, 테이블을 확장하여 각 Run에 대한 노트, 설정(config), 요약 메트릭을 확인할 수 있습니다.
- Panel sections: 하나 이상의 panels를 포함하는 섹션입니다. 새로운 패널을 생성하고 정리하며, Workspace 의 스냅샷을 저장하기 위해 Reports 로 내보낼 수 있습니다.
Workspace 유형
Workspace 에는 두 가지 주요 카테고리가 있습니다: Personal workspaces와 Saved views.
- Personal workspaces: 모델 분석 및 데이터 시각화를 심층적으로 수행할 수 있는 맞춤형 Workspace 입니다. Workspace 소유자만 편집하고 변경 사항을 저장할 수 있습니다. 팀원은 Personal workspaces 를 볼 수는 있지만 다른 사람의 Personal workspaces 를 수정할 수는 없습니다.
- Saved views: Saved views 는 Workspace 의 협업용 스냅샷입니다. 팀원 누구나 저장된 Workspace 뷰를 보고, 편집하고, 변경 사항을 저장할 수 있습니다. Experiments, Runs 등을 검토하고 논의할 때 저장된 Workspace 뷰를 사용하세요.
다음 이미지는 Cécile-parker의 팀원들이 생성한 여러 Personal workspaces 를 보여줍니다. 이 프로젝트에는 저장된 뷰가 없습니다:
Saved workspace views
맞춤형 Workspace 뷰를 통해 팀 협업을 개선하세요. 선호하는 차트 및 데이터 구성을 정리하기 위해 Saved Views를 생성할 수 있습니다.
새로운 Saved workspace view 생성하기
- Personal workspace 또는 Saved view로 이동합니다.
- Workspace 를 편집합니다.
- Workspace 오른쪽 상단 모서리에 있는 미트볼 메뉴(가로 점 3개)를 클릭합니다. Save as a new view를 클릭합니다.
새로운 Saved views 가 Workspace 탐색 메뉴에 나타납니다.
Saved workspace view 업데이트하기
저장된 변경 사항은 이전에 저장된 뷰의 상태를 덮어씁니다. 저장되지 않은 변경 사항은 유지되지 않습니다. W&B 에서 Saved workspace view를 업데이트하려면 다음 단계를 따르세요:
- Saved view로 이동합니다.
- Workspace 내의 차트와 데이터를 원하는 대로 변경합니다.
- Save 버튼을 클릭하여 변경 사항을 확정합니다.
Workspace 뷰에 업데이트를 저장할 때 확인 대화 상자가 나타납니다. 앞으로 이 프롬프트를 보지 않으려면 저장 확인 전에 Do not show this modal next time 옵션을 선택하세요.
Saved workspace view 삭제하기
더 이상 필요하지 않은 Saved views 를 제거합니다.
- 삭제하려는 Saved view로 이동합니다.
- 뷰 오른쪽 상단의 가로 점 3개(…)를 선택합니다.
- Delete view를 선택합니다.
- 삭제를 확인하여 Workspace 메뉴에서 해당 뷰를 제거합니다.
Workspace view 공유하기
Workspace URL을 직접 공유하여 팀원들과 맞춤형 Workspace 를 공유하세요. 해당 Workspace 프로젝트에 대한 엑세스 권한이 있는 모든 Users 는 해당 Workspace 의 Saved Views를 볼 수 있습니다.
Workspace templates
_Workspace templates_를 사용하면 새 Workspace에 대한 기본 설정 대신 기존 Workspace 와 동일한 설정을 사용하여 빠르게 Workspace 를 생성할 수 있습니다. 현재 Workspace template은 사용자 정의 line plot settings을 정의할 수 있습니다.
기본 Workspace 설정
기본적으로 새 Workspace 는 라인 플롯에 대해 다음 기본 설정을 사용합니다:
| X axis | Default |
|---|
| Value | Step |
| Log scale | false |
| Y axis | Default |
|---|
| Log scale | false |
| Smoothing | Default |
|---|
| Type | Time weight EMA |
| Weight | 0 |
| Show original after smoothing | Off |
| Max number of runs | Default |
|---|
| Max runs | 10 |
| Data | Default |
|---|
| Point aggregation | Full fidelity |
| Grouping | Default |
|---|
| Use grouping in charts | On |
| Group aggregation | Mean |
| Display preferences | Default |
|---|
| Color run names | On |
| Display full run name | Off |
| Show X range in tooltip | Off |
| Tooltip runs | Default |
| Sync zoom across charts | Off |
| Show higlighted run only | Off |
Workspace template 설정하기
- 아무 Workspace 나 열거나 새로 생성합니다.
- 기본 설정에 따라 Workspace 의 line plot settings을 구성합니다.
- 설정을 Workspace template에 저장합니다:
- Workspace 상단에서 Undo 및 Redo 화살표 아이콘 근처의 액션 메뉴
...를 클릭합니다.
- Save personal workspace template을 클릭합니다.
- 템플릿의 라인 플롯 설정을 검토한 후 Save를 클릭합니다.
새로운 Workspace 는 기본 설정 대신 이 설정들을 사용하게 됩니다.
Workspace template 보기
Workspace template의 현재 구성을 보려면 다음 단계를 따르세요:
- 어느 페이지에서나 오른쪽 상단 모서리에 있는 사용자 아이콘을 선택합니다. 드롭다운에서 User Settings를 선택합니다.
- Personal workspace template 섹션으로 이동합니다. Workspace template을 사용 중인 경우 해당 구성이 표시됩니다. 그렇지 않으면 섹션에 세부 정보가 포함되지 않습니다.
Workspace template 업데이트하기
Workspace template을 업데이트하려면 다음 단계를 따르세요:
- 아무 Workspace 나 엽니다.
- Workspace 의 설정을 수정합니다. 예를 들어, 포함할 Runs 의 수를
11로 설정합니다.
- 변경 사항을 템플릿에 저장하려면 Undo 및 Redo 화살표 아이콘 근처의 액션 메뉴
...를 클릭한 다음 Update personal workspace template을 클릭합니다.
- 설정을 확인한 다음 Update를 클릭합니다. 템플릿이 업데이트되고 이를 사용하는 모든 Workspace 에 다시 적용됩니다.
Workspace template 삭제하기
Workspace template을 삭제하고 기본 설정으로 돌아가려면 다음 단계를 따르세요:
- 어느 페이지에서나 오른쪽 상단 모서리에 있는 사용자 아이콘을 선택합니다. 드롭다운에서 User Settings를 선택합니다.
- Personal workspace template 섹션으로 이동합니다. Workspace template의 구성이 표시됩니다.
- Settings 옆의 휴지통 아이콘을 클릭합니다.
Dedicated Cloud 및 Self-Managed의 경우, Workspace template 삭제는 v0.70 이상 버전에서 지원됩니다. 이전 서버 버전에서는 Workspace template을 기본 설정을 사용하도록 업데이트하세요.
프로그래밍 방식으로 Workspace 생성하기
wandb-workspaces는 W&B Workspace 및 Reports 를 프로그래밍 방식으로 다루기 위한 Python 라이브러리입니다.
wandb-workspaces를 사용하여 프로그래밍 방식으로 Workspace 를 정의하세요. wandb-workspaces는 W&B Workspace 및 Reports 를 프로그래밍 방식으로 작업하기 위한 Python 라이브러리입니다.
다음과 같은 Workspace 속성을 정의할 수 있습니다:
- 패널 레이아웃, 색상 및 섹션 순서 설정.
- 기본 x-축, 섹션 순서, 접기 상태와 같은 Workspace 설정 구성.
- 섹션 내에 패널을 추가하고 맞춤 설정하여 Workspace 뷰 정리.
- URL을 사용하여 기존 Workspace 로드 및 수정.
- 기존 Workspace 에 변경 사항 저장 또는 새로운 뷰로 저장.
- 간단한 표현식을 사용하여 프로그래밍 방식으로 Runs 필터링, 그룹화 및 정렬.
- 색상 및 가시성 설정을 통한 Run 모양 맞춤 설정.
- 통합 및 재사용을 위해 한 Workspace 에서 다른 Workspace 로 뷰 복사.
Workspace API 설치
wandb 외에도 wandb-workspaces를 설치해야 합니다:
pip install wandb wandb-workspaces
프로그래밍 방식으로 Workspace 뷰 정의 및 저장
import wandb_workspaces.reports.v2 as ws
# workspace 객체 생성 (entity, project 지정 및 view 정의)
workspace = ws.Workspace(entity="your-entity", project="your-project", views=[...])
workspace.save()
기존 뷰 편집하기
# URL로부터 기존 workspace 로드
existing_workspace = ws.Workspace.from_url("workspace-url")
# 첫 번째 뷰 수정
existing_workspace.views[0] = ws.View(name="my-new-view", sections=[...])
existing_workspace.save()
Workspace saved view를 다른 Workspace 로 복사하기
# 기존 workspace 로드
old_workspace = ws.Workspace.from_url("old-workspace-url")
old_workspace_view = old_workspace.views[0]
# 새로운 entity와 project로 구성된 workspace에 뷰 복사
new_workspace = ws.Workspace(entity="new-entity", project="new-project", views=[old_workspace_view])
new_workspace.save()
포괄적인 Workspace API 예제는 wandb-workspace examples를 참조하세요. 엔드 투 엔드 튜토리얼은 Programmatic Workspaces 튜토리얼을 확인하세요.