imageDatastore
이미지 데이터의 데이터저장소
설명
개별 이미지는 메모리에 맞지만 전체 이미지 모음은 메모리에 맞지 않을 수 있는 이미지 파일 모음을 관리하기 위해 ImageDatastore 객체를 사용합니다. imageDatastore 함수를 사용하여 ImageDatastore 객체를 만들고 그 속성을 지정한 다음, 객체 함수를 사용하여 데이터를 가져오고 처리할 수 있습니다.
생성
설명
imds = imageDatastore(location)location으로 지정된 이미지 데이터 모음에서 imds 데이터저장소를 만듭니다.
imds = imageDatastore(location,Name,Value)imds에 대한 추가 파라미터와 속성을 지정합니다.
입력 인수
이름-값 인수
속성
객체 함수
countEachLabel | ImageDatastore 레이블의 파일 개수 계산 |
hasdata | 데이터를 읽을 수 있는지 확인 |
numpartitions | 데이터저장소 파티션 개수 |
partition | 데이터저장소 파티셔닝 |
preview | 데이터저장소에 있는 데이터의 서브셋 미리보기 |
read | 데이터저장소의 데이터 읽어 들이기 |
readall | 데이터저장소의 모든 데이터 읽기 |
readimage | 데이터저장소에서 지정된 이미지 읽기 |
writeall | Write datastore to files |
reset | 데이터저장소를 초기 상태로 재설정 |
shuffle | 데이터저장소의 모든 데이터 읽기 섞기 |
splitEachLabel | 비율을 기준으로 ImageDatastore 레이블 분할 |
subset | Create subset of datastore or FileSet |
transform | 데이터저장소 변환 |
combine | 여러 데이터저장소의 데이터 결합 |
isPartitionable | Determine whether datastore is partitionable |
isSubsettable | Determine whether datastore is subsettable |
isShuffleable | Determine whether datastore is shuffleable |
예제
MATLAB® 경로와 그 하위 폴더에 있는 모든 .tif 파일과 연결된 ImageDatastore 객체를 만듭니다. 레이블 이름으로 폴더 이름을 사용합니다.
imds = imageDatastore(fullfile(matlabroot,"toolbox","matlab"),... "IncludeSubfolders",true,"FileExtensions",".tif","LabelSource","foldernames")
imds = ImageDatastore with properties:
Files: {
'...\matlab\toolbox\matlab\demos\example.tif';
'...\matlab\toolbox\matlab\matlab_images\tif\corn.tif'
}
Folders: {
'...\matlab\toolbox\matlab'
}
Labels: [demos; imagesci]
AlternateFileSystemRoots: {}
ReadSize: 1
SupportedOutputFormats: ["png" "jpg" "jpeg" "tif" "tiff"]
DefaultOutputFormat: "png"
ReadFcn: @readDatastoreImage
4개의 이미지를 포함하는 FileSet 객체를 만듭니다. ImageDatastore 객체를 생성합니다.
fs = matlab.io.datastore.FileSet(["street1.jpg","street2.jpg","peppers.png","corn.tif"])
fs =
FileSet with properties:
NumFiles: 4
NumFilesRead: 0
FileInfo: Show FileInfo for all 4 files
AlternateFileSystemRoots: {}
imds = imageDatastore(fs)
imds = ImageDatastore with properties:
Files: {
'...\matlab\toolbox\matlab\demos\street1.jpg';
'...\matlab\toolbox\matlab\demos\street2.jpg';
' ...\matlab\toolbox\matlab\imagesci\peppers.png'
... and 1 more
}
Folders: {
'...\matlab\toolbox\matlab\demos';
'...\matlab\toolbox\matlab\imagesci'
}
AlternateFileSystemRoots: {}
ReadSize: 1
Labels: {}
SupportedOutputFormats: ["png" "jpg" "jpeg" "tif" "tiff"]
DefaultOutputFormat: "png"
ReadFcn: @readDatastoreImage
첫 번째 이미지를 미리 봅니다.
imshow(preview(imds));
두 번째 이미지와 세 번째 이미지만 한 번에 하나씩 읽습니다.
for i = 2:3 img = readimage(imds,i); end
네 개의 이미지를 모두 읽고 세 번째 이미지를 봅니다.
imgs = readall(imds);
imshow(imgs{3})
제한 사항
ReadFcn을 사용하여 2차원 이미지를 변환하거나 전처리하는 것은 권장되지 않습니다.
imformats에 의해 인식되는 파일 형식의 경우,ReadFcn을 지정하면imageDatastore의 성능이 느려집니다. 이미지를 변환하고 전처리하는 보다 효율적인 방법은 딥러닝을 위해 영상 전처리하기 (Deep Learning Toolbox) 항목을 참조하십시오.MATLAB은 인증을 요하는 인터넷 URL을 지원하지 않습니다.
MATLAB Online™은 Microsoft® OneDrive™ 파일 및 폴더와 연결된 인터넷 URL을 지원합니다. 반면 설치된 MATLAB에서는 로컬 OneDrive 파일만 지원합니다.
