USRCAT (RDKit)
USR/USRCAT 형상 지문으로 분자들의 유사도를 비교합니다. 큰 분자 목록에서 후속 검토할 후보를 먼저 추리는 데 쓰입니다.
API·CLI 도구 ID: usrcat
입력과 결과를 이해하기
USRCAT은 분자의 모양과 원자 종류별 분포를 짧은 숫자 목록으로 요약해 비교합니다. 이 요약을 형상 지문이라고 합니다. 두 분자의 원자를 하나씩 겹쳐 맞추는 정밀 정렬 없이, 큰 분자 목록에서 비슷한 후보를 빠르게 추리는 데 씁니다.
querySdf에는 기준 분자 하나를, libraryFiles에는 비교할 분자 목록을 넣습니다. 두 입력 모두 실제 3차원 좌표가 있는 V2000 SDF가 필요합니다. SDF는 원자·결합·좌표를 담는 파일이며, 확장자가 sdf라는 사실만으로 3D 구조가 준비된 것은 아닙니다.
topN은 모든 입력 파일을 합쳐 돌려받을 상위 후보 수입니다. usrcat_score가 1에 가까울수록 이 지문에서 유사하지만, 같은 약효나 결합 능력을 가진다는 뜻은 아닙니다. shape-it의 점수와도 계산 방식이 달라 숫자를 직접 비교하지 않습니다.
입력 설정
| 설정 | 형식 | 필수 | 기본값 | 설명과 제약 |
|---|---|---|---|---|
querySdf | sdf | 필수 | — | 기준 분자 하나 — 3D 좌표가 포함된 V2000 SDF — 확장자 sdf |
libraryFiles | file | 필수 | — | 검색 대상 SDF 1~8개(유한한 3D 좌표의 V2000, 전체 10,000분자 이하). 3D 표시는 구조의 물리적 타당성을 보증하지 않음 — 확장자 sdf, JSON 배열 |
topN | number | 선택 | 50 | 내보낼 상위 유사 분자 수(전체 파일 기준) — 최소 1, 최대 10000 |
산출 지표
| 열 | 표시 이름 | 범위 | 설명 |
|---|---|---|---|
usrcat_score | USRCAT 유사도 | 0~1 | 1에 가까울수록 형상·원자유형 분포가 유사하다. 정밀 정렬·결합력·활성을 뜻하지 않는다. 형상 요약의 기준점을 고를 때 거리가 같은 원자가 있으면, 같은 좌표·결합을 유지해도 파일의 원자 기록 순서에 따라 점수가 달라질 수 있다 |
지표의 의미와 해석할 때 주의할 점은 결과 읽는 법을 보세요. 범위는 값이 나올 수 있는 구간입니다. 값이 높거나 낮을수록 좋은지는 지표마다 확인해야 합니다.
실행 가능 여부
프로젝트에서 실행 계획을 열면 사용할 수 있는 도구 버전과 비용을 확인할 수 있습니다. 입력·설정·이용 조건을 검토하고 승인한 뒤 실행합니다.
라이선스
코드·모델 가중치·함께 쓰는 자료에는 각각의 이용 조건이 적용됩니다. 아래는 공식 배포처의 조건이며, 나두바이오에서 사용할 구성의 조건은 실행 계획에서 확인합니다. 제3자 고지에서 라이선스 원문을 볼 수 있습니다.
| 구성 | 라이선스 | 상업 이용 | 근거 | 비고 |
|---|---|---|---|---|
| 코드 | BSD-3-Clause | 상업 이용 가능(고지 조건 준수) | 라이선스 원문 | USR/USRCAT은 RDKit에 포함된 기능으로 RDKit의 라이선스가 적용됩니다. |
확인일 2026-10-26.