PlateLab 사용법

PlateLab 사용법

Colony forming assay 사진을 잘라서(Crop) 보정하고(Enhance) colony 면적을 재고(Quantify) 조건을 붙여(Plate Map) Prism 표로 내보내는(Export) 순서를 처음부터 따라갑니다.

주소 platelab.pages.dev 기준 버전 v0.5.1 Chrome · Edge 권장 사진은 서버로 올라가지 않음

0사진 준비

PlateLab 을 열기 전에 사진을 폴더별로 나눠 두면 뒤의 단계가 거의 자동으로 됩니다.

  • plate 전체를 한 장에 찍습니다. well 을 하나씩 찍을 필요는 없습니다. 같은 사진 안의 well 은 조명·초점이 같아서 비교가 공정합니다.
  • 가능하면 카메라 높이를 고정합니다. 사진마다 plate 위치가 비슷하면 크롭 위치를 한 번만 맞추면 됩니다.
  • 세포주(또는 조건)마다 폴더를 나눕니다. 폴더 이름이 그대로 Cell line 이 됩니다.
seeding density/          ← 이 폴더를 통째로 고릅니다
├─ H1666/
├─ H2009/   20260702_075800.jpg  20260702_075812.jpg …
├─ HCC15/   20260702_075547.jpg  20260702_075602.jpg …
└─ HCC366/
PlateLab 첫 화면. 가운데에 사진을 불러오라는 안내와 파일 선택 버튼이 있다.
처음 열었을 때. 위쪽 다섯 탭(Crop → Export)이 작업 순서입니다.

1사진 불러와서 well 자르기 Crop

사진에서 well 부분만 원형으로 잘라 냅니다. 잘린 well 하나가 이후 모든 단계의 단위입니다.

사진 불러오기

  1. 왼쪽 위 폴더 선택을 누르고 seeding density 처럼 세포주 폴더들이 들어 있는 상위 폴더를 고릅니다. 하위 폴더(3단계까지)의 사진을 모두 읽습니다.
  2. 또는 탐색기에서 폴더나 사진을 PlateLab 창 아무 곳에 끌어다 놓아도 됩니다.
  3. 오른쪽 아래에 6장 불러옴 · 폴더 H2009, HCC15 처럼 읽은 폴더가 표시됩니다.
Crop 탭. 위에 사진 썸네일 6장, 가운데 사진 위에 원형 그리드, 왼쪽에 그리드 설정, 오른쪽에 크롭 실행 버튼.
사진을 불러온 Crop 화면. 가운데 사진 위의 보라색 원이 잘라 낼 자리이고, 위 막대에 지금 사진 H2009 · 1과 파일 이름이 보입니다.

썸네일 읽는 법 · 필요 없는 사진 빼기

썸네일 줄. 각 썸네일 아래에 H2009·1, HCC15·2 같은 이름, 오른쪽 위에 × 버튼.
썸네일 아래 H2009·1 = 폴더 이름 · 그 폴더 안 사진 순번.
  • 전체 plate 를 확인용으로 찍은 사진처럼 필요 없는 사진은 썸네일 오른쪽 위 ×를 누르거나, 그 사진을 보는 중에 Delete 키를 누르면 빠집니다.
  • 이미 잘라 낸 사진이면 확인창이 뜨고, 그 사진의 크롭·정량·조건도 함께 빠집니다. 순번은 다시 매기지 않으므로 이름이 바뀌지 않습니다.
  • ← → 로 이전·다음 사진으로 넘어갑니다.

Plate 규격 고르기

  • 한 사진에서 well 여러 개를 자를 때: 종류에서 6-well 등을 고르면 행 × 열이 자동으로 들어갑니다.
  • 한 사진에서 well 하나만 자를 때: 행 × 열을 1 × 1 로 둡니다. 위 예시가 이 경우입니다.
  • well 지름 (mm)은 면적을 mm² 로 바꿀 때 씁니다. 6-well 은 34.8 mm 가 기본입니다.

원을 well 에 맞추기

그리드 정렬 패널. 모든 사진 동일 / 사진마다 따로, 새 사진 시작 공통 위치 / 직전 사진, 가로 간격·세로 간격·반지름·회전 슬라이더.
그리드 정렬 패널 (「사진마다 따로」를 고른 상태).
  • 원 안쪽을 끌면 원 전체가 움직입니다.
  • 원 테두리를 끌면 크기가 바뀝니다. 커서가 화살표 모양으로 바뀌는 곳이 테두리입니다.
  • 미세 조정: Ctrl+방향키 1 px, Ctrl+Shift+방향키 10 px.
  • 슬라이더로 간격·반지름·회전을 직접 바꿔도 됩니다.

사진마다 위치가 다를 때

세포주마다 따로 찍었거나 plate 위치가 사진마다 다르면 사진마다 따로를 고릅니다. 조정하면 그 사진만 바뀌고, 썸네일 왼쪽 위에 개별 표시가 붙습니다.

새 사진 시작다음 사진으로 넘어가면이럴 때
공통 위치처음 정한 공통 위치에서 시작대부분 같은 자리이고 몇 장만 다를 때
직전 사진방금 맞춘 위치·크기를 그대로 가져감같은 세포주 사진을 연달아 조금씩 고칠 때
  • 이 위치를 전체에 = 지금 사진의 위치를 모든 사진에 적용 · 공통 위치로 = 이 사진만 되돌리기.
  • 그리드로 안 맞는 사진은 오른쪽 이 이미지에서 검출(원형 well 자동 검출)이나 수동 ROI(클릭으로 원 추가·삭제)를 씁니다. 비스듬히 찍었으면 4점 보정으로 plate 네 모서리를 클릭해 펴 줍니다.

크롭 실행

오른쪽 패널. 자동 정합, well 자동 검출, 크롭 실행 버튼과 결과 6 well, PNG 묶음 저장 버튼.
크롭이 끝나면 「결과 6 well」과 저장 버튼이 나옵니다.
  1. 오른쪽 대상을 전체 이미지로 두고 크롭 실행.
  2. 폴더째 불러왔다면 폴더 이름으로 Cell line N개를 채웠습니다가 뜹니다. Plate Map 에 세포주가 이미 들어가 있다는 뜻입니다.
  3. 잘린 well 이름은 H2009 · 3 (한 사진에서 여러 well 이면 H2009 · 3 · B2).
  4. 크롭만 필요하면 PNG 묶음 저장으로 여기서 끝내도 됩니다.
다시 잘라도 괜찮습니다

위치를 고치고 크롭을 다시 실행해도, 같은 사진·같은 well 에 Plate Map 에서 넣어 둔 조건(Drug, Conc. 등)은 유지됩니다. 정량 결과는 다시 계산해야 합니다.

2보정하기 Enhance

그림(figure)에 쓸 밝기·대비 보정과, 정량 전에 조명 얼룩을 지우는 배경 빼기가 있습니다. 보정 없이 바로 Quantify 로 가도 됩니다.

Enhance 탭. 왼쪽에 배경 빼기와 밝게·어둡게·감마·대비·채도·선명도 슬라이더와 숫자 칸, 가운데에 원본과 보정본 well 이 나란히.
왼쪽 원이 원본, 오른쪽이 보정본. 보정은 원 안쪽에만 걸리고 검은 여백은 그대로입니다.

표현용 보정 (정량에는 안 들어감)

  • 슬라이더를 움직이거나 오른쪽 숫자 칸에 값을 직접 넣습니다.
  • 슬라이더나 항목 이름을 더블클릭하면 기본값으로 돌아갑니다.
  • 키보드: ↑↓ 항목 이동 · ←→ 한 칸 · Ctrl+←→ 열 칸 · Esc 로 빠져나오면 ←→가 다시 well 넘기기.
  • 전체 적용을 눌러야 모든 well 에 같은 보정이 걸린 것으로 기록됩니다.

보정본 저장

  • 이 well 저장 — 지금 보는 well 을 PNG 로 (1000 × 1000 px).
  • 전체 ZIP — 모든 well 보정본 + 사용한 보정값 enhance_settings.json. 파일 이름 앞에 세포주가 붙습니다 (H2009_20260702_075812_A1_enh.png).

자주 쓰는 값 저장

아래 저장된 설정에서 이름을 넣고 현재 값 저장. 시작값으로 지정하면 ★가 붙고, 다음에 PlateLab 을 열 때 자동으로 적용됩니다. 이 브라우저에만 저장되므로 다른 PC 에서는 파일로 저장 / 파일 불러오기를 씁니다.

배경 빼기(rolling ball)는 빽빽한 plate 에 쓰지 마세요

배경 빼기는 반지름보다 큰 덩어리를 배경으로 보고 지웁니다. colony 가 well 을 거의 덮으면 염색 자체가 지워집니다. H2009 에서 실제로 꽉 찬 well 이 100 % → 0.1 % 로 나왔습니다. 켜 두면 Enhance·Quantify 양쪽에 경고가 뜹니다.

3colony 면적 재기 Quantify

well 마다 colony 가 차지한 면적(Total Area, %Area)과 개수를 잽니다. 대표 지표는 면적입니다.

권장 설정 (여러 세포주 · seeding density)

Enhance
배경 빼기 끔
빽빽한 well 이 지워지지 않게
Threshold 기준
공통
모든 well 을 같은 기준으로 가름
묶는 단위
Cell line 별
세포주마다 염색 진하기가 달라도 안전
threshold 계산
ROI 안쪽만 (켬)
원 밖 검은 여백을 빼고 계산
Threshold 패널. 기준 well별/공통/고정 중 공통 선택, 묶는 단위 Cell line 별, 지난 실행 값 H2009 139 · HCC15 134.
「공통 · Cell line 별」. 실행 후 세포주별 기준값이 표시됩니다 (예: H2009 139, HCC15 134).
기준뜻
well별well 마다 자동 threshold. 빈 well·꽉 찬 well 에서는 가를 곳이 없어 틀어집니다. 기존 ImageJ 매크로와 숫자를 맞출 때만.
공통여러 well 의 밝기 분포를 합쳐 기준 하나를 정해 모두에 씁니다.
고정직접 넣은 값을 모두에. 여러 plate 를 같은 기준으로 비교할 때.

실행하고 확인하기

  1. 왼쪽 맨 아래 정량 실행.
  2. 썸네일 화면에서 well 마다 면적을 한눈에 봅니다.
  3. well 을 누르면 검수 화면으로 갑니다. Mask A(면적)가 colony 와 겹치는지 눈으로 확인하고, ←→ 로 넘기며 전부 봅니다.
Quantify 썸네일 화면. well 6개 아래 H2009·1 47503 같은 이름과 면적, 오른쪽에 평균 Total Area와 QC 요약.
썸네일. 각 칸 아래가 well 이름과 Total Area(px²). 오른쪽 QC 요약의 「threshold 상한 범위」로 기준값을 확인합니다.
Quantify 검수 화면. 원본, Mask A 흰색 마스크, Mask B 보라색 마스크, 윤곽 오버레이 네 칸과 아래 히스토그램.
검수 화면. 원본 · Mask A(면적용) · Mask B(개수용, 붙은 colony 분리) · 윤곽 오버레이. 위 줄에 Area, %Area, Count, 사용한 threshold.
숫자를 읽을 때

「구멍 포함」이 켜져 있으면 colony 덩어리 사이 밝은 틈도 면적에 들어갑니다. 거의 꽉 찬 well 은 실제보다 조금 높게 나올 수 있습니다 (H2009 예: 틈 제외 83.8 %, 포함 96.7 %).

아주 옅게 염색된 colony 는 공통 기준에서 일부 빠질 수 있습니다. 검수 화면에서 확인하고 필요하면 고정으로 값을 조금 올립니다.

정량 설정도 Enhance 와 같이 저장된 설정에 이름을 붙여 저장·시작값 지정이 됩니다.

4조건 붙이기 Plate Map

well 마다 Cell line · Drug · Conc. · IR(Gy) · Replicate 를 지정합니다. 같은 조건끼리 묶여 평균·SD 가 나옵니다.

Plate Map 탭. 왼쪽에 Cell line·Drug·Conc·IR·Replicate 입력칸, 가운데에 사진별 well 원이 세포주 색으로 칠해져 있고 아래 그룹 요약 표.
폴더째 불러왔으면 Cell line 이 이미 칠해져 있습니다. 가운데 원을 눌러(또는 끌어서) 고르고 왼쪽에 값을 넣은 뒤 선택에 적용.
  1. well 원을 클릭하거나 끌어서 여러 개를 고릅니다.
  2. 왼쪽 칸에 넣을 값만 입력합니다. 비워 둔 칸은 기존 값을 유지합니다.
  3. 선택에 적용.
  4. 정규화 기준군에서 대조군을 고르면 그 군 평균이 100 % 가 되는 Relative colony area 가 계산됩니다.
  5. 같은 배치를 반복하면 템플릿 → 저장으로 JSON 을 남겨 다음 실험에 불러옵니다.

5내보내기 Export

Export 탭. 왼쪽에 Prism 형식 복사, raw CSV, summary CSV, QC 리포트 CSV, 이미지 ZIP, Methods 문장 복사 버튼. 가운데에 raw 데이터 표와 영문 Methods 문단.
Export. 가운데 표가 well 별 raw 데이터, 아래가 실제 사용한 설정으로 만들어진 영문 Methods 문단입니다.
버튼무엇이 나오나어디에 쓰나
Prism 형식 복사열 = 조건, 행 = replicatePrism Grouped table 이나 Excel 에 바로 붙여넣기
raw CSVwell 별 이름·조건·면적·%Area·threshold원자료 보관
summary CSV조건별 n · 평균 · SD · SEM요약 표
QC 리포트 CSVwell 별 threshold, 상한 적용, 입자 수, 배경 빼기 여부검증 기록
이미지 ZIP크롭 원본 · Mask A · Mask B (골라서)보충 자료
Methods 문장 복사사용한 설정이 그대로 반영된 영문 문단논문 Methods
상대값이 비어 있으면

지표를 Relative colony area 로 골랐는데 값이 비어 있으면 Plate Map 에서 정규화 기준군(대조군)을 아직 고르지 않은 것입니다.

단축키

어디서키동작
Crop← →이전·다음 사진
CropCtrl+방향키원 위치 1 px (Shift 더하면 10 px)
CropDelete지금 사진 빼기
Enhance← →이전·다음 well (항목을 고르지 않았을 때)
Enhance↑ ↓보정 항목 고르기·이동
Enhance← → / Ctrl+← →고른 항목 한 칸 / 열 칸
EnhanceEsc항목에서 빠져나오기
Quantify← →이전·다음 well (검수 화면으로 이동)
어디서나더블클릭Enhance 슬라이더·이름 → 기본값

막힐 때

증상원인과 해결
정량 결과가 전부 0「배경 빼기」가 켜져 있으면 빽빽한 colony 가 지워집니다. Enhance 에서 끄고 다시 정량 실행.
꽉 찬 well 이 0 % 또는 아주 낮게Threshold 기준이 well별입니다. 공통으로 바꿉니다.
세포주끼리 결과가 이상하게 끌려감공통의 묶는 단위를 Cell line 별로. Plate Map 에 Cell line 이 들어가 있어야 합니다.
폴더를 골랐는데 사진이 안 들어옴폴더 선택 창은 Chrome·Edge 에서 열립니다(다른 브라우저는 폴더 업로드 방식으로 대체). 사진 확장자는 jpg · png · tif · bmp · webp.
잘린 well 이름이 전부 A1A1 은 사진 안의 well 위치입니다. 사진을 폴더째 불러오면 H2009 · 3 처럼 폴더 · 순번으로 나옵니다.
원이 well 과 안 맞음원 안쪽을 끌어 옮기고 테두리를 끌어 크기를 맞춥니다. 사진마다 다르면 「사진마다 따로」.

저장하고 이어 하기

  • 오른쪽 위 세션 저장 — 크롭 위치, 보정·정량 설정, Plate Map 조건을 JSON 으로 받습니다. 사진은 들어가지 않습니다.
  • 이어 할 때는 세션 불러오기 후 같은 사진을 다시 불러옵니다. 사진별 크롭 위치는 파일 이름으로 다시 붙습니다.
  • 전체 초기화는 불러온 사진과 결과를 모두 지웁니다. 되돌릴 수 없습니다.
사진은 밖으로 나가지 않습니다

모든 계산은 브라우저 안에서 합니다. 사진이 서버로 올라가지 않으므로 미발표 데이터도 그대로 써도 됩니다.