Main Content

matlab.io.fits.insertBTbl

현재 HDU 다음에 Binary 테이블 삽입

구문

insertBTbl(fptr,nrows,ttype,tform,tunit,extname,pcount)

설명

insertBTbl(fptr,nrows,ttype,tform,tunit,extname,pcount)는 현재 HDU 바로 다음에 새 Binary 테이블 확장을 삽입합니다. 이후의 모든 확장은 새 확장을 위한 공간을 만들기 위해 아래쪽으로 이동됩니다. 이후의 확장이 더 없는 경우 새 테이블 확장은 단순히 파일 끝에 추가됩니다. FITS 파일이 현재 비어 있는 경우 이 루틴은 더미 주 배열(Primary Array)을 만들고 그 끝에 테이블을 추가합니다. 새 확장이 CHDU가 됩니다. 파일에 이후에 나오는 확장이 더 있고 테이블에 가변 길이 배열 열이 있는 경우 pcount는 데이터 힙의 예상되는 최종 크기를 지정해야 합니다. 그렇지 않을 경우 pcount는 0이어야 합니다.

ttype, tform, tunits를 문자형 벡터로 구성된 셀형 배열 또는 string형 배열로 지정합니다.

이 함수는 CFITSIO 라이브러리 C API의 fits_insert_btbl (ffibin) 함수에 대응합니다.

예제

주 배열 다음에 테이블을 만듭니다. 그런 다음 바로 앞에 새 테이블을 삽입합니다.

import matlab.io.*
fptr = fits.createFile('myfile.fits');
ttype = {'Col1','Col2'};
tform = {'9A','1D'};
tunit = {'m/s','candela'};
fits.createTbl(fptr,'binary',10,ttype,tform,tunit,'my-table');
fits.movRelHDU(fptr,-1);
fits.insertBTbl(fptr,5,ttype,tform,tunit,'my-new-table',0);
fits.closeFile(fptr);
fitsdisp('myfile.fits');

참고 항목

|