> ## Documentation Index
> Fetch the complete documentation index at: https://docs.wandb.ai/llms.txt
> Use this file to discover all available pages before exploring further.

> PaddleDetection과 W&B를 통합해 객체 탐지 모델의 트레이닝을 추적하고 메트릭을 기록하며 결과를 시각화합니다.

# PaddleDetection

export const ColabLink = ({url}) => <a href={url} target="_blank" rel="noopener noreferrer" className="colab-link">
    <svg width="20" height="20" viewBox="0 0 24 24" fill="currentColor" xmlns="http://www.w3.org/2000/svg">
      <path d="M14.25.18l.9.2.73.26.59.3.45.32.34.34.25.34.16.33.1.3.04.26.02.2-.01.13V8.5l-.05.63-.13.55-.21.46-.26.38-.3.31-.33.25-.35.19-.35.14-.33.1-.3.07-.26.04-.21.02H8.77l-.69.05-.59.14-.5.22-.41.27-.33.32-.27.35-.2.36-.15.37-.1.35-.07.32-.04.27-.02.21v3.06H3.17l-.21-.03-.28-.07-.32-.12-.35-.18-.36-.26-.36-.36-.35-.46-.32-.59-.28-.73-.21-.88-.14-1.05-.05-1.23.06-1.22.16-1.04.24-.87.32-.71.36-.57.4-.44.42-.33.42-.24.4-.16.36-.1.32-.05.24-.01h.16l.06.01h8.16v-.83H6.18l-.01-2.75-.02-.37.05-.34.11-.31.17-.28.25-.26.31-.23.38-.2.44-.18.51-.15.58-.12.64-.1.71-.06.77-.04.84-.02 1.27.05zm-6.3 1.98l-.23.33-.08.41.08.41.23.34.33.22.41.09.41-.09.33-.22.23-.34.08-.41-.08-.41-.23-.33-.33-.22-.41-.09-.41.09zm13.09 3.95l.28.06.32.12.35.18.36.27.36.35.35.47.32.59.28.73.21.88.14 1.04.05 1.23-.06 1.23-.16 1.04-.24.86-.32.71-.36.57-.4.45-.42.33-.42.24-.4.16-.36.09-.32.05-.24.02-.16-.01h-8.22v.82h5.84l.01 2.76.02.36-.05.34-.11.31-.17.29-.25.25-.31.24-.38.2-.44.17-.51.15-.58.13-.64.09-.71.07-.77.04-.84.01-1.27-.04-1.07-.14-.9-.2-.73-.25-.59-.3-.45-.33-.34-.34-.25-.34-.16-.33-.1-.3-.04-.25-.02-.2.01-.13v-5.34l.05-.64.13-.54.21-.46.26-.38.3-.32.33-.24.35-.2.35-.14.33-.1.3-.06.26-.04.21-.02.13-.01h5.84l.69-.05.59-.14.5-.21.41-.28.33-.32.27-.35.2-.36.15-.36.1-.35.07-.32.04-.28.02-.21V6.07h2.09l.14.01.21.03zm-6.47 14.25l-.23.33-.08.41.08.41.23.33.33.23.41.08.41-.08.33-.23.23-.33.08-.41-.08-.41-.23-.33-.33-.23-.41-.08-.41.08z" />
    </svg>
    Colab에서 사용해 보기
  </a>;

<ColabLink url="https://colab.research.google.com/drive/1ywdzcZKPmynih1GuGyCWB4Brf5Jj7xRY?usp=sharing" />

[PaddleDetection](https://github.com/PaddlePaddle/PaddleDetection)은 [PaddlePaddle](https://github.com/PaddlePaddle/Paddle)를 기반으로 하는 엔드 투 엔드 객체 탐지 개발 키트입니다. 네트워크 컴포넌트, 데이터 증강, 손실 함수와 같은 구성 가능한 모듈을 사용해 다양한 주요 객체를 탐지하고, 인스턴스를 분할하며, 키포인트를 추적하고 탐지합니다.

이제 PaddleDetection에는 모든 트레이닝 및 검증 메트릭과 모델 체크포인트, 그리고 해당 메타데이터를 로깅하는 W\&B 기본 제공 인테그레이션이 포함되어 있습니다.

PaddleDetection `WandbLogger`는 트레이닝 중 트레이닝 및 평가 메트릭과 모델 체크포인트를 W\&B에 로깅합니다.

[`COCO2017` 데이터셋의 일부로 YOLOX 모델을 PaddleDetection과 통합하는 방법을 보여 주는 W\&B 블로그 게시물 읽기](https://wandb.ai/manan-goel/PaddleDetectionYOLOX/reports/Object-Detection-with-PaddleDetection-and-W-B--VmlldzoyMDU4MjY0)

<div id="sign-up-and-create-an-api-key">
  ## 가입하고 API 키 만들기
</div>

API 키로 머신을 W\&B에 인증합니다. 사용자 프로필에서 API 키를 생성할 수 있습니다.

<Note>
  더 간편하게 하려면 [User Settings](https://wandb.ai/settings)로 이동해 API 키를 생성하세요. API 키는 즉시 복사해 비밀번호 관리자와 같은 안전한 위치에 저장하세요.
</Note>

1. 오른쪽 상단에 있는 사용자 프로필 아이콘을 클릭합니다.
2. **User Settings**를 선택한 다음 **API Keys** 섹션으로 스크롤합니다.

<div id="install-the-wandb-library-and-log-in">
  ## `wandb` 라이브러리 설치 및 로그인
</div>

로컬에 `wandb` 라이브러리를 설치하고 로그인하려면 다음 단계를 따르세요.

<Tabs>
  <Tab title="명령줄">
    1. `WANDB_API_KEY` [환경 변수](/ko/models/track/environment-variables/)를 API 키로 설정합니다.

       ```bash theme={null}
       export WANDB_API_KEY=<your_api_key>
       ```

    2. `wandb` 라이브러리를 설치하고 로그인합니다.

       ```shell theme={null}
       pip install wandb

       wandb login
       ```
  </Tab>

  <Tab title="Python">
    ```bash theme={null}
    pip install wandb
    ```

    ```python theme={null}
    import wandb
    wandb.login()
    ```
  </Tab>

  <Tab title="Python notebook">
    ```notebook theme={null}
    !pip install wandb

    import wandb
    wandb.login()
    ```
  </Tab>
</Tabs>

<div id="activate-the-wandblogger-in-your-training-script">
  ## 트레이닝 스크립트에서 `WandbLogger` 활성화하기
</div>

<Tabs>
  <Tab title="명령줄">
    [PaddleDetection](https://github.com/PaddlePaddle/PaddleDetection/)의 `train.py`에 인자를 전달해 wandb를 사용하려면 다음과 같이 합니다.

    * `--use_wandb` 플래그를 추가합니다.
    * 첫 번째 wandb 인자 앞에는 반드시 `-o`를 넣어야 합니다(한 번만 전달하면 됩니다).
    * 각 인자에는 반드시 `"wandb-"` 접두사가 포함되어야 합니다. 예를 들어 [`wandb.init()`](/ko/models/ref/python/functions/init)에 전달하는 인자는 모두 `wandb-` 접두사를 붙여야 합니다.

    ```shell theme={null}
    python tools/train.py 
        -c config.yml \ 
        --use_wandb \
        -o \ 
        wandb-project=MyDetector \
        wandb-entity=MyTeam \
        wandb-save_dir=./logs
    ```
  </Tab>

  <Tab title="`config.yml`">
    `config.yml` 파일의 `wandb` 키 아래에 wandb 인자를 추가합니다.

    ```
    wandb:
      project: MyProject
      entity: MyTeam
      save_dir: ./logs
    ```

    `train.py` 파일을 실행하면 W\&B 대시보드로 연결되는 링크가 생성됩니다.

    <Frame>
      <img src="https://mintcdn.com/wb-21fd5541/mVjDwbx0mC8gYx-b/images/integrations/paddledetection_wb_dashboard.png?fit=max&auto=format&n=mVjDwbx0mC8gYx-b&q=85&s=16620f497c7791c6f323af2b27ee73d1" alt="W&B 대시보드" width="2754" height="1340" data-path="images/integrations/paddledetection_wb_dashboard.png" />
    </Frame>
  </Tab>
</Tabs>

<div id="feedback-or-issues">
  ## 피드백 또는 문제
</div>

W\&B 인테그레이션에 대한 피드백이나 문제가 있으면 [PaddleDetection GitHub](https://github.com/PaddlePaddle/PaddleDetection)에서 이슈를 등록하거나 <a href="mailto:support@wandb.com">[support@wandb.com](mailto:support@wandb.com)</a>으로 이메일을 보내세요.
