Metadata-Version: 2.1
Name: pymodaq-plugins-mockexamples
Version: 0.2.1
Summary: Set of advanced Mock examples to test PyMoDAQ functionnalities
Home-page: https://github.com/PyMoDAQ/pymodaq_plugins_mockexamples
Author: Sebastien J. Weber
Author-email: sebastien.weber@cnrs.fr
License: MIT
Classifier: Programming Language :: Python :: 3
Classifier: Development Status :: 5 - Production/Stable
Classifier: Environment :: Other Environment
Classifier: Intended Audience :: Science/Research
Classifier: Topic :: Scientific/Engineering :: Human Machine Interfaces
Classifier: Topic :: Scientific/Engineering :: Visualization
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: Software Development :: User Interfaces
License-File: LICENSE

pymodaq_plugins_mockexamples
############################

.. the following must be adapted to your developed package, links to pypi, github  description...

.. image:: https://img.shields.io/pypi/v/pymodaq_plugins_mockexamples.svg
   :target: https://pypi.org/project/pymodaq_plugins_mockexamples/
   :alt: Latest Version

.. image:: https://readthedocs.org/projects/pymodaq/badge/?version=latest
   :target: https://pymodaq.readthedocs.io/en/stable/?badge=latest
   :alt: Documentation Status

.. image:: https://github.com/PyMoDAQ/pymodaq_plugins_mockexamples/workflows/Upload%20Python%20Package/badge.svg
   :target: https://github.com/PyMoDAQ/pymodaq_plugins_mockexamples
   :alt: Publication Status

.. image:: https://github.com/PyMoDAQ/pymodaq_plugins_mockexamples/actions/workflows/Test.yml/badge.svg
    :target: https://github.com/PyMoDAQ/pymodaq_plugins_mockexamples/actions/workflows/Test.yml


This PyMoDAQ plugin adds various Mock instruments to test PyMoDAQ functionalities

Authors
=======

* Sebastien J. Weber  (sebastien.weber@cnrs.fr)


Instruments
===========

Below is the list of instruments included in this plugin

Actuators
+++++++++

* **MockCamera**: set of X, Y or theta actuators moving a light image on the corresponding camera instrument
  For this to work, MockCamera actuators and detector should share the same control ID with the preset scan
* **MockNamedAxes**: Show examples of multi axis actuator controller specifying both a name and an integer ID
* **MockRandom** actuator to be used with the corresponding 0D detector. If they share the same ID in the preset then
  this actuator can be moved in the [0-20] range (even randomly) to retrieve a noisy gaussian
* **MockTauMulti**: controller with multiple axes and showing how to add a characteristic time (to mimic real
  instruments)

Viewer0D
++++++++

* **MockAdaptive**: to be used to show how a detector can be used for adaptive samplking (not working yet with PyMoDAQ4)
* **MockRandom**: generate a value of a noisy gaussian given the current value of the underlying mock controller.
  To be used with the MockRandom actuator. If they share the same ID in the preset then this actuator can be moved in
  the [0-20] range (even randomly) to retrieve a noisy gaussian

Viewer1D
++++++++

* **MockSpectro**: mimic data one coulf obtain from a spectrometer. Specific methods are also added to seemlessly use
  this detector with the Spectrometer extension (not yet working with PyMoDAQ4)
* **MockRandom**: Generate a noisy Gaussian with a spread axis (to illustrate the sorting button action of the Viewer1D
  data viewer


Viewer2D
++++++++

* **MockCamera**: if connected with a preset with the MockCamera actuator (or a few of them, X, Y and thera), then the
  image displayed on screen is moved or rotated accordingly to the actuators value. Perfect for a beamsteering example
* **RoiStuff**: example of ROI exporting into the instrument plugin. Not yet working, planned to be ok for the future
  >= 4.2.* releases.


ViewerND
++++++++

* **MockEvents**: Simulate the acquisition of photons received on a timepix camera (position and time of arrival of each photon)


PID Models
==========


Extensions
==========


Installation instructions
=========================

* PyMoDAQ >= 4 (except for some of them, specified in this README)
* nothing in particular to be installed, they are all virtual instruments
