Skip to content

Commit

Permalink
Merge pull request #84 from LaboratoireMecaniqueLille/hotfix/2.0.1
Browse files Browse the repository at this point in the history
Hotfixing version 2.0.0
  • Loading branch information
WeisLeDocto authored Dec 3, 2023
2 parents d1d7f5e + f7d61aa commit 416dcac
Show file tree
Hide file tree
Showing 10 changed files with 84 additions and 75 deletions.
4 changes: 2 additions & 2 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,8 +3,8 @@ Command and Real-time Acquisition in Parallelized PYthon (CRAPPY)

[![Downloads](https://pepy.tech/badge/crappy)](https://pepy.tech/project/crappy)
[![Documentation Status](https://readthedocs.org/projects/crappy/badge/?version=latest)](https://crappy.readthedocs.io/en/latest/?badge=latest)
[![PyPi version](https://badgen.net/pypi/v/crappy/)](https://pypi.org/project/crappy)
[![Python version](https://img.shields.io/pypi/pyversions/crappy.svg)](https://pypi.python.org/pypi/crappy/)
[![PyPi version](https://badgen.net/pypi/v/crappy/)](https://pypi.org/project/crappy/)
[![Python version](https://img.shields.io/pypi/pyversions/crappy.svg)](https://pypi.org/project/crappy/)

CRAPPY aims to provide a free and open-source software canvas for driving
experimental setups in a versatile and accessible way.
Expand Down
2 changes: 1 addition & 1 deletion docs/source/conf.py
Original file line number Diff line number Diff line change
Expand Up @@ -16,7 +16,7 @@
from time import gmtime, strftime
from re import match

__version__ = '2.0.0'
__version__ = '2.0.1'

# -- Project information -----------------------------------------------------

Expand Down
106 changes: 53 additions & 53 deletions docs/source/features.rst
Original file line number Diff line number Diff line change
Expand Up @@ -7,9 +7,9 @@ exposed to the users. Information on how to use them can be found in the
:ref:`Tutorials`, as well as guidelines for creating your own objects. For most
Blocks, one or several directly runnable example scripts are available
in the `examples folder <https://github.com/LaboratoireMecaniqueLille/crappy/
examples>`_ of the GitHub repository. For each object listed on this page, you
can click on its name to open the complete documentation given in the
:ref:`API`.
tree/master/examples>`_ of the GitHub repository. For each object listed on
this page, you can click on its name to open the complete documentation given
in the :ref:`API`.

Functionalities (Blocks)
------------------------
Expand All @@ -28,8 +28,8 @@ Data display
real-time temperature map.

The examples folder on GitHub contains `one example of the Canvas Block
<https://github.com/LaboratoireMecaniqueLille/crappy/examples/blocks/
canvas.py>`_.
<https://github.com/LaboratoireMecaniqueLille/crappy/blob/master/examples/
blocks/canvas.py>`_.

- :ref:`Dashboard`

Expand All @@ -38,8 +38,8 @@ Data display
displayed for each label.

The examples folder on GitHub contains `one example of the Dashboard Block
<https://github.com/LaboratoireMecaniqueLille/crappy/examples/blocks/
dashboard.py>`_.
<https://github.com/LaboratoireMecaniqueLille/crappy/blob/master/examples/
blocks/dashboard.py>`_.

- :ref:`Grapher`

Expand All @@ -61,8 +61,8 @@ Data display
Prints the values it receives in the terminal. Mostly useful for debugging.

The examples folder on GitHub contains `one example of the Link Reader Block
<https://github.com/LaboratoireMecaniqueLille/crappy/examples/blocks/
link_reader.py>`_.
<https://github.com/LaboratoireMecaniqueLille/crappy/blob/master/examples/
blocks/link_reader.py>`_.

Data recording
++++++++++++++
Expand All @@ -74,8 +74,8 @@ Data recording
recording any other type of data.

The examples folder on GitHub contains `one example of the HDF Recorder Block
<https://github.com/LaboratoireMecaniqueLille/crappy/examples/blocks/
hdf5_recorder.py>`_.
<https://github.com/LaboratoireMecaniqueLille/crappy/blob/master/examples/
blocks/hdf5_recorder.py>`_.

- :ref:`Recorder`

Expand All @@ -85,8 +85,8 @@ Data recording
instead in this situation.

The examples folder on GitHub contains `one example of the Recorder Block
<https://github.com/LaboratoireMecaniqueLille/crappy/examples/blocks/
recorder.py>`_.
<https://github.com/LaboratoireMecaniqueLille/crappy/blob/master/examples/
blocks/recorder.py>`_.

:ref:`A tutorial section <2.d. The Recorder Block>` is also dedicated to the
Recorder Block.
Expand All @@ -102,8 +102,8 @@ Data processing
computationally-intensive :ref:`Multiplexer`.

The examples folder on GitHub contains `one example of the Mean Block
<https://github.com/LaboratoireMecaniqueLille/crappy/examples/blocks/
mean.py>`_.
<https://github.com/LaboratoireMecaniqueLille/crappy/blob/master/examples/
blocks/mean.py>`_.

- :ref:`Multiplexer`

Expand All @@ -114,8 +114,8 @@ Data processing
post-processing.

The examples folder on GitHub contains `one example of the Multiplexer Block
<https://github.com/LaboratoireMecaniqueLille/crappy/examples/blocks/
multiplexer.py>`_.
<https://github.com/LaboratoireMecaniqueLille/crappy/blob/master/examples/
blocks/multiplexer.py>`_.

Real-time image correlation
+++++++++++++++++++++++++++
Expand All @@ -129,8 +129,8 @@ Real-time image correlation
sent to downstream Blocks.

The examples folder on GitHub contains `several examples of the DIS Correl
Block <https://github.com/LaboratoireMecaniqueLille/crappy/examples/blocks/
dis_correl>`_.
Block <https://github.com/LaboratoireMecaniqueLille/crappy/tree/master/
examples/blocks/dis_correl>`_.

- :ref:`GPU Correl`

Expand Down Expand Up @@ -158,8 +158,8 @@ Video-extensometry
Block as its input.

The examples folder on GitHub contains `one example of the Auto Drive Block
<https://github.com/LaboratoireMecaniqueLille/crappy/examples/blocks/
auto_drive_video_extenso.py>`_.
<https://github.com/LaboratoireMecaniqueLille/crappy/blob/master/examples/
blocks/auto_drive_video_extenso.py>`_.

- :ref:`DIC VE`

Expand All @@ -172,8 +172,8 @@ Video-extensometry
patch playing the same role as a dot.

The examples folder on GitHub contains `several examples of the DIC VE Block
<https://github.com/LaboratoireMecaniqueLille/crappy/examples/blocks/
dic_ve>`_.
<https://github.com/LaboratoireMecaniqueLille/crappy/tree/master/examples/
blocks/dic_ve>`_.

- :ref:`GPU VE`

Expand All @@ -200,8 +200,8 @@ Video-extensometry
areas.

The examples folder on GitHub contains `one example of the Video Extenso
Block <https://github.com/LaboratoireMecaniqueLille/crappy/examples/blocks/
video_extenso.py>`_.
Block <https://github.com/LaboratoireMecaniqueLille/crappy/blob/master/
examples/blocks/video_extenso.py>`_.

Signal generation
+++++++++++++++++
Expand All @@ -213,8 +213,8 @@ Signal generation
Useful for triggering a behavior at a user-chosen moment during a test.

The examples folder on GitHub contains `one example of the Button Block
<https://github.com/LaboratoireMecaniqueLille/crappy/examples/blocks/
button.py>`_.
<https://github.com/LaboratoireMecaniqueLille/crappy/blob/master/examples/
blocks/button.py>`_.

- :ref:`Generator`

Expand All @@ -223,9 +223,9 @@ Signal generation
can only output a combination of :ref:`Generator Paths`.

The examples folder on GitHub contains `several examples of the Generator
Block <https://github.com/LaboratoireMecaniqueLille/crappy/examples/blocks/
generator>`_ specifically, but it is also used in many of the other
examples.
Block <https://github.com/LaboratoireMecaniqueLille/crappy/tree/master/
examples/blocks/generator>`_ specifically, but it is also used in many of the
other examples.

:ref:`A tutorial section <2.a. The Generator Block and its Paths>` is also
dedicated to the Generator Block, and :ref:`another one
Expand All @@ -241,8 +241,8 @@ Signal generation
exact characteristics are unknown or can vary.

The examples folder on GitHub contains `one example of the PID Block
<https://github.com/LaboratoireMecaniqueLille/crappy/examples/blocks/
pid.py>`_.
<https://github.com/LaboratoireMecaniqueLille/crappy/blob/master/examples/
blocks/pid.py>`_.

Hardware control
++++++++++++++++
Expand All @@ -255,8 +255,8 @@ Hardware control
Block usually doesn't have input nor output Links.

The examples folder on GitHub contains `several examples of the Camera Block
<https://github.com/LaboratoireMecaniqueLille/crappy/examples/blocks/
camera>`_.
<https://github.com/LaboratoireMecaniqueLille/crappy/tree/master/examples/
blocks/camera>`_.

:ref:`A tutorial section <2.b. The Camera Block>` is also dedicated to the
Camera Block, and :ref:`another one <4. Custom Cameras>` is dedicated to the
Expand All @@ -271,8 +271,8 @@ Hardware control
Links when setting commands.

The examples folder on GitHub contains `several examples of the IOBlock Block
<https://github.com/LaboratoireMecaniqueLille/crappy/examples/blocks/
ioblock>`_.
<https://github.com/LaboratoireMecaniqueLille/crappy/tree/master/examples/
blocks/ioblock>`_.

:ref:`A tutorial section <2.e. The IOBlock Block>` is also dedicated to the
IOBlock Block, and :ref:`another one <3. Custom InOuts>` is dedicated to the
Expand All @@ -286,8 +286,8 @@ Hardware control
is intended for driving motors and similar devices.

The examples folder on GitHub contains `several examples of the Machine Block
<https://github.com/LaboratoireMecaniqueLille/crappy/examples/blocks/
machine>`_.
<https://github.com/LaboratoireMecaniqueLille/crappy/tree/master/examples/
blocks/machine>`_.

:ref:`A tutorial section <2.f. The Machine Block>` is also dedicated to the
Machine Block, and :ref:`another one <2. Custom Actuators>` is dedicated to
Expand All @@ -301,8 +301,8 @@ Hardware control
microcontroller, send commands, and receive data.

The examples folder on GitHub contains `on example of the UController Block
<https://github.com/LaboratoireMecaniqueLille/crappy/examples/blocks/
ucontroller>`_.
<https://github.com/LaboratoireMecaniqueLille/crappy/tree/master/examples/
blocks/ucontroller>`_.

Others
++++++
Expand All @@ -315,8 +315,8 @@ Others
controlling a test.

The examples folder on GitHub contains `on example of the Client Server Block
<https://github.com/LaboratoireMecaniqueLille/crappy/examples/blocks/
client_server>`_.
<https://github.com/LaboratoireMecaniqueLille/crappy/tree/master/examples/
blocks/client_server>`_.

- :ref:`Fake Machine`

Expand All @@ -326,25 +326,25 @@ Others
debugging or prototyping.

The examples folder on GitHub contains `on example of the Fake Machine Block
<https://github.com/LaboratoireMecaniqueLille/crappy/examples/blocks/
fake_machine.py>`_.
<https://github.com/LaboratoireMecaniqueLille/crappy/blob/master/examples/
blocks/fake_machine.py>`_.

- :ref:`Sink`

Discards any received data. Used for prototyping and debugging only.

The examples folder on GitHub contains `on example of the Sink Block
<https://github.com/LaboratoireMecaniqueLille/crappy/examples/blocks/
sink.py>`_.
<https://github.com/LaboratoireMecaniqueLille/crappy/blob/master/examples/
blocks/sink.py>`_.

- :ref:`Stop Block`

Stops the current Crappy script if the received data meets one of the given
criteria. One of the clean ways to stop a script in Crappy.

The examples folder on GitHub contains `on example of the Stop Block
<https://github.com/LaboratoireMecaniqueLille/crappy/examples/blocks/
stop_block.py>`_.
<https://github.com/LaboratoireMecaniqueLille/crappy/blob/master/examples/
blocks/stop_block.py>`_.

Refer to the :ref:`dedicated tutorial section
<3. Properly stopping a script>` to learn more about how to properly stop a
Expand All @@ -356,8 +356,8 @@ Others
One of the clean ways to stop a script in Crappy.

The examples folder on GitHub contains `on example of the Stop Button Block
<https://github.com/LaboratoireMecaniqueLille/crappy/examples/blocks/
stop_button.py>`_.
<https://github.com/LaboratoireMecaniqueLille/crappy/blob/master/examples/
blocks/stop_button.py>`_.

Refer to the :ref:`dedicated tutorial section
<3. Properly stopping a script>` to learn more about how to properly stop a
Expand All @@ -372,9 +372,9 @@ Supported Cameras
- :ref:`Basler Ironman Camera Link`

Allows reading images from a camera communicating over Camera Link plugged to
a `microEnable 5 ironman AD8-PoCL <https://www.baslerweb.com/en/products/
acquisition-cards/microenable-5-ironman/>`_ PCIexpress board. May as well
work with similar boards.
a `microEnable 5 ironman AD8-PoCL <https://www.baslerweb.com/en/
acquisition-cards/frame-grabbers/>`_ PCIexpress board. May as well work with
similar boards.

.. Important::
This Camera object relies on C++ libraries, which are not distributed with
Expand Down
24 changes: 13 additions & 11 deletions docs/source/tutorials/complex_custom_objects.rst
Original file line number Diff line number Diff line change
Expand Up @@ -114,9 +114,10 @@ self-explanatory by just reading the code and the comments. You can
:download:`download this custom Path example
</downloads/complex_custom_objects/custom_path.py>` to run it locally on your
machine. You should see that the duty cycle of the generated square signal
varies according to the target duty cycle, as expected. In the `examples on
GitHub <https://github.com/LaboratoireMecaniqueLille/crappy/examples/
custom_objects>`_, you'll find another example of a custom Generator Path.
varies according to the target duty cycle, as expected. In the `custom objects
examples on GitHub <https://github.com/LaboratoireMecaniqueLille/crappy/tree/
master/examples/custom_objects>`_, you'll find another example of a custom
Generator Path.

.. Note::
If you want to have debug information displayed in the terminal from your
Expand Down Expand Up @@ -213,12 +214,12 @@ It is passed no matter its value, so it might be equal to :obj:`None` ! It is
your duty to handle the two situations when it has or hasn't an actual value.
For hardware that doesn't support speed adjustment when operated in position
mode, this argument can always be ignored. You can have a look at the
`Actuators distributed with Crappy
<https://github.com/LaboratoireMecaniqueLille/crappy/src/crappy/actuator>`_
to see how the various :meth:`~crappy.actuator.Actuator.set_position` methods
implement the speed management in position mode. Also, an example of a
:ref:`Machine` Block with a variable target speed can be found in the `examples
folder on GitHub <https://github.com/LaboratoireMecaniqueLille/crappy/
`Actuators distributed with Crappy <https://github.com/
LaboratoireMecaniqueLille/crappy/tree/master/src/crappy/actuator>`_ to see how
the various :meth:`~crappy.actuator.Actuator.set_position` methods implement
the speed management in position mode. Also, an example of a :ref:`Machine`
Block with a variable target speed can be found in the `blocks examples folder
on GitHub <https://github.com/LaboratoireMecaniqueLille/crappy/tree/master/
examples/blocks>`_.

4. More about custom Cameras
Expand Down Expand Up @@ -680,8 +681,9 @@ the detected eyes on the displayed images :
Python modules installed.

This custom Camera Block script is based on an example that you can find in the
`examples folder on GitHub <https://github.com/LaboratoireMecaniqueLille/
crappy/examples/custom_objects>`__. You can :download:`download it
`custom objects examples folder on GitHub <https://github.com/
LaboratoireMecaniqueLille/crappy/examples/custom_objects>`__. You can
:download:`download it
</downloads/complex_custom_objects/custom_camera_block.py>` to run it locally
on your machine. Note that the :py:`'Webcam'` camera is used here, so this
example will require a camera readable by OpenCV to be plugged to the computer.
Expand Down
6 changes: 3 additions & 3 deletions docs/source/tutorials/custom_objects.rst
Original file line number Diff line number Diff line change
Expand Up @@ -371,9 +371,9 @@ Actuators. The new methods are :
labels in :py:`cmd_labels`.

Once again, let's switch to practice by writing a custom InOut class. We'll
keep it very basic, you can browse the `InOuts distributed with Crappy
<https://github.com/LaboratoireMecaniqueLille/crappy/src/crappy/inout>`_ to
have an overview of what a real-life InOut looks like.
keep it very basic, you can browse the `collection of InOuts distributed with
Crappy <https://github.com/LaboratoireMecaniqueLille/crappy/tree/master/src/
crappy/inout>`_ to have an overview of what a real-life InOut looks like.

.. literalinclude:: /downloads/custom_objects/custom_inout.py
:language: python
Expand Down
4 changes: 2 additions & 2 deletions docs/source/tutorials/more_complexity.rst
Original file line number Diff line number Diff line change
Expand Up @@ -124,8 +124,8 @@ you to have a look at the section detailing :ref:`how to code your own
Modifiers <1. Custom Modifiers>`. You can :download:`download this Modifier
example </downloads/more_complexity/tuto_modifiers.py>` to run it locally on
your machine. The Modifiers distributed with Crappy are also showcased in the
`examples folder on GitHub
<https://github.com/LaboratoireMecaniqueLille/crappy/examples/modifiers>`_.
`examples folder on GitHub <https://github.com/LaboratoireMecaniqueLille/
crappy/tree/master/examples/modifiers>`_.

3. Advanced Generator condition
-------------------------------
Expand Down
4 changes: 2 additions & 2 deletions docs/source/what_is_crappy.rst
Original file line number Diff line number Diff line change
Expand Up @@ -91,7 +91,7 @@ won't be able to help you. So Crappy is **NOT for you** if :
:target: https://crappy.readthedocs.io/en/latest/?badge=latest

.. |PyPi version| image:: https://badgen.net/pypi/v/crappy/
:target: https://pypi.org/project/crappy
:target: https://pypi.org/project/crappy/

.. |PyPI pyversions| image:: https://img.shields.io/pypi/pyversions/crappy.svg
:target: https://pypi.python.org/pypi/crappy/
:target: https://pypi.org/project/crappy/
2 changes: 1 addition & 1 deletion src/crappy/__version__.py
Original file line number Diff line number Diff line change
@@ -1,3 +1,3 @@
# coding: utf-8

__version__ = '2.0.0'
__version__ = '2.0.1'
2 changes: 2 additions & 0 deletions src/crappy/modifier/_deprecated.py
Original file line number Diff line number Diff line change
Expand Up @@ -2,6 +2,8 @@

from .meta_modifier import Modifier

# Do not forget to revert changes in MetaModifier


class Moving_avg(Modifier):
"""Empty class for signaling an object of version 1.5 whose name changed in
Expand Down
Loading

0 comments on commit 416dcac

Please sign in to comment.