!-------------------------------------------------------------------------------------------------- !> @author Martin Diehl, KU Leuven !> @brief Read data from image files of the visualization toolkit. !-------------------------------------------------------------------------------------------------- module VTI use prec use zlib use base64 use IO implicit none(type,external) private public :: & VTI_readDataset_int, & VTI_readDataset_real, & VTI_readCellsSizeOrigin contains !-------------------------------------------------------------------------------------------------- !> @brief Read integer dataset from a VTK image data (*.vti) file. !> @details https://vtk.org/Wiki/VTK_XML_Formats !-------------------------------------------------------------------------------------------------- function VTI_readDataset_int(fileContent,label) result(dataset) character(len=*), intent(in) :: & label, & fileContent integer, dimension(:), allocatable :: & dataset character(len=:), allocatable :: dataType, headerType, base64Str logical :: compressed call VTI_readDataset_raw(base64Str,dataType,headerType,compressed, & fileContent,label) dataset = as_Int(base64Str,headerType,compressed,dataType) end function VTI_readDataset_int !-------------------------------------------------------------------------------------------------- !> @brief Read real dataset from a VTK image data (*.vti) file. !> @details https://vtk.org/Wiki/VTK_XML_Formats !-------------------------------------------------------------------------------------------------- function VTI_readDataset_real(fileContent,label) result(dataset) character(len=*), intent(in) :: & label, & fileContent real(pReal), dimension(:), allocatable :: & dataset character(len=:), allocatable :: dataType, headerType, base64Str logical :: compressed call VTI_readDataset_raw(base64Str,dataType,headerType,compressed, & fileContent,label) dataset = as_real(base64Str,headerType,compressed,dataType) end function VTI_readDataset_real !-------------------------------------------------------------------------------------------------- !> @brief Read dataset as raw data (base64 string) from a VTK image data (*.vti) file. !> @details https://vtk.org/Wiki/VTK_XML_Formats !-------------------------------------------------------------------------------------------------- subroutine VTI_readDataset_raw(base64Str,dataType,headerType,compressed, & fileContent,label) character(len=*), intent(in) :: & label, & fileContent character(len=:), allocatable, intent(out) :: dataType, headerType, base64Str logical, intent(out) :: compressed logical :: inFile, inImage integer(pI64) :: & startPos, endPos, & s inFile = .false. inImage = .false. startPos = 1_pI64 outer: do while (startPos < len(fileContent,kind=pI64)) endPos = startPos + index(fileContent(startPos:),IO_EOL,kind=pI64) - 2_pI64 if (endPos < startPos) endPos = len(fileContent,kind=pI64) ! end of file without new line if (.not. inFile) then if (index(fileContent(startPos:endPos),'',kind=pI64) == 0_pI64) if (index(fileContent(startPos:endPos),' @brief Read cells, size, and origin of an VTK image data (*.vti) file. !> @details https://vtk.org/Wiki/VTK_XML_Formats !-------------------------------------------------------------------------------------------------- subroutine VTI_readCellsSizeOrigin(cells,geomSize,origin, & fileContent) integer, dimension(3), intent(out) :: & cells ! # of cells (across all processes!) real(pReal), dimension(3), intent(out) :: & geomSize, & ! size (across all processes!) origin ! origin (across all processes!) character(len=*), intent(in) :: & fileContent character(len=:), allocatable :: headerType logical :: inFile, inImage, compressed integer(pI64) :: & startPos, endPos cells = -1 geomSize = -1.0_pReal inFile = .false. inImage = .false. startPos = 1_pI64 outer: do while (startPos < len(fileContent,kind=pI64)) endPos = startPos + index(fileContent(startPos:),IO_EOL,kind=pI64) - 2_pI64 if (endPos < startPos) endPos = len(fileContent,kind=pI64) ! end of file without new line if (.not. inFile) then if (index(fileContent(startPos:endPos),' @brief Determine size and origin from coordinates. !-------------------------------------------------------------------------------------------------- subroutine cellsSizeOrigin(c,s,o,header) integer, dimension(3), intent(out) :: c real(pReal), dimension(3), intent(out) :: s,o character(len=*), intent(in) :: header character(len=:), allocatable :: temp real(pReal), dimension(3) :: delta integer :: i temp = getXMLValue(header,'Direction') if (temp /= '1 0 0 0 1 0 0 0 1' .and. temp /= '') & ! https://discourse.vtk.org/t/vti-specification/6526 call IO_error(error_ID = 844, ext_msg = 'coordinate order') temp = getXMLValue(header,'WholeExtent') if (any([(IO_intValue(temp,IO_stringPos(temp),i),i=1,5,2)] /= 0)) & call IO_error(error_ID = 844, ext_msg = 'coordinate start') c = [(IO_intValue(temp,IO_stringPos(temp),i),i=2,6,2)] temp = getXMLValue(header,'Spacing') delta = [(IO_floatValue(temp,IO_stringPos(temp),i),i=1,3)] s = delta * real(c,pReal) temp = getXMLValue(header,'Origin') o = [(IO_floatValue(temp,IO_stringPos(temp),i),i=1,3)] end subroutine !-------------------------------------------------------------------------------------------------- !> @brief Interpret Base64 string in vtk XML file as integer of default kind. !-------------------------------------------------------------------------------------------------- function as_Int(base64Str,headerType,compressed,dataType) character(len=*), intent(in) :: base64Str, & ! base64 encoded string headerType, & ! header type (UInt32 or Uint64) dataType ! data type (Int32, Int64, Float32, Float64) logical, intent(in) :: compressed ! indicate whether data is zlib compressed integer, dimension(:), allocatable :: as_Int select case(dataType) case('Int32') as_Int = int(prec_bytesToC_INT32_T(asBytes(base64Str,headerType,compressed))) case('Int64') as_Int = int(prec_bytesToC_INT64_T(asBytes(base64Str,headerType,compressed))) case('Float32') as_Int = int(prec_bytesToC_FLOAT (asBytes(base64Str,headerType,compressed))) case('Float64') as_Int = int(prec_bytesToC_DOUBLE (asBytes(base64Str,headerType,compressed))) case default call IO_error(844,ext_msg='unknown data type: '//trim(dataType)) end select end function as_Int !-------------------------------------------------------------------------------------------------- !> @brief Interpret Base64 string in vtk XML file as real of kind pReal. !-------------------------------------------------------------------------------------------------- function as_real(base64Str,headerType,compressed,dataType) character(len=*), intent(in) :: base64Str, & ! base64 encoded string headerType, & ! header type (UInt32 or Uint64) dataType ! data type (Int32, Int64, Float32, Float64) logical, intent(in) :: compressed ! indicate whether data is zlib compressed real(pReal), dimension(:), allocatable :: as_real select case(dataType) case('Int32') as_real = real(prec_bytesToC_INT32_T(asBytes(base64Str,headerType,compressed)),pReal) case('Int64') as_real = real(prec_bytesToC_INT64_T(asBytes(base64Str,headerType,compressed)),pReal) case('Float32') as_real = real(prec_bytesToC_FLOAT (asBytes(base64Str,headerType,compressed)),pReal) case('Float64') as_real = real(prec_bytesToC_DOUBLE (asBytes(base64Str,headerType,compressed)),pReal) case default call IO_error(844,ext_msg='unknown data type: '//trim(dataType)) end select end function as_real !-------------------------------------------------------------------------------------------------- !> @brief Interpret Base64 string in vtk XML file as bytes. !-------------------------------------------------------------------------------------------------- function asBytes(base64Str,headerType,compressed) result(bytes) character(len=*), intent(in) :: base64Str, & ! base64 encoded string headerType ! header type (UInt32 or Uint64) logical, intent(in) :: compressed ! indicate whether data is zlib compressed integer(C_SIGNED_CHAR), dimension(:), allocatable :: bytes if (compressed) then bytes = asBytes_compressed(base64Str,headerType) else bytes = asBytes_uncompressed(base64Str,headerType) end if end function asBytes !-------------------------------------------------------------------------------------------------- !> @brief Interpret compressed Base64 string in vtk XML file as bytes. !> @details A compressed Base64 string consists of a header block and a data block ! [#blocks/#u-size/#p-size/#c-size-1/#c-size-2/.../#c-size-#blocks][DATA-1/DATA-2...] ! #blocks = Number of blocks ! #u-size = Block size before compression ! #p-size = Size of last partial block (zero if it not needed) ! #c-size-i = Size in bytes of block i after compression !-------------------------------------------------------------------------------------------------- function asBytes_compressed(base64Str,headerType) result(bytes) character(len=*), intent(in) :: base64Str, & ! base64 encoded string headerType ! header type (UInt32 or Uint64) integer(C_SIGNED_CHAR), dimension(:), allocatable :: bytes integer(C_SIGNED_CHAR), dimension(:), allocatable :: bytes_inflated integer(pI64), dimension(:), allocatable :: temp, size_inflated, size_deflated integer(pI64) :: headerLen, nBlock, b,s,e if (headerType == 'UInt32') then temp = int(prec_bytesToC_INT32_T(base64_to_bytes(base64Str(:base64_nChar(4_pI64)))),pI64) nBlock = int(temp(1),pI64) headerLen = 4_pI64 * (3_pI64 + nBlock) temp = int(prec_bytesToC_INT32_T(base64_to_bytes(base64Str(:base64_nChar(headerLen)))),pI64) else if (headerType == 'UInt64') then temp = int(prec_bytesToC_INT64_T(base64_to_bytes(base64Str(:base64_nChar(8_pI64)))),pI64) nBlock = int(temp(1),pI64) headerLen = 8_pI64 * (3_pI64 + nBlock) temp = int(prec_bytesToC_INT64_T(base64_to_bytes(base64Str(:base64_nChar(headerLen)))),pI64) end if allocate(size_inflated(nBlock),source=temp(2)) size_inflated(nBlock) = merge(temp(3),temp(2),temp(3)/=0_pI64) size_deflated = temp(4:) bytes_inflated = base64_to_bytes(base64Str(base64_nChar(headerLen)+1_pI64:)) allocate(bytes(sum(size_inflated))) e = 0_pI64 do b = 1, nBlock s = e + 1_pI64 e = s + size_deflated(b) - 1_pI64 bytes(sum(size_inflated(:b-1))+1_pI64:sum(size_inflated(:b))) = zlib_inflate(bytes_inflated(s:e),size_inflated(b)) end do end function asBytes_compressed !-------------------------------------------------------------------------------------------------- !> @brief Interprete uncompressed Base64 string in vtk XML file as bytes. !> @details An uncompressed Base64 string consists of N headers blocks and a N data blocks ![#bytes-1/DATA-1][#bytes-2/DATA-2]... !-------------------------------------------------------------------------------------------------- function asBytes_uncompressed(base64Str,headerType) result(bytes) character(len=*), intent(in) :: base64Str, & ! base64 encoded string headerType ! header type (UInt32 or Uint64) integer(C_SIGNED_CHAR), dimension(:), allocatable :: bytes integer(pI64) :: s integer(pI64), dimension(1) :: nByte allocate(bytes(0)) s=0_pI64 if (headerType == 'UInt32') then do while(s+base64_nChar(4_pI64)<(len(base64Str,pI64))) nByte = int(prec_bytesToC_INT32_T(base64_to_bytes(base64Str(s+1_pI64:s+base64_nChar(4_pI64)))),pI64) bytes = [bytes,base64_to_bytes(base64Str(s+1_pI64:s+base64_nChar(4_pI64+nByte(1))),5_pI64)] s = s + base64_nChar(4_pI64+nByte(1)) end do else if (headerType == 'UInt64') then do while(s+base64_nChar(8_pI64)<(len(base64Str,pI64))) nByte = int(prec_bytesToC_INT64_T(base64_to_bytes(base64Str(s+1_pI64:s+base64_nChar(8_pI64)))),pI64) bytes = [bytes,base64_to_bytes(base64Str(s+1_pI64:s+base64_nChar(8_pI64+nByte(1))),9_pI64)] s = s + base64_nChar(8_pI64+nByte(1)) end do end if end function asBytes_uncompressed !-------------------------------------------------------------------------------------------------- !> @brief Get XML string value for given key. !-------------------------------------------------------------------------------------------------- pure function getXMLValue(line,key) character(len=*), intent(in) :: line, key character(len=:), allocatable :: getXMLValue integer :: s,e #ifdef __INTEL_COMPILER character :: q #endif s = index(line," "//key,back=.true.) if (s==0) then getXMLValue = '' else e = s + 1 + scan(line(s+1:),"'"//'"') if (scan(line(s:e-2),'=') == 0) then getXMLValue = '' else s = e !https://community.intel.com/t5/Intel-Fortran-Compiler/ICE-for-merge-with-strings/m-p/1207204#M151657 #ifdef __INTEL_COMPILER q = line(s-1:s-1) e = s + index(line(s:),q) - 1 #else e = s + index(line(s:),merge("'",'"',line(s-1:s-1)=="'")) - 1 #endif getXMLValue = line(s:e-1) end if end if end function !-------------------------------------------------------------------------------------------------- !> @brief Check for supported file format variants. !-------------------------------------------------------------------------------------------------- pure function fileFormatOk(line) character(len=*),intent(in) :: line logical :: fileFormatOk fileFormatOk = getXMLValue(line,'type') == 'ImageData' .and. & getXMLValue(line,'byte_order') == 'LittleEndian' .and. & getXMLValue(line,'compressor') /= 'vtkLZ4DataCompressor' .and. & getXMLValue(line,'compressor') /= 'vtkLZMADataCompressor' end function fileFormatOk end module VTI