SaProt
구조와 서열을 함께 읽어 단백질 변이에 점수를 매깁니다. 제로샷 점수는 별도 변이 데이터로 추가 학습하지 않고 얻으며, 안정성 ΔΔG와는 다릅니다.
API·CLI 도구 ID: saprot
입력과 결과를 이해하기
SaProt는 단백질 서열과 구조를 함께 읽어, 지정한 변이를 모델이 얼마나 그럴듯하게 보는지 점수를 매깁니다. variantsFile의 V3A는 선택한 사슬 서열의 세 번째 아미노산 V를 A로 바꾸는 표기입니다. 위치는 서열에서 1부터 세며, 원본 구조 파일의 잔기 번호와 같다고 가정하지 마세요.
structureSource가 predicted이면 pLDDT가 낮은 잔기의 구조 정보를 가립니다. experimental에서는 이 처리를 하지 않습니다. 실험 구조의 B-factor는 원자의 위치 변동과 관련된 값으로, 예측 신뢰도 pLDDT와 같은 값이 아닙니다.
가리는 판정은 구조 파일의 B-factor 열을 0100 pLDDT 점수로 읽어 plddtThreshold와 비교합니다. 예측 구조 파일이라고 해서 이 열이 늘 pLDDT 점수인 것은 아닙니다. ESMFold 결과의 predicted_structure.pdb는 같은 값을 01 비율로 적고, ImmuneBuilder 결과는 pLDDT가 아니라 잔기별 예측 오차를 옹스트롬(Å)으로 적습니다. 두 파일을 기본값 70으로 그대로 넣으면 모든 잔기가 기준 아래로 판정돼 구조 정보가 전부 가려지고, 서열만 보는 결과에 가까워집니다. 이런 경우 masked_fraction이 1에 가깝게 나오므로 결과를 읽기 전에 이 값을 확인하세요.
score가 클수록 모델은 원래 아미노산보다 변이 아미노산을 더 그럴듯하게 봅니다. ThermoMPNN의 ddG와는 단위와 의미가 다르므로 두 점수를 직접 비교하지 않습니다. masked_fraction이 높으면 구조 정보를 가린 비율이 높다는 뜻이며, 변이가 실패할 확률이 아닙니다.
입력 설정
| 설정 | 형식 | 필수 | 기본값 | 설명과 제약 |
|---|---|---|---|---|
pdbFile | pdb | 필수 | — | 점수를 매길 단백질 구조. foldseek으로 구조 토큰을 만든다 — 확장자 pdb · cif |
chain | chain | 필수 | — | 구조에서 점수를 매길 사슬 하나 — 예 "A" |
structureSource | dropdown | 필수 | — | 예측 구조면 저신뢰(pLDDT) 잔기의 구조 토큰을 가린다. 판정은 구조 파일 B-factor 열을 0~100 pLDDT 점수로 읽는다. 실험 구조는 B-factor가 pLDDT가 아니므로 가리지 않는다 — 허용값 predicted · experimental, 예 "experimental" |
plddtThreshold | number | 선택 | 70 | pLDDT가 이 값보다 낮은 잔기는 구조 정보를 가립니다. 모델의 기본값은 70입니다. B-factor 열이 0~1 비율이나 옹스트롬 오차로 적힌 구조 파일을 넣으면 모든 잔기가 가려지므로 masked_fraction을 확인하세요. — 최소 0, 최대 100 — 적용 조건: structureSource = "predicted" |
variantsFile | csv | 필수 | — | mutation 열이 있는 변이 목록. 예 V3A. 여러 자리는 콜론으로 잇는다(V3A:K6M) — 확장자 csv · tsv |
산출 지표
| 열 | 표시 이름 | 범위 | 설명 |
|---|---|---|---|
mutation | 변이 | — | 입력 표기 그대로. 예 V3A |
score | 변이 점수 | — | log(변이 확률/원래 확률)의 합. 클수록 모델이 그럴듯하게 본다. 안정성 ΔΔG가 아니다 |
masked_fraction | 가린 구조 토큰 비율 | — | 저신뢰로 가린 잔기 비율. 높으면 구조 정보가 적게 쓰였다는 해석 경고 |
지표의 의미와 해석할 때 주의할 점은 결과 읽는 법을 보세요. 범위는 값이 나올 수 있는 구간입니다. 값이 높거나 낮을수록 좋은지는 지표마다 확인해야 합니다.
실행 가능 여부
프로젝트에서 실행 계획을 열면 사용할 수 있는 도구 버전과 비용을 확인할 수 있습니다. 입력·설정·이용 조건을 검토하고 승인한 뒤 실행합니다.
라이선스
코드·모델 가중치·함께 쓰는 자료에는 각각의 이용 조건이 적용됩니다. 아래는 공식 배포처의 조건이며, 나두바이오에서 사용할 구성의 조건은 실행 계획에서 확인합니다. 제3자 고지에서 라이선스 원문을 볼 수 있습니다.
| 구성 | 라이선스 | 상업 이용 | 근거 | 비고 |
|---|---|---|---|---|
| 코드 | MIT | 상업 이용 가능(고지 조건 준수) | 라이선스 원문 | — |
| 모델 가중치 | MIT | 상업 이용 가능(고지 조건 준수) | 가중치 배포처 정보 | 현재 사용하는 SaProt_650M_AF2 가중치는 배포처의 모델 카드에 MIT 라이선스로 명시되어 있습니다. |
| 코드 | GPL-3.0-only | 조건부(비고 참고) | 라이선스 원문 | 구조를 SaProt 입력 토큰으로 바꾸는 foldseek 바이너리(릴리스 10-941cd33)를 실행 이미지에 함께 넣습니다. GPL-3.0이므로 우리 서버에서만 실행하고 고객 서버로 이미지를 보내지 않습니다 |
SaProt는 서열과 foldseek 구조 토큰을 함께 받는 단백질 언어 모델입니다. 제로샷 변이 점수는 진화적 그럴듯함이며 안정성 ΔΔG가 아닙니다
확인일 2026-11-04.