fitsinfo

FITS 파일에 대한 정보

구문

info = fitsinfo(filename)

설명

info = fitsinfo(filename)은 info 구조체를 반환합니다. 이 구조체의 필드에는 FITS(Flexible Image Transport System) 파일 내용에 대한 정보가 포함됩니다. filename은 FITS 파일의 이름을 지정하는 문자형 벡터 또는 string형 스칼라입니다.

info 구조체는 다음과 같은 필드를 포함합니다(구조체에 표시되는 순서대로 나열됨). 또한 info 구조체는 파일의 여러 선택적 성분(FITS 용어로 확장(Extension))에 대한 정보도 포함할 수 있습니다. 자세한 내용은 FITS 파일 확장 항목을 참조하십시오.

필드 이름	설명	반환 유형
`Filename`	파일의 이름	문자형 벡터
`FileModDate`	파일 수정 날짜	문자형 벡터
`FileSize`	파일의 크기(단위: 바이트)	`double`
`Contents`	파일 내에서 표시되는 순서에 따른 확장(Extension) 목록	문자형 벡터로 구성된 셀형 배열
`PrimaryData`	FITS 파일의 주 데이터(primary data)에 대한 정보	구조체형 배열

PrimaryData

PrimaryData 필드는 파일 내에서의 주 데이터를 설명하는 구조체입니다. 다음 표에는 구조체에 표시되는 순서대로 필드가 나열되어 있습니다.

필드 이름	설명	반환 유형
`DataType`	데이터의 정밀도	문자형 벡터
`Size`	각 차원의 크기로, 행의 개수는 NAXIS2 키워드의 값에 따라, 열의 개수는 NAXIS1 키워드의 값에 따라 결정됩니다. 마찬가지로 추가 차원의 크기는 NAXIS3, NAXIS4 등의 값에 따라 결정됩니다.	`double`형 배열
`DataSize`	주 데이터 크기(바이트)	`double`
`MissingDataValue`	정의되지 않은 데이터를 나타내는 데 사용되는 값	`double`
`Intercept`	다음 방정식을 사용하여 배열 픽셀 값에서 실제 픽셀 값을 계산하기 위해 `Slope`와 함께 사용되는 값 `actual_value = Slope*array_value + Intercept`	`double`
`Slope`	다음 방정식을 사용하여 배열 픽셀 값에서 실제 픽셀 값을 계산하기 위해 `Intercept`와 함께 사용되는 값 `actual_value = Slope*array_value + Intercept`	`double`
`Offset`	파일의 시작 부분에서 첫 번째 데이터 값 위치까지의 바이트 수	`double`
`Keywords`	각 열에 있는 제목의 키워드, 값, 주석을 포함하는 키워드수×3 셀형 배열	문자형 벡터로 구성된 셀형 배열

FITS 파일 확장

FITS 파일은 선택적 확장도 포함할 수 있습니다. 파일에 이러한 확장 중 하나가 포함된 경우 info 구조체는 추가 필드를 포함할 수 있습니다.

AsciiTable — ASCII 문자로 저장되는 테이블 형식의 수치 정보입니다.
BinaryTable — 이진 표현으로 저장되는 테이블 형식의 수치 정보입니다.
Image — 픽셀의 다차원 배열
Unknown — 비표준 확장

AsciiTable 확장

AsciiTable 구조체는 다음과 같은 필드를 포함합니다(구조체에 표시되는 순서대로 나열됨).

필드 이름	설명	반환 유형
`Rows`	테이블에 있는 행의 수	`double`
`RowSize`	각 행의 문자 수	`double`
`NFields`	각 행의 필드 수	`double`형 배열
`FieldFormat`	각 필드가 인코딩되는 형식을 포함한 1×`NFields` 셀입니다. 형식은 FORTRAN-77 형식 코드입니다.	문자형 벡터로 구성된 셀형 배열
`FieldPrecision`	각 필드의 데이터 정밀도를 포함하는 1×`NFields` 셀입니다.	문자형 벡터로 구성된 셀형 배열
`FieldWidth`	각 필드의 문자 수를 포함하는 1×`NFields` 배열	`double`형 배열
`FieldPos`	각 필드의 시작 열을 나타내는 숫자의 1×`NFields` 배열	`double`형 배열
`DataSize`	테이블의 데이터 크기(바이트)	`double`
`MissingDataValue`	각 필드에서 정의되지 않은 데이터를 나타내는 데 사용되는 숫자의 1×`NFields` 배열	문자형 벡터로 구성된 셀형 배열
`Intercept`	다음 방정식을 사용하여 배열 데이터 값에서 실제 데이터 값을 계산하기 위해 `Slope`와 함께 사용되는 숫자의 1×`NFields` 배열 `actual_value = Slope*array_value+Intercept`	`double`형 배열
`Slope`	다음 방정식을 사용하여 배열 데이터 값에서 실제 데이터 값을 계산하기 위해 `Intercept`와 함께 사용되는 숫자의 1×`NFields` 배열 `actual_value = Slope*array_value+Intercept`	`double`형 배열
`Offset`	파일의 시작 부분에서 테이블의 첫 번째 데이터 값 위치까지의 바이트 수	`double`
`Keywords`	ASCII 테이블 제목의 모든 키워드, 값, 주석을 포함하는 키워드수×3 셀형 배열	문자형 벡터로 구성된 셀형 배열

BinaryTable 확장

BinaryTable 구조체는 다음과 같은 필드를 포함합니다(구조체에 표시되는 순서대로 나열됨).

필드 이름	설명	반환 유형
`Rows`	테이블에 있는 행의 수	`double`
`RowSize`	각 행의 바이트 수	`double`
`NFields`	각 행의 필드 수	`double`
`FieldFormat`	각 필드에 있는 데이터의 데이터형을 포함하는 1×`NFields` 셀형 배열 데이터형은 FITS 이진 테이블 형식 코드로 표현됩니다.	문자형 벡터로 구성된 셀형 배열
`FieldPrecision`	각 필드의 데이터 정밀도를 포함하는 1×`NFields` 셀입니다.	문자형 벡터로 구성된 셀형 배열
`FieldSize`	각 요소가 N번째 필드의 값 개수를 포함하는 1×`NFields` 배열	`double`형 배열
`DataSize`	이진 테이블의 데이터 크기(바이트). 메인 테이블을 벗어난 모든 데이터를 포함합니다.	`double`
`MissingDataValue`	각 필드에서 정의되지 않은 데이터를 나타내는 데 사용되는 숫자의 1×`NFields` 배열	`double`형으로 구성된 셀형 배열
`Intercept`	다음 방정식을 사용하여 배열 데이터 값에서 실제 데이터 값을 계산하기 위해 Slope와 함께 사용되는 숫자의 1×`NFields` 배열 `actual_value = slope*array_value+Intercept`	`double`형 배열
`Slope`	다음 방정식을 사용하여 배열 데이터 값에서 실제 데이터 값을 계산하기 위해 Intercept와 함께 사용되는 숫자의 1×`NFields` 배열 `actual_value = Slope*array_value+Intercept`	`double`형 배열
`Offset`	파일의 시작 부분에서 첫 번째 데이터 값 위치까지의 바이트 수	`double`
`ExtensionSize`	메인 테이블을 벗어난 모든 데이터의 크기(바이트)	`double`
`ExtensionOffset`	파일의 시작 부분에서 메인 테이블을 벗어나는 데이터까지의 바이트 수	`double`
`Keywords`	이진 테이블 제목의 모든 키워드, 값, 주석을 포함하는 키워드수×3 셀형 배열	문자형 벡터로 구성된 셀형 배열

Image 확장

Image 구조체는 다음과 같은 필드를 포함합니다(구조체에 표시되는 순서대로 나열됨).

필드 이름	설명	반환 유형
`DataType`	데이터의 정밀도	문자형 벡터
`Size`	각 차원의 크기로, 행의 개수는 NAXIS2 키워드의 값에 따라, 열의 개수는 NAXIS1 키워드의 값에 따라 결정됩니다. 마찬가지로 추가 차원의 크기는 NAXIS3, NAXIS4 등의 값에 따라 결정됩니다.	`double`형 배열
`DataSize`	Image 확장의 데이터 크기(바이트)	`double`
`Offset`	파일의 시작 부분에서 첫 번째 데이터 값까지의 바이트 수	`double`
`MissingDataValue`	정의되지 않은 데이터를 나타내는 데 사용되는 값	`double`
`Intercept`	다음 방정식을 사용하여 배열 픽셀 값에서 실제 픽셀 값을 계산하기 위해 `Slope`와 함께 사용되는 값 `actual_value = Slope*array_value+Intercept`	`double`
`Slope`	다음 방정식을 사용하여 배열 픽셀 값에서 실제 픽셀 값을 계산하기 위해 `Intercept`와 함께 사용되는 값 `actual_value = Slope*array_value + Intercept`	`double`
`Keywords`	이진 테이블 제목의 모든 키워드, 값, 주석을 포함하는 키워드수×3 셀형 배열	문자형 벡터로 구성된 셀형 배열

Unknown 구조체

Unknown 구조체는 다음과 같은 필드를 포함합니다(구조체에 표시되는 순서대로 나열됨).

필드 이름	설명	반환 유형
`DataType`	데이터의 정밀도	문자형 벡터
`Size`	각 차원의 크기	`double`형 배열
`DataSize`	비표준 확장의 데이터 크기(바이트)	`double`
`Offset`	파일의 시작 부분에서 첫 번째 데이터 값까지의 바이트 수	`double`
`MissingDataValue`	정의되지 않은 데이터를 나타냄	`double`
`Intercept`	다음 방정식을 사용하여 배열 데이터 값에서 실제 데이터 값을 계산하기 위해 `Slope`와 함께 사용되는 값 `actual_value = Slope*array_value+Intercept`	`double`
`Slope`	다음 방정식을 사용하여 배열 데이터 값에서 실제 데이터 값을 계산하기 위해 `Intercept`와 함께 사용되는 값 `actual_value = Slope*array_value+Intercept`	`double`
`Keywords`	이진 테이블 제목의 모든 키워드, 값, 주석을 포함하는 키워드수×3 셀형 배열	문자형 벡터로 구성된 셀형 배열

예제

모두 축소

FITS 파일에 대한 정보 가져오기

라이브 스크립트 열기

fitsinfo를 사용하여 FITS 파일 tst0012.fits에 대한 정보를 얻을 수 있습니다. 반환되는 구조체에는 Filename, FileModDate, FileSize, Contents, PrimaryData가 포함됩니다. 주 데이터 외에, 해당 파일에는 BinaryTable, Unknown, Image, AsciiTable 확장의 예도 포함되어 있습니다.

S = fitsinfo('tst0012.fits');

PrimaryData 필드를 확인합니다.

S.PrimaryData

ans = struct with fields:
            DataType: 'single'
                Size: [109 102]
            DataSize: 44472
    MissingDataValue: []
           Intercept: 0
               Slope: 1
              Offset: 2880
            Keywords: {25×3 cell}

PrimaryData 필드는 파일 내 데이터를 설명합니다. 예를 들어, Size 필드는 데이터가 109×102 행렬임을 나타냅니다.

AsciiTable 필드를 확인합니다.

S.AsciiTable

ans = struct with fields:
                Rows: 53
             RowSize: 59
             NFields: 8
         FieldFormat: {'A9'  'F6.2'  'I3'  'E10.4'  'D20.15'  'A5'  'A1'  'I4'}
      FieldPrecision: {'Char'  'Single'  'Integer'  'Single'  'Double'  'Char'  'Char'  'Integer'}
          FieldWidth: [9 6.2000 3 10.4000 20.1500 5 1 4]
            FieldPos: [1 11 18 22 33 54 54 55]
            DataSize: 3127
    MissingDataValue: {'*'  '---.--'  '  *'  []  '*'  '*'  '*'  ''}
           Intercept: [0 0 -70.2000 0 0 0 0 0]
               Slope: [1 1 2.1000 1 1 1 1 1]
              Offset: 103680
            Keywords: {65×3 cell}

AsciiTable 필드는 AsciiTable 확장을 설명합니다. 예를 들어, FieldWidth와 FieldPos 필드를 사용하여 한 행에 있는 각 필드의 길이와 위치를 확인할 수 있습니다.

버전 내역

R2006a 이전에 개발됨

참고 항목

fitsread | fitswrite | fitsdisp

도움말 항목

Importing Flexible Image Transport System (FITS) Files

외부 웹사이트

FITS Support Office at NASA