Update documentation and add info function

Author: joachimpoutaraud

docs/README.md

@@ -74,7 +74,7 @@ If you use this toolbox in your research, please cite this article:
 
 ## Credits
 
-Developers: [Frida Furmyr](https://github.com/fridafu), [Marcus Widmer](https://github.com/marcuswidmer), [Balint Laczko](https://github.com/balintlaczko), [Alexander Refsum Jensenius](https://github.com/alexarje/)
+Developers: [Balint Laczko](https://github.com/balintlaczko), [Joachim Poutaraud](https://github.com/joachimpoutaraud), [Frida Furmyr](https://github.com/fridafu), [Marcus Widmer](https://github.com/marcuswidmer), [Alexander Refsum Jensenius](https://github.com/alexarje/)
 
 ## License
 

docs/musicalgestures/_audio.md

@@ -26,7 +26,7 @@ Class container for audio analysis processes.
 
 ### Audio().descriptors
 
-[[find in source code]](https://github.com/fourMs/MGT-python/blob/master/musicalgestures/_audio.py#L210)
+[[find in source code]](https://github.com/fourMs/MGT-python/blob/master/musicalgestures/_audio.py#L221)
 
 ```python
 def descriptors(
@@ -62,7 +62,7 @@ Renders a figure of plots showing spectral/loudness descriptors, including RMS e
 
 ### Audio().spectrogram
 
-[[find in source code]](https://github.com/fourMs/MGT-python/blob/master/musicalgestures/_audio.py#L107)
+[[find in source code]](https://github.com/fourMs/MGT-python/blob/master/musicalgestures/_audio.py#L112)
 
 ```python
 def spectrogram(
@@ -72,6 +72,7 @@ def spectrogram(
     power=2,
     dpi=300,
     autoshow=True,
+    raw=False,
     title=None,
     target_name=None,
     overwrite=False,
@@ -88,6 +89,7 @@ Renders a figure showing the mel-scaled spectrogram of the video/audio file.
 - `power` *float, optional* - The steepness of the curve for the color mapping. Defaults to 2.
 - `dpi` *int, optional* - Image quality of the rendered figure in DPI. Defaults to 300.
 - `autoshow` *bool, optional* - Whether to show the resulting figure automatically. Defaults to True.
+- `raw` *bool, optional* - Whether to show labels and ticks on the plot. Defaults to False.
 - `title` *str, optional* - Optionally add title to the figure. Defaults to None, which uses the file name as a title.
 - `target_name` *str, optional* - The name of the output image. Defaults to None (which assumes that the input filename with the suffix "_spectrogram.png" should be used).
 - `overwrite` *bool, optional* - Whether to allow overwriting existing files or to automatically increment target filenames to avoid overwriting. Defaults to False.
@@ -98,7 +100,7 @@ Renders a figure showing the mel-scaled spectrogram of the video/audio file.
 
 ### Audio().tempogram
 
-[[find in source code]](https://github.com/fourMs/MGT-python/blob/master/musicalgestures/_audio.py#L348)
+[[find in source code]](https://github.com/fourMs/MGT-python/blob/master/musicalgestures/_audio.py#L360)
 
 ```python
 def tempogram(
@@ -141,6 +143,7 @@ def waveform(
     mono=False,
     dpi=300,
     autoshow=True,
+    raw=False,
     title=None,
     target_name=None,
     overwrite=False,
@@ -154,6 +157,7 @@ Renders a figure showing the waveform of the video/audio file.
 - `mono` *bool, optional* - Convert the signal to mono. Defaults to False.
 - `dpi` *int, optional* - Image quality of the rendered figure in DPI. Defaults to 300.
 - `autoshow` *bool, optional* - Whether to show the resulting figure automatically. Defaults to True.
+- `raw` *bool, optional* - Whether to show labels and ticks on the plot. Defaults to False.
 - `title` *str, optional* - Optionally add title to the figure. Defaults to None, which uses the file name as a title. Defaults to None.
 - `target_name` *str, optional* - The name of the output image. Defaults to None (which assumes that the input filename with the suffix "_waveform.png" should be used).
 - `overwrite` *bool, optional* - Whether to allow overwriting existing files or to automatically increment target filenames to avoid overwriting. Defaults to False.
@@ -164,7 +168,7 @@ Renders a figure showing the waveform of the video/audio file.
 
 ## mg_audio_descriptors
 
-[[find in source code]](https://github.com/fourMs/MGT-python/blob/master/musicalgestures/_audio.py#L629)
+[[find in source code]](https://github.com/fourMs/MGT-python/blob/master/musicalgestures/_audio.py#L654)
 
 ```python
 def mg_audio_descriptors(
@@ -202,7 +206,7 @@ Renders a figure of plots showing spectral/loudness descriptors, including RMS e
 
 ## mg_audio_spectrogram
 
-[[find in source code]](https://github.com/fourMs/MGT-python/blob/master/musicalgestures/_audio.py#L518)
+[[find in source code]](https://github.com/fourMs/MGT-python/blob/master/musicalgestures/_audio.py#L536)
 
 ```python
 def mg_audio_spectrogram(
@@ -213,6 +217,7 @@ def mg_audio_spectrogram(
     power=2,
     dpi=300,
     autoshow=True,
+    raw=False,
     title=None,
     target_name=None,
     overwrite=False,
@@ -230,6 +235,7 @@ Renders a figure showing the mel-scaled spectrogram of the video/audio file.
 - `power` *float, optional* - The steepness of the curve for the color mapping. Defaults to 2.
 - `dpi` *int, optional* - Image quality of the rendered figure in DPI. Defaults to 300.
 - `autoshow` *bool, optional* - Whether to show the resulting figure automatically. Defaults to True.
+- `raw` *bool, optional* - Whether to show labels and ticks on the plot. Defaults to False.
 - `title` *str, optional* - Optionally add title to the figure. Defaults to None, which uses the file name as a title.
 - `target_name` *str, optional* - The name of the output image. Defaults to None (which assumes that the input filename with the suffix "_spectrogram.png" should be used).
 - `overwrite` *bool, optional* - Whether to allow overwriting existing files or to automatically increment target filenames to avoid overwriting. Defaults to False.
@@ -240,7 +246,7 @@ Renders a figure showing the mel-scaled spectrogram of the video/audio file.
 
 ## mg_audio_tempogram
 
-[[find in source code]](https://github.com/fourMs/MGT-python/blob/master/musicalgestures/_audio.py#L773)
+[[find in source code]](https://github.com/fourMs/MGT-python/blob/master/musicalgestures/_audio.py#L798)
 
 ```python
 def mg_audio_tempogram(
@@ -278,14 +284,15 @@ Renders a figure with a plots of onset strength and tempogram of the video/audio
 
 ## mg_audio_waveform
 
-[[find in source code]](https://github.com/fourMs/MGT-python/blob/master/musicalgestures/_audio.py#L441)
+[[find in source code]](https://github.com/fourMs/MGT-python/blob/master/musicalgestures/_audio.py#L453)
 
 ```python
 def mg_audio_waveform(
     filename=None,
     mono=False,
     dpi=300,
     autoshow=True,
+    raw=False,
     title=None,
     target_name=None,
     overwrite=False,
@@ -300,6 +307,7 @@ Renders a figure showing the waveform of the video/audio file.
 - `mono` *bool, optional* - Convert the signal to mono. Defaults to False.
 - `dpi` *int, optional* - Image quality of the rendered figure in DPI. Defaults to 300.
 - `autoshow` *bool, optional* - Whether to show the resulting figure automatically. Defaults to True.
+- `raw` *bool, optional* - Whether to show labels and ticks on the plot. Defaults to False.
 - `title` *str, optional* - Optionally add title to the figure. Defaults to None, which uses the file name as a title. Defaults to None.
 - `target_name` *str, optional* - The name of the output image. Defaults to None (which assumes that the input filename with the suffix "_waveform.png" should be used).
 - `overwrite` *bool, optional* - Whether to allow overwriting existing files or to automatically increment target filenames to avoid overwriting. Defaults to False.

docs/musicalgestures/_blurfaces.md

@@ -39,7 +39,7 @@ Credits: `centerface.onnx` (original) and `centerface.py` are based on https://g
 - `mask_scale` *float, optional* - Scale factor for face masks, to make sure that the masks cover the complete face. Defaults to 1.0.
 - `ellipse` *bool, optional* - Mask faces with blurred ellipses. Defaults to True.
 - `draw_scores` *bool, optional* - Draw detection faceness scores onto outputs (a score between 0 and 1 that roughly corresponds to the detector's confidence that something is a face). Defaults to False.
-- `save_data` *bool, optional* - Whether we save the scaled coordinates of the face mask (x1, y1, x2, y2) for each frame to a file. Defaults to True
+- `save_data` *bool, optional* - Whether to save the scaled coordinates of the face mask (time, x1, y1, x2, y2) for each frame to a file. Defaults to True.
 - `data_format` *str, optional* - Specifies format of blur_faces-data. Accepted values are 'csv', 'tsv' and 'txt'. For multiple output formats, use list, eg. ['csv', 'txt']. Defaults to 'csv'.
 - `color` *tuple, optional* - Customized color of the rectangle boxes. Defaults to black (0, 0, 0).
 - `target_name` *str, optional* - Target output name for the directogram. Defaults to None (which assumes that the input filename with the suffix "_blurred" should be used).

docs/musicalgestures/_motionvideo.md

@@ -13,7 +13,7 @@
 
 ## mg_motion
 
-[[find in source code]](https://github.com/fourMs/MGT-python/blob/master/musicalgestures/_motionvideo.py#L267)
+[[find in source code]](https://github.com/fourMs/MGT-python/blob/master/musicalgestures/_motionvideo.py#L272)
 
 ```python
 def mg_motion(
@@ -26,6 +26,7 @@ def mg_motion(
     inverted_motiongram=False,
     unit='seconds',
     equalize_motiongram=True,
+    audio_descriptors=False,
     save_plot=True,
     plot_title=None,
     save_data=True,
@@ -75,7 +76,7 @@ centroid of motion for each frame with timecodes in milliseconds.
 
 ## mg_motiondata
 
-[[find in source code]](https://github.com/fourMs/MGT-python/blob/master/musicalgestures/_motionvideo.py#L87)
+[[find in source code]](https://github.com/fourMs/MGT-python/blob/master/musicalgestures/_motionvideo.py#L90)
 
 ```python
 def mg_motiondata(
@@ -108,7 +109,7 @@ Shortcut for [mg_motion](#mg_motion) to only render motion data.
 
 ## mg_motiongrams
 
-[[find in source code]](https://github.com/fourMs/MGT-python/blob/master/musicalgestures/_motionvideo.py#L14)
+[[find in source code]](https://github.com/fourMs/MGT-python/blob/master/musicalgestures/_motionvideo.py#L17)
 
 ```python
 def mg_motiongrams(
@@ -147,7 +148,7 @@ Shortcut for [mg_motion](#mg_motion) to only render motiongrams.
 
 ## mg_motionplots
 
-[[find in source code]](https://github.com/fourMs/MGT-python/blob/master/musicalgestures/_motionvideo.py#L156)
+[[find in source code]](https://github.com/fourMs/MGT-python/blob/master/musicalgestures/_motionvideo.py#L159)
 
 ```python
 def mg_motionplots(
@@ -156,6 +157,7 @@ def mg_motionplots(
     thresh=0.05,
     blur='None',
     kernel_size=5,
+    audio_descriptors=False,
     unit='seconds',
     title=None,
     target_name=None,
@@ -182,7 +184,7 @@ Shortcut for [mg_motion](#mg_motion) to only render motion plots.
 
 ## mg_motionvideo
 
-[[find in source code]](https://github.com/fourMs/MGT-python/blob/master/musicalgestures/_motionvideo.py#L207)
+[[find in source code]](https://github.com/fourMs/MGT-python/blob/master/musicalgestures/_motionvideo.py#L212)
 
 ```python
 def mg_motionvideo(
@@ -217,7 +219,7 @@ Shortcut to only render the motion video. Uses musicalgestures._utils.motionvide
 
 ## plot_motion_metrics
 
-[[find in source code]](https://github.com/fourMs/MGT-python/blob/master/musicalgestures/_motionvideo.py#L563)
+[[find in source code]](https://github.com/fourMs/MGT-python/blob/master/musicalgestures/_motionvideo.py#L573)
 
 ```python
 def plot_motion_metrics(
@@ -226,6 +228,7 @@ def plot_motion_metrics(
     aom,
     com,
     qom,
+    audio_descriptors,
     width,
     height,
     unit,
@@ -239,7 +242,7 @@ Helper function to plot the centroid and quantity of motion using matplotlib.
 
 ## save_txt
 
-[[find in source code]](https://github.com/fourMs/MGT-python/blob/master/musicalgestures/_motionvideo.py#L620)
+[[find in source code]](https://github.com/fourMs/MGT-python/blob/master/musicalgestures/_motionvideo.py#L675)
 
 ```python
 def save_txt(