PyLibTiff is a package that provides:
-
a pure Python module for reading and writing TIFF and LSM files. The images are read as
numpy.memmapobjects so that it is possible to open images that otherwise would not fit to computers RAM. Both TIFF strips and tiles are supported for low-level data storage.
There exists many Python packages such as PIL, FreeImagePy that support reading and writing TIFF files. The PyLibTiff project was started to have an efficient and direct way to read and write TIFF files using the libtiff library without the need to install any unnecessary packages or libraries. The pure Python module was created for reading "broken" TIFF files such as LSM files that in some places use different interpretation of TIFF tags than what specified in the TIFF specification document. The libtiff library would just fail reading such files. In addition, the pure Python module is more memory efficient as the arrays are returned as memory maps. Support for compressed files is not implemented yet.
tifffile.py by Christoph Gohlke is an excellent module for reading TIFF as well as LSM files, it is as fast as libtiff.py by using numpy.
Usage example (libtiff wrapper)
>>> from libtiff import TIFF
>>> # to open a tiff file for reading:
>>> tif = TIFF.open('filename.tif', mode='r')
>>> # to read an image in the currect TIFF directory and return it as numpy array:
>>> image = tif.read_image()
>>> # to read all images in a TIFF file:
>>> for image in tif.iter_images(): # do stuff with image
>>> # to open a tiff file for writing:
>>> tif = TIFF.open('filename.tif', mode='w')
>>> # to write a image to tiff file
>>> tif.write_image(image)
Usage example (pure Python module)
>>> from libtiff import TIFFfile, TIFFimage
>>> # to open a tiff file for reading
>>> tif = TIFFfile('filename.tif')
>>> # to return memmaps of images and sample names (eg channel names, SamplesPerPixel>=1)
>>> samples, sample_names = tiff.get_samples()
>>> # to create a tiff structure from image data
>>> tiff = TIFFimage(data, description='')
>>> # to write tiff structure to file
>>> tiff.write_file('filename.tif', compression='none') # or 'lzw'
>>> del tiff # flushes data to disk
Script usage examples
$ libtiff.info -i result_0.tif --no-gui
IFDEntry(tag=ImageWidth, value=512, count=1, offset=None)
IFDEntry(tag=ImageLength, value=512, count=1, offset=None)
IFDEntry(tag=BitsPerSample, value=32, count=1, offset=None)
IFDEntry(tag=Compression, value=1, count=1, offset=None)
IFDEntry(tag=PhotometricInterpretation, value=1, count=1, offset=None)
IFDEntry(tag=StripOffsets, value=8, count=1, offset=None)
IFDEntry(tag=Orientation, value=6, count=1, offset=None)
IFDEntry(tag=StripByteCounts, value=1048576, count=1, offset=None)
IFDEntry(tag=PlanarConfiguration, value=1, count=1, offset=None)
IFDEntry(tag=SampleFormat, value=3, count=1, offset=None)
Use --ifd to see the rest of 31 IFD entries
data is contiguous: False
memory usage is ok: True
sample data shapes and names:
width : 512
length : 512
samples_per_pixel : 1
planar_config : 1
bits_per_sample : 32
strip_length : 1048576
[('memmap', (32, 512, 512), dtype('float32'))] ['sample0']
$ libtiff.info --no-gui -i psf_1024_z5_airy1_set1.lsm
IFDEntry(tag=NewSubfileType, value=0, count=1, offset=None)
IFDEntry(tag=ImageWidth, value=1024, count=1, offset=None)
IFDEntry(tag=ImageLength, value=1024, count=1, offset=None)
IFDEntry(tag=BitsPerSample, value=8, count=1, offset=None)
IFDEntry(tag=Compression, value=1, count=1, offset=None)
IFDEntry(tag=PhotometricInterpretation, value=1, count=1, offset=None)
IFDEntry(tag=StripOffsets, value=97770, count=1, offset=None)
IFDEntry(tag=SamplesPerPixel, value=1, count=1, offset=None)
IFDEntry(tag=StripByteCounts, value=1048576, count=1, offset=None)
IFDEntry(tag=PlanarConfiguration, value=2, count=1, offset=None)
IFDEntry(tag=CZ_LSMInfo, value=CZ_LSMInfo276(
MagicNumber=[67127628],
StructureSize=[500],
DimensionX=[1024],
DimensionY=[1024],
DimensionZ=[20],
DimensionChannels=[1],
DimensionTime=[1],
SDataType=[1],
ThumbnailX=[128],
ThumbnailY=[128],
VoxelSizeX=[ 2.79017865e-08],
VoxelSizeY=[ 2.79017865e-08],
VoxelSizeZ=[ 3.60105263e-07],
OriginX=[ -2.22222228e-07],
OriginY=[ 1.90476196e-07],
OriginZ=[ 0.],
ScanType=[0],
SpectralScan=[0],
DataType=[0],
OffsetVectorOverlay->DrawingElement(name='OffsetVectorOverlay', size=200, offset=6560),
OffsetInputLut->LookupTable(name='OffsetInputLut', size=8388, subblocks=6, channels=1, offset=7560),
OffsetOutputLut->LookupTable(name='OffsetOutputLut', size=24836, subblocks=3, channels=3, offset=15948),
OffsetChannelColors->ChannelColors (names=['Ch3'], colors=[(255, 0, 0, 0)]),
TimeInterval=[ 0.],
OffsetChannelDataTypes->None,
OffsetScanInformation->recording[size=3535]
name = 'psf_1024_z5_airy1_set1'
description = ' '
notes = ' '
objective = 'C-Apochromat 63x/1.20 W Korr UV-VIS-IR M27'
special scan mode = 'FocusStep'
scan type = ''
scan mode = 'Stack'
number of stacks = 10
lines per plane = 1024
samples per line = 1024
planes per volume = 20
images width = 1024
images height = 1024
images number planes = 20
images number stacks = 1
images number channels = 1
linescan xy size = 512
scan direction = 0
scan directionz = 0
time series = 0
original scan data = 1
zoom x = 5.0000000000000009
zoom y = 5.0000000000000009
zoom z = 1.0
sample 0x = -0.22200000000000006
sample 0y = 0.19000000000000006
sample 0z = 6.8420000000000014
sample spacing = 0.028000000000000008
line spacing = 0.028000000000000008
plane spacing = 0.3600000000000001
rotation = 0.0
nutation = 0.0
precession = 0.0
sample 0time = 39583.598368055624
start scan trigger in = ''
start scan trigger out = ''
start scan event = 0
start scan time = 0.0
stop scan trigger in = ''
stop scan trigger out = ''
stop scan event = 0
start scan time = 0.0
use rois = 0
use reduced memory rois = 0
user = 'User Name'
usebccorrection = 0
positionbccorrection1 = 0.0
positionbccorrection2 = 0.0
interpolationy = 1
camera binning = 1
camera supersampling = 0
camera frame width = 1388
camera frame height = 1040
camera offsetx = 0.0
camera offsety = 0.0
rt binning = 1
ENTRY0x10000064L = 1
rt frame width = 512
rt frame height = 512
rt region width = 512
rt region height = 512
rt offsetx = 0.0
rt offsety = 0.0
rt zoom = 1.0000000000000004
rt lineperiod = 112.43300000000002
prescan = 0
lasers[size=188]
laser[size=80]
name = 'HeNe633'
acquire = 1
power = 5.0000000000000009
end laser
laser[size=84]
name = 'DPSS 532-75'
acquire = 1
power = 75.000000000000014
end laser
end lasers
tracks[size=2071]
track[size=2047]
pixel time = 1.5980000000000003
time between stacks = 1.0
multiplex type = 1
multiplex order = 1
sampling mode = 2
sampling method = 1
sampling number = 8
acquire = 1
name = 'Track'
collimator1 position = 16
collimator1 name = 'IR/Vis'
collimator2 position = 66
collimator2 name = 'UV/Vis'
is bleach track = 0
is bleach after scan number = 0
bleach scan number = 0
trigger in = ''
trigger out = ''
is ratio track = 0
bleach count = 0
spi center wavelength = 582.53000000000009
id condensor aperture = 'KAB1'
condensor aperture = 0.55000000000000016
id condensor revolver = 'FW2'
condensor filter = 'HF'
id tubelens = 'Tubelens'
id tubelens position = 'Lens LSM'
transmitted light = 0.0
reflected light = -1.0000000000000002
detection channels[size=695]
detection channel[size=671]
detector gain first = 700.00000000000011
detector gain last = 700.00000000000011
amplifier gain first = 1.0000000000000002
amplifier gain last = 1.0000000000000002
amplifier offs first = 0.10000000000000002
amplifier offs last = 0.10000000000000002
pinhole diameter = 144.00000000000003
counting trigger = 5.0
acquire = 1
integration mode = 0
special mode = 0
detector name = 'Pmt3'
amplifier name = 'Amplifier1'
pinhole name = 'PH3'
filter set name = 'EF3'
filter name = 'LP 650'
ENTRY0x70000011L = ''
ENTRY0x70000012L = ''
integrator name = 'Integrator3'
detection channel name = 'Ch3'
detector gain bc1 = 0.0
detector gain bc2 = 0.0
amplifier gain bc1 = 0.0
amplifier gain bc2 = 0.0
amplifier offs bc1 = 0.0
amplifier offs bc2 = 0.0
spectral scan channels = 32
spi wavelength start = 415.0
spi wavelength end = 735.0
ENTRY0x70000024L = 575.0
ENTRY0x70000025L = 575.0
dye name = ''
dye folder = ''
ENTRY0x70000028L = 1.0000000000000004
ENTRY0x70000029L = 0.0
end detection channel
end detection channels
beam splitters[size=330]
beam splitter[size=82]
filter set = 'HT'
filter = 'HFT 405/514/633'
name = 'HT'
end beam splitter
beam splitter[size=75]
filter set = 'NT1'
filter = 'Mirror'
name = 'NT1'
end beam splitter
beam splitter[size=76]
filter set = 'NT2'
filter = 'NFT 565'
name = 'NT2'
end beam splitter
beam splitter[size=73]
filter set = 'FW1'
filter = 'None'
name = 'FW1'
end beam splitter
end beam splitters
illumination channels[size=160]
illumination channel[size=136]
name = '633'
power = 0.30000000000000004
wavelength = 633.0
aquire = 1
power bc1 = 0.0
power bc2 = 0.0
end illumination channel
end illumination channels
data channels[size=338]
data channel[size=314]
name = 'Ch3'
acquire = 1
acquire = 0
color = 255
sampletype = 1
bitspersample = 8
ratio type = 0
ratio track1 = 0
ratio track2 = 0
ratio channel1 = ''
ratio channel2 = ''
ratio const1 = 0.0
ratio const2 = 0.0
ratio const3 = 1.0
ratio const4 = 0.0
ratio const5 = 0.0
ratio const6 = 0.0
end data channel
end data channels
end track
end tracks
timers[size=24]
end timers
markers[size=24]
end markers
end recording,
OffsetKsData->OffsetData(name='OffsetKsData', size=8, offset=48590),
OffsetTimeStamps->TimeStamps(stamps=[ 2335.75582836]),
OffsetEventList->EventList(events=[]),
OffsetRoi->DrawingElement(name='OffsetRoi', size=200, offset=6160),
OffsetBleachRoi->DrawingElement(name='OffsetBleachRoi', size=200, offset=6360),
OffsetNextRecording->None,
DisplayAspectX=[ 1.],
DisplayAspectY=[ 1.],
DisplayAspectZ=[ 1.],
DisplayAspectTime=[ 1.],
OffsetMeanOfRoisOverlay->DrawingElement(name='OffsetMeanOfRoisOverlay', size=200, offset=6760),
OffsetTopoIsolineOverlay->DrawingElement(name='OffsetTopoIsolineOverlay', size=200, offset=7160),
OffsetTopoProfileOverlay->DrawingElement(name='OffsetTopoProfileOverlay', size=200, offset=7360),
OffsetLinescanOverlay->DrawingElement(name='OffsetLinescanOverlay', size=200, offset=6960),
ToolbarFlags=[0],
OffsetChannelWavelength->ChannelWavelength (ranges=[(-1.0, -1.0)]),
OffsetChannelFactors->ChannelFactors(size=36, offset=40836),
ObjectiveSphereCorrection=[ 0.],
OffsetUnmixParameters->OffsetData(name='OffsetUnmixParameters', size=124, offset=48466),
Reserved=[[40896 44726 0 0 0 0 0 0 0 0 0 0
0 0 0 0 0 0 0 0 0 0 0 0
0 0 0 0 0 0 0 0 0 0 0 0
0 0 0 0 0 0 0 0 0 0 0 0
0 0 0 0 0 0 0 0 0 0 0 0
0 0 0 0 0 0 0 0 0]]))
Use --ifd to see the rest of 39 IFD entries
data is contiguous: False
memory usage is ok: True
sample data shapes and names:
width : 1024
length : 1024
samples_per_pixel : 1
planar_config : 2
bits_per_sample : 8
strip_length : 1048576
[('memmap', (20, 1024, 1024), dtype('uint8'))] ['Ch3']
[((20, 128, 128), dtype('uint8')), ((20, 128, 128), dtype('uint8')), ((20, 128, 128), dtype('uint8'))] ['red', 'green', 'blue']
4 Jan 11, 2022
104 Dec 30, 2022
1 Jan 13, 2022
1 Nov 01, 2021
5 Aug 20, 2021
7.1k Jan 03, 2023
2 Nov 04, 2021
18 Apr 04, 2022
5.5k Jan 03, 2023
25 Aug 05, 2022
2 Aug 04, 2022
3 Mar 24, 2022
3 May 31, 2022
12 Oct 05, 2022
3 Sep 26, 2022
15 Dec 28, 2022
4 Nov 14, 2022
19 Aug 21, 2022
43 Dec 03, 2022
1 Dec 16, 2022