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');