# Copyright (c) 2021-2025 The University of Texas Southwestern Medical Center. # All rights reserved. # Redistribution and use in source and binary forms, with or without # modification, are permitted for academic and research use only # (subject to the limitations in the disclaimer below) # provided that the following conditions are met: # * Redistributions of source code must retain the above copyright notice, # this list of conditions and the following disclaimer. # * Redistributions in binary form must reproduce the above copyright # notice, this list of conditions and the following disclaimer in the # documentation and/or other materials provided with the distribution. # * Neither the name of the copyright holders nor the names of its # contributors may be used to endorse or promote products derived from this # software without specific prior written permission. # NO EXPRESS OR IMPLIED LICENSES TO ANY PARTY'S PATENT RIGHTS ARE GRANTED BY # THIS LICENSE. THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND # CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT # LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A # PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR # CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, # EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, # PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR # BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER # IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) # ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE # POSSIBILITY OF SUCH DAMAGE. # Standard library imports # Third party imports import pytest # Local application imports @pytest.mark.hardware @pytest.fixture(autouse=True, scope="class") def open_camera(): from navigate.model.devices.APIs.hamamatsu.HamamatsuAPI import DCAM, camReg # open camera for i in range(10): assert camReg.numCameras == 0 try: camera = DCAM() if camera.get_camera_handler() != 0: break camera.dev_close() camera = None except Exception: continue yield camera if camera is not None: assert camReg.numCameras == 1 camera.dev_close() assert camReg.numCameras == 0 @pytest.mark.hardware class TestHamamatsuAPI: @pytest.fixture(autouse=True) def _prepare_camera(self, open_camera): self.camera = open_camera assert self.camera is not None def test_get_and_set_property_value(self): # set property configuration = { "subarray_mode": 1, "sensor_mode": 12, # 12 for progressive "defect_correct_mode": 2.0, "binning": 1.0, "readout_speed": 1.0, "trigger_active": 1.0, "trigger_mode": 1.0, # external light-sheet mode "trigger_polarity": 2.0, # positive pulse "trigger_source": 3.0, # software "exposure_time": 0.02, "internal_line_interval": 0.000075, } for k in configuration: assert self.camera.set_property_value( k, configuration[k] ), f"can't set property{k} with value{configuration[k]}" def is_in_range(value, target, precision=100): target_min = target - target / precision target_max = target + target / precision return value > target_min and value < target_max # get property for k in configuration: v = self.camera.get_property_value(k) assert is_in_range(v, configuration[k]), f"The value of {k} isn't right!" # set a non-exist property assert ( self.camera.set_property_value("non-exist-property", 100) is False ), "can't handle non-exist property name" def test_ROI(self): import random rects = [(0, 0, 2047, 2047), (512, 512, 1535, 1535), (768, 768, 1279, 1279)] for i in range(10): r = random.randint(0, len(rects) - 1) rect = rects[r] self.camera.set_ROI(*rect) assert self.camera.get_property_value("image_width") == ( rect[2] - rect[0] + 1 ), f"ROI Width: {(rect[2]-rect[0]+1)}" assert self.camera.get_property_value("image_height") == ( rect[3] - rect[1] + 1 ), f"ROI Height: {(rect[3]-rect[1]+1)}" def test_acquisition(self): import random import time from navigate.model.concurrency.concurrency_tools import SharedNDArray configuration = { "sensor_mode": 12, # 12 for progressive "defect_correct_mode": 2.0, "binning": 1.0, "readout_speed": 1.0, "trigger_active": 1.0, "trigger_mode": 1.0, # external light-sheet mode "trigger_polarity": 2.0, # positive pulse "trigger_source": 3.0, # software "exposure_time": 0.02, "internal_line_interval": 0.000075, } for k in configuration: self.camera.set_property_value(k, configuration[k]) number_of_frames = 100 data_buffer = [ SharedNDArray(shape=(2048, 2048), dtype="uint16") for i in range(number_of_frames) ] # attach a buffer without detach a buffer r = self.camera.start_acquisition(data_buffer, number_of_frames) assert r is True, "attach the buffer correctly!" r = self.camera.start_acquisition(data_buffer, number_of_frames) # Confirmed that we can't attach a new buffer before detaching one assert r is False, "attach the buffer correctly!" self.camera.start_acquisition(data_buffer, number_of_frames) readout_time = self.camera.get_property_value("readout_time") for i in range(10): trigger_num = random.randint(0, 30) for j in range(trigger_num): self.camera.fire_software_trigger() time.sleep(configuration["exposure_time"] + readout_time) time.sleep(0.1) frames = self.camera.get_frames() assert len(frames) == trigger_num, "can not get all frames back!" self.camera.stop_acquisition() # detach a detached buffer self.camera.stop_acquisition()