입력 준비하기
서열·구조·저분자 파일을 어떤 형식으로 넣고, 사슬과 구간을 어떻게 고르며, 파일 검사가 무엇을 확인하고 무엇을 확인하지 않는지 설명합니다.
입력 자료의 품질은 계산 결과에 영향을 줍니다. 이 문서에서는 지원하는 입력 형식과 선택 방법, 파일 검사로 확인하는 내용을 안내합니다.
입력 형식
| 갈래 | 형식 | 담는 것 |
|---|---|---|
| 서열 | FASTA, 직접 입력 | 아미노산이나 핵산의 문자열 |
| 구조 | PDB, mmCIF | 원자의 3차원 좌표 |
| 저분자 | SMILES, SDF | 원자와 결합 관계, 경우에 따라 좌표 |
| 표 | CSV | 여러 후보를 한 번에 넘길 때의 목록 |
도구마다 받는 입력 형식이 다릅니다. 도구를 고르면 필요한 입력이 화면에 표시되고, 각 도구의 참조 문서에도 같은 내용이 있습니다.
외부 사이트에서 받은 자료 준비
- 입력 형식 확인
- 압축 풀기
- 파일 업로드
- 형식 검사
- 서열·분자·사슬 선택
외부 자료는 고객이 원천 사이트에서 직접 확보합니다. 나두바이오는 식별자나 다운로드 URL로 자료를 대신 가져오지 않습니다. 다운로드가 가능하더라도 상업적 계산과 외부 서버 처리가 허용되는지는 별도로 확인하세요.
- 사용할 도구가 받는 형식을 먼저 확인합니다. 전체 데이터베이스보다 이번 작업에 필요한 자료를 준비하세요.
.gz나.zip으로 받았다면 고객 환경에서 압축을 푼 뒤 파일을 선택합니다. 업로드 과정에서 자동으로 압축을 풀거나 형식을 변환하지 않습니다.- 프로젝트의 파일 업로드에서 파일과 형식을 확인합니다. 아래 확장자는 형식 선택을 돕는 표시이며, 파일 내용은 별도로 검사합니다.
- 저장 완료 뒤 형식 검사 결과를 확인하고, 검사된 자료에서 필요한 서열·분자·사슬을 골라 입력을 준비합니다. 원본과 다른 부분을 사용할 때에는 선택 범위를 다시 확인하세요.
| 준비한 자료 | 파일 이름 예 | 처리 시 주의할 점 |
|---|---|---|
| 서열 | .fasta, .fa, .faa, .fna | ID 목록이나 검색 결과 표는 서열 파일이 아닙니다. 분자 종류와 도구별 길이 제한을 확인합니다. |
| 원자 좌표 | .pdb, .cif, .mmcif | 텍스트 구조 파일을 사용합니다. 압축 파일이나 이진 구조 파일을 확장자만 바꿔 넣지 않습니다. |
| 분자 목록 | .sdf, .smi, .smiles | SDF의 분자 구분과 SMILES 표현을 검사합니다. 저장한 목록 전체가 모든 도구의 입력이 되는 것은 아닙니다. |
| 후보 표 | .csv | 문법 검사 뒤 각 도구가 요구하는 열과 값의 조건을 확인합니다. |
| 다중 서열 정렬 | .a3m, 짝지은 정렬용 CSV | 일반 FASTA·후보 CSV와 용도가 다릅니다. 짝지은 정렬용 CSV는 업로드에서 해당 형식을 직접 선택합니다. |
.txt는 기본적으로 일반 텍스트로 분류됩니다. 내용이 FASTA나 SMILES라면 업로드 시작 전 실제 내용에 맞는 형식을 선택하거나, 지원되는 입력 화면에 내용을 붙여 넣으세요. 파일명 변경만으로 내용이 변환되지는 않습니다.
저장 한도와 검사 한도는 다릅니다
파일 저장은 최대 512 MiB, 현재 형식 검사는 파일당 16 MiB까지입니다. 1 MiB는 1,048,576바이트입니다. 저장할 수 있는 큰 파일이라도 검사를 거쳐 계산 입력으로 쓸 수 있다는 뜻은 아닙니다.
16 MiB 이내에서도 FASTA는 최대 10,000개 서열, CSV는 헤더를 포함해 최대 100,000개 레코드, SDF는 최대 5,000개 분자, SMILES 목록은 최대 500개 항목을 검사합니다. 개별 항목 길이와 원자·결합 수 등에도 별도 제한이 있으므로 이 개수 이하라고 항상 통과하지는 않습니다. 실행 도구의 제한은 다시 적용됩니다.
큰 원본에서 일부를 준비할 때는 원천 사이트의 선택 내보내기 기능이나 고객 환경의 형식 지원 도구를 이용하세요. 파일 중간을 임의로 잘라 서열·분자 하나를 끊지 말고, 원본과 선택 범위를 함께 기록하세요. 일반 텍스트·JSON·이진 파일을 저장할 수 있어도 과학 데이터 형식 검사를 지원하는 것은 아닙니다.
서열 입력
FASTA는 >이름 헤더 줄과 서열 줄이 반복되는 텍스트 형식입니다. 파일 하나에 여러 서열을 담을 수 있습니다.
정렬된 서열에는 위치를 맞추기 위한 표시가 들어갑니다. MSA(다중 서열 정렬) 파일에는 -나 . 같은 갭 문자가 들어 있는데, 이 표시는 서열 사이의 대응 관계를 나타내며 실제 아미노산은 아닙니다. 서열 길이가 같다는 사실만으로 정렬된 파일이라고 판단하지 마세요.
표준이 아닌 문자가 들어 있으면 검증 단계에서 위치와 함께 알려드립니다. 고치고 다시 확인하면 됩니다.
구조 파일에서 사슬과 구간 고르기
PDB와 mmCIF는 원자 좌표를 담는 파일 형식입니다. 구조 파일을 넣을 때는 보통 어떤 사슬의 어느 구간을 쓸지를 골라야 합니다. 이때 세 가지를 알아두면 실수가 줄어듭니다.
첫째, 잔기 번호는 배열의 순번이 아닙니다. 구조 파일의 잔기 번호는 원 논문이나 데이터베이스의 번호 체계를 따르며, 1부터 빠짐없이 이어지지 않는 경우가 흔합니다. 100번 다음이 105번일 수 있습니다.
둘째, 번호에 글자가 붙을 수 있습니다. 42와 42A는 다른 잔기입니다. 이 글자를 삽입 코드라고 부르며, 원래 번호 체계를 유지한 채 잔기를 끼워 넣을 때 씁니다.
셋째, 파일에 없는 잔기가 있습니다. 실험에서 관측되지 않은 부분은 좌표가 없어 파일에 나타나지 않습니다. 서열상으로는 존재하지만 구조에는 없는 구간이 생깁니다.
이 셋 때문에 "40번부터 60번까지"가 "배열의 40번째부터 60번째까지"와 다릅니다. 나두바이오는 화면에 보이는 표시 순번을 그대로 모델 입력 위치로 보내지 않습니다. 선택을 저장할 때 원본 파일의 지문, 모델·사슬·잔기 식별자, 그리고 표시와 내부 위치의 대응 관계를 함께 고정하고, 실행 시점에 같은 원본에서 위치를 다시 계산합니다. 원본 파일이 같으면 저장한 선택 범위를 그대로 사용합니다.
저분자 입력
SMILES는 원자와 결합 관계를 한 줄 텍스트로 적는 표기법이고, SDF는 원자·결합·좌표와 속성을 담는 파일 형식입니다.
파일에 분자가 여럿 들어 있으면 임의로 하나를 고르지 않습니다. 어떤 분자를 쓸지 직접 선택해야 합니다. 여러 분자가 든 파일은 목록으로 탐색하며 검색하고 고를 수 있습니다. 고른 결과는 준비 이력으로 남고 나중에 다시 열어 확인할 수 있습니다.
SDF 파일이라고 해서 반드시 올바른 3차원 구조인 것은 아닙니다. 좌표가 비어 있거나 의미 없는 값일 수 있습니다.
파일 검사가 확인하는 것, 확인하지 않는 것
파일을 올리면 다음 항목을 검사합니다.
| 검사가 확인합니다 | 검사가 확인하지 않습니다 |
|---|---|
| 파일 문법이 형식 규칙에 맞는가 | 분자가 화학적으로 타당한가 |
| 레코드가 올바르게 구분되는가 | 이 분자가 어떤 종류인가 |
| 원자·결합 수 같은 수치 합계가 일관된가 | 특정 모델의 입력으로 쓸 수 있는가 |
| 좌표가 유한한 값인가 | 이 도구를 실행할 권한이 있는가 |
검사 통과는 "읽을 수 있는 파일"이라는 뜻이지 "쓸 수 있는 입력"이라는 뜻이 아닙니다. 과학적 타당성은 연구자가 판단하고, 실행 가능 여부는 별도의 단계에서 결정됩니다.
여기에 더해 설정 검증이 있습니다. 검사는 파일 자체를, 검증은 도구에 넘길 설정값을 봅니다. 설정 검증은 무료이며 실행 전에 반복해서 요청할 수 있습니다. 잘못된 값은 어느 항목이 왜 문제인지와 함께 알려드립니다.
원본이 바뀌면 준비도 다시 확인합니다
준비한 입력은 원본 파일의 내용 지문에 묶여 있습니다. 같은 이름으로 다른 파일을 올리면 지문이 달라지므로, 이전에 고른 사슬이나 구간을 그대로 쓰지 않고 다시 확인하도록 안내합니다. 새 파일로 바뀌면서 선택 범위까지 달라지는 일을 막기 위한 절차입니다.
자주 막히는 지점
여러 분자가 든 파일을 넣었는데 진행이 안 됩니다. 어떤 분자를 쓸지 고르지 않아서입니다. 목록에서 선택하세요.
고른 구간이 비어 있다고 나옵니다. 그 구간의 잔기가 파일에 관측되지 않았을 수 있습니다. 구조 뷰어에서 실제로 좌표가 있는 범위를 확인하세요.
서열 길이가 한도를 넘습니다. 도구마다 다루는 최대 길이가 다릅니다. 해당 도구의 참조 문서에서 한도를 확인하고, 필요하면 도메인 단위로 나누는 것을 고려하세요.
파일 저장은 됐는데 검사가 한도를 넘었다고 나옵니다. 저장 한도와 검사 한도가 다릅니다. 압축을 푼 파일의 크기와 위 항목 수 제한을 확인하고, 필요한 자료를 올바른 형식으로 다시 준비하세요.
파일은 검사를 통과했는데 실행이 안 됩니다. 검사와 실행 가능 여부는 별개입니다. 도구가 그 입력 형식을 받는지, 실행 권한이 있는지를 확인하세요.
다음 단계
입력이 준비되면 설정을 정하고 실행 계획을 만듭니다. 계획이 무엇이고 왜 검토를 거치는지는 실행과 승인에서 다룹니다. 계산이 끝난 뒤 값을 읽는 기준은 결과 읽는 법에 있습니다.