연구 교환을 위한 공개 형식

공유 기여 표준과 함께 이 지침을 사용하세요. 공동작업자가 일반적으로 사용 가능한 도구를 사용하여 검사, 교환 및 재사용할 수 있는 형식을 사용하세요. 아래 기본값으로 시작하고 내보내기가 과학적 의미나 편집 가능성을 잃을 경우 기본 소스를 유지하세요.

소재 실질적인 기본값
참고 사항, 프로토콜 및 문서 UTF-8 마크다운; 고정된 읽기 사본이 유용할 때 PDF를 내보냅니다.
작은 테이블 데이터 사전 또는 스키마가 포함된 UTF-8 CSV입니다.
더 큰 유형의 테이블 사전과 리더/라이브러리 버전이 포함된 쪽모이 세공 마루; 유용할 경우 작은 CSV 예제를 제공하세요.
구조화된 기록 및 교환 JSON; 한 줄에 하나의 레코드에 대한 JSONL입니다. 필드에 유효성 검사가 필요할 때 스키마를 포함하세요.
사람이 편집한 구성 YAML 또는 JSON(지원되는 버전 및 예시 포함)
참고자료 DOI 또는 기타 안정적인 식별자를 유지하는 BibTeX, RIS 또는 CSL JSON.
그림 및 다이어그램 적절한 경우 편집 가능한 소스 및 SVG; 래스터 이미지의 경우 PNG, 고정 출판 사본의 경우 PDF입니다.

CSV만으로는 필드 유형을 보존하거나 값의 의미를 설명하지 않습니다. 열 정의, 유형, 단위, 결측값 코드, 날짜 형식 및 시간대, 식별자, 테이블 간의 관계를 기록합니다. 앞에 0이 붙은 식별자를 문자열로 유지합니다. 간단한 테이블에는 짧은 사전이면 충분합니다. W3C CSV 메타데이터 기계 판독 가능 옵션을 제공합니다. 쪽모이 세공 마루 입력된 필드를 유지하지만 여전히 해당 의미와 출처에 대한 설명이 필요합니다.

일반 테이블보다 연구 내용을 더 잘 보존하려면 도메인 형식을 사용하세요. 예로는 적합한 생물학적 모델을 위한 SBML 또는 CellML과 지원되는 모델 교환 또는 co-simulation를 위한 FMI가 있습니다. NetCDF 또는 HDF5는 적합한 과학적 배열을 지원할 수 있으며 STEP은 CAD 교환을 지원할 수 있습니다. 해석하거나 재실행하는 데 필요한 기본 모델, 솔버 입력, 좌표계, 단위, 종속성 및 형식 버전을 유지합니다. 소스와 동등한 것으로 취급하기 전에 수신 도구에서 교환 내보내기를 확인하십시오.

소스와 기록을 유지하세요#

사본을 읽는 것 외에 편집 가능한 소스를 유지하거나 버전이 지정된 매니페스트를 통해 링크하세요. 소스 버전, 변환 스크립트 또는 내보내기 설정, 소프트웨어 버전 및 손실된 정보를 기록합니다. 스프레드시트는 편집 가능한 작업 소스로 남아 있을 수 있습니다. 교환 테이블을 내보내고 이를 재현하는 데 필요한 공식과 변환을 유지합니다. 일반적으로 PDF나 스크린샷만으로는 재사용 가능한 데이터나 모델이 충분하지 않습니다.

Git에 작고 공유 가능한 소스, 스키마, 스크립트, 메타데이터를 보관하세요. 대형 유물과 제한된 자료를 적절한 외부 저장소에 보관하십시오. 아티팩트 ID, 버전, 위치, 적절한 경우 체크섬, 출처, 액세스 조건 및 재생성 지침이 포함된 공유 가능한 매니페스트를 추적합니다. 필요한 경우 통제된 기록에 기밀 경로와 메타데이터를 보관하세요.

오픈 포맷은 콘텐츠를 오픈 데이터로 만들지 않습니다. 라이선스 또는 액세스 조건을 별도로 명시하고, 속성을 유지하고, 공유할 수 있는 내용을 확인하세요. 사용 자원 요청 프로세스 액세스에 관리자가 필요한 경우. 이러한 기본값은 기여 기준; 프로젝트는 해당 방법에 대해 더 나은 형식을 문서화할 수 있습니다.

GitHub에서 소스 보기