조건 명세(Condition Spec)

조건 명세는 어떤 질문을 어떤 조건으로 실행했는지 기록하는 최소 단위입니다. 잘 정의된 조건 명세는 반복 실행, 팀 공유, 결과 비교를 훨씬 쉽게 만듭니다.

왜 필요한가요?

같은 타겟이라도 질환 맥락, 세포유형, 시점, 투여 조건이 달라지면 결과 해석이 완전히 달라질 수 있습니다. 조건 명세는 실행 맥락을 함께 보존해 결과를 다시 재현하고 비교할 수 있도록 합니다.

필수 필드

• dataset_id: 준비된 데이터 또는 모델의 식별자
• mode: 실행 유형 예: knockdown
• targets: 섭동하거나 비교할 유전자/단백질 목록
• condition: 시나리오를 구분하는 조건 라벨

권장 메타데이터

• 기준 조건 이름 예: control, untreated, baseline
• 질환 또는 코호트 정보 예: ALS, NSCLC, sporadic, responder
• 세포유형 또는 조직 정보 예: motor_neuron, hepatocyte, CHO
• 시점 정보 예: early, mid, late, d18
• 약물·배양·투여 맥락 예: dose, medium, growth factor, oxygen
• 주요 readout 예: marker_panel, candidate_ranking, export_summary

조건 라벨 작성 팁

• 짧지만 구분 가능한 이름을 사용합니다.
• 질환/세포유형/시점/처리 조건이 섞여 있다면 일정한 순서로 적습니다.
• 팀 내에서 같은 의미를 같은 단어로 쓰도록 규칙을 맞춥니다.

예시 스펙

{
  "dataset_id": "ds_als_motor_neuron_v1",
  "mode": "knockdown",
  "targets": ["GENE_A", "GENE_B"],
  "condition": "sporadic_motor_neuron_d18"
}

해석 예시

위 스펙은 ALS의 sporadic 코호트, motor neuron, d18 맥락에서 특정 타겟 녹다운 조건을 생성·비교하기 위한 최소 요청 예시로 볼 수 있습니다. 실제 운영에서는 기준 조건 이름, 마커 패널, 내보내기 형식 같은 메타데이터를 함께 관리하면 더 유용합니다.