org.micromanager.acqj.util.ImageProcessorBase Maven / Gradle / Ivy

Go to download

Show more of this group Show more artifacts with this name
Show all versions of AcqEngJ Show documentation

Java-based Acquisition engine for Micro-Manager

There is a newer version: 0.38.1

package org.micromanager.acqj.util;


import java.util.concurrent.ExecutorService;
import java.util.concurrent.Executors;
import java.util.concurrent.LinkedBlockingDeque;
import mmcorej.TaggedImage;
import org.micromanager.acqj.api.AcquisitionAPI;
import org.micromanager.acqj.api.TaggedImageProcessor;


/**
 * An abstract class that handles a the threading to implement an image processor
 * that runs asynchronously--i.e. on its own thread that is different from the one
 * that is pulling images from the Core, and different from any subsequent
 * processors/writing images to disk (if applicable)
 *
 * @author henrypinkard
 */
public abstract class ImageProcessorBase implements TaggedImageProcessor {

   private ExecutorService imageProcessorExecutor_;

   AcquisitionAPI acq_;
   volatile LinkedBlockingDeque source_, sink_;

   public ImageProcessorBase () {
      imageProcessorExecutor_ = Executors.newSingleThreadExecutor(
            (Runnable r) -> new Thread(r, "Image processor thread"));
   }

   protected abstract TaggedImage processImage(TaggedImage img);

   @Override
   public void setAcqAndDequeues(AcquisitionAPI acq,
         LinkedBlockingDeque source, LinkedBlockingDeque sink) {
      // This function is called automatically by the acquisition engine on startup.
      // Once it is called and the Dequeus are set, processing can begin
      acq_ = acq;
      source_ = source;
      sink_ = sink;
      imageProcessorExecutor_.submit(new Runnable() {
         @Override
         public void run() {
            while (true) {
               TaggedImage img;
               try {
                     img = source_.takeFirst();
                  if (img.tags == null && img.pix == null) {
                     // time to shut down
                     // propagate shutdown signal forward so that anything downstream also shuts down
                        sink_.putLast(img);

                     imageProcessorExecutor_.shutdown();
                     break;
                  }
               } catch (InterruptedException e) {
                  // This should never happen
                  throw new RuntimeException("Unexpected problem in image processor");
               }

               try {
                  TaggedImage result = processImage(img);
                  if (result != null) {
                     sink_.putLast(result);
                  }
               } catch (Exception e) {
                  // Uncaught exception in image processor
                  acq_.abort(e);
               }
            }

         }
      });
   }



}