bader-comsar 0.0.3__tar.gz

bader_comsar-0.0.3/LICENSE

@@ -0,0 +1,29 @@
+BSD 3-Clause License
+
+Copyright (c) 2020, Michael Blaß
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+
+1. Redistributions of source code must retain the above copyright notice, this
+   list of conditions and the following disclaimer.
+
+2. 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.
+
+3. Neither the name of the copyright holder nor the names of its
+   contributors may be used to endorse or promote products derived from
+   this software without specific prior written permission.
+
+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.

bader_comsar-0.0.3/PKG-INFO

@@ -0,0 +1,104 @@
+Metadata-Version: 2.4
+Name: bader-comsar
+Version: 0.0.3
+Summary: Computational Music and Sound Archiving
+Author: Michael Blaß, Rolf Bader
+Author-email: R_Bader@t-online.de
+License: BSD-3-Clause
+Project-URL: Source code, https://codeberg.org/rbader/comsar
+Project-URL: Bug tracker, https://codeberg.org/rbader/comsar/issues
+Project-URL: Documentation, https://codeberg.org/rbader/comsar
+Keywords: comsar,music,analysis,ethnomusicology
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: Implementation :: CPython
+Classifier: Topic :: Scientific/Engineering
+Classifier: Topic :: Database
+Classifier: Topic :: Multimedia :: Sound/Audio :: Analysis
+Classifier: Intended Audience :: Science/Research
+Classifier: Intended Audience :: Information Technology
+Classifier: License :: OSI Approved :: BSD License
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: bader-apollon>=0.1.5
+Requires-Dist: numpy>=1.23
+Requires-Dist: pandas
+Requires-Dist: scipy>=1.6
+Requires-Dist: matplotlib>=3
+Requires-Dist: scikit-learn>=1.0
+Dynamic: license-file
+
+# comsar — Computational Music and Sound Archiving
+
+**comsar** is a Python toolkit for content-based analysis of music and sound,
+with a focus on ethnomusicology (timbre, pitch/melody, tonal systems, rhythm and
+corpus visualisation with Self-Organizing Maps).
+
+It is the top layer of a three-package stack maintained by **Rolf Bader**:
+
+| Package | Role | Repository |
+|---|---|---|
+| [**apollon**](https://codeberg.org/rbader/apollon) | Backbone: audio I/O, feature extraction, HMM, SOM (C-accelerated) | `codeberg.org/rbader/apollon` |
+| [**chainsaddiction**](https://codeberg.org/rbader/chainsaddiction) | Poisson Hidden-Markov-Models in C (used for rhythm / time-series) | `codeberg.org/rbader/chainsaddiction` |
+| [**comsar**](https://codeberg.org/rbader/comsar) | High-level music analysis (`PitchTrack`, `TimbreTrack`, tonal systems, SOM) | `codeberg.org/rbader/comsar` |
+
+This fork combines the modern comsar code base with the pitch-tracking and
+tonal-system analysis (`PitchTrack`) merged back from the older comsar version.
+
+> **Distribution names.** The original PyPI names `apollon`, `comsar` and
+> `chainsaddiction` belong to the upstream authors. This fork is published as
+> `bader-apollon`, `bader-comsar` and `bader-chainsaddiction`. The **import**
+> names are unchanged: you still write `import comsar`, `import apollon`, etc.
+
+## Installation (no compiler needed)
+
+Pre-compiled wheels are provided for **Windows, macOS and Linux**
+(CPython 3.9–3.13). Installing comsar pulls apollon and chainsaddiction
+automatically:
+
+```
+pip install bader-comsar
+```
+
+To also run the example notebooks:
+
+```
+pip install bader-comsar jupyterlab
+```
+
+For source builds, step-by-step Windows/macOS/Linux instructions, and
+troubleshooting, see the **[full manual](docs/MANUAL.md)**.
+
+## Quick start
+
+```python
+from comsar import PitchTrack, TimbreTrack
+
+# Pitch / melody / tonal-system analysis
+pt = PitchTrack()
+result = pt.extract("my_audio.wav")
+print(result.features)          # pandas DataFrame
+
+# Timbre feature track
+tt = TimbreTrack()
+timbre = tt.extract("my_audio.wav")
+```
+
+Runnable notebooks are in [`examples/`](examples/).
+
+## Documentation
+
+* **[docs/MANUAL.md](docs/MANUAL.md)** — full manual: architecture,
+  installation, module reference, example walkthrough, troubleshooting,
+  and how releases/wheels are built.
+* **[examples/](examples/)** — Jupyter notebooks for the main workflows.
+
+## License
+
+BSD-3-Clause. Original work © Michael Blaß; this fork maintained by Rolf Bader.

bader_comsar-0.0.3/README.md

@@ -0,0 +1,68 @@
+# comsar — Computational Music and Sound Archiving
+
+**comsar** is a Python toolkit for content-based analysis of music and sound,
+with a focus on ethnomusicology (timbre, pitch/melody, tonal systems, rhythm and
+corpus visualisation with Self-Organizing Maps).
+
+It is the top layer of a three-package stack maintained by **Rolf Bader**:
+
+| Package | Role | Repository |
+|---|---|---|
+| [**apollon**](https://codeberg.org/rbader/apollon) | Backbone: audio I/O, feature extraction, HMM, SOM (C-accelerated) | `codeberg.org/rbader/apollon` |
+| [**chainsaddiction**](https://codeberg.org/rbader/chainsaddiction) | Poisson Hidden-Markov-Models in C (used for rhythm / time-series) | `codeberg.org/rbader/chainsaddiction` |
+| [**comsar**](https://codeberg.org/rbader/comsar) | High-level music analysis (`PitchTrack`, `TimbreTrack`, tonal systems, SOM) | `codeberg.org/rbader/comsar` |
+
+This fork combines the modern comsar code base with the pitch-tracking and
+tonal-system analysis (`PitchTrack`) merged back from the older comsar version.
+
+> **Distribution names.** The original PyPI names `apollon`, `comsar` and
+> `chainsaddiction` belong to the upstream authors. This fork is published as
+> `bader-apollon`, `bader-comsar` and `bader-chainsaddiction`. The **import**
+> names are unchanged: you still write `import comsar`, `import apollon`, etc.
+
+## Installation (no compiler needed)
+
+Pre-compiled wheels are provided for **Windows, macOS and Linux**
+(CPython 3.9–3.13). Installing comsar pulls apollon and chainsaddiction
+automatically:
+
+```
+pip install bader-comsar
+```
+
+To also run the example notebooks:
+
+```
+pip install bader-comsar jupyterlab
+```
+
+For source builds, step-by-step Windows/macOS/Linux instructions, and
+troubleshooting, see the **[full manual](docs/MANUAL.md)**.
+
+## Quick start
+
+```python
+from comsar import PitchTrack, TimbreTrack
+
+# Pitch / melody / tonal-system analysis
+pt = PitchTrack()
+result = pt.extract("my_audio.wav")
+print(result.features)          # pandas DataFrame
+
+# Timbre feature track
+tt = TimbreTrack()
+timbre = tt.extract("my_audio.wav")
+```
+
+Runnable notebooks are in [`examples/`](examples/).
+
+## Documentation
+
+* **[docs/MANUAL.md](docs/MANUAL.md)** — full manual: architecture,
+  installation, module reference, example walkthrough, troubleshooting,
+  and how releases/wheels are built.
+* **[examples/](examples/)** — Jupyter notebooks for the main workflows.
+
+## License
+
+BSD-3-Clause. Original work © Michael Blaß; this fork maintained by Rolf Bader.

bader_comsar-0.0.3/pyproject.toml

@@ -0,0 +1,3 @@
+[build-system]
+requires = ["setuptools", "wheel"]
+build-backend = "setuptools.build_meta"

bader_comsar-0.0.3/setup.cfg

@@ -0,0 +1,57 @@
+[metadata]
+name = bader-comsar
+version = 0.0.3
+description = Computational Music and Sound Archiving
+long_description = file: README.md
+long_description_content_type = text/markdown
+license = BSD-3-Clause
+author = Michael Blaß, Rolf Bader
+author_email = R_Bader@t-online.de
+keywords = comsar, music, analysis, ethnomusicology
+project_urls = 
+	Source code = https://codeberg.org/rbader/comsar
+	Bug tracker = https://codeberg.org/rbader/comsar/issues
+	Documentation = https://codeberg.org/rbader/comsar
+classifiers = 
+	Programming Language :: Python :: 3
+	Programming Language :: Python :: 3 :: Only
+	Programming Language :: Python :: 3.9
+	Programming Language :: Python :: 3.10
+	Programming Language :: Python :: 3.11
+	Programming Language :: Python :: 3.12
+	Programming Language :: Python :: 3.13
+	Programming Language :: Python :: Implementation :: CPython
+	Topic :: Scientific/Engineering
+	Topic :: Database
+	Topic :: Multimedia :: Sound/Audio :: Analysis
+	Intended Audience :: Science/Research
+	Intended Audience :: Information Technology
+	License :: OSI Approved :: BSD License
+
+[options]
+zip_safe = False
+package_dir = 
+	=src
+include_package_data = True
+packages = find_namespace:
+python_requires = >=3.9
+install_requires = 
+	bader-apollon>=0.1.5
+	numpy>=1.23
+	pandas
+	scipy>=1.6
+	matplotlib>=3
+	scikit-learn>=1.0
+
+[options.packages.find]
+where = src
+
+[options.package_data]
+comsar = 
+	scales.csv
+	tracks/schema/*.json
+
+[egg_info]
+tag_build = 
+tag_date = 0
+

bader_comsar-0.0.3/setup.py

@@ -0,0 +1,5 @@
+from setuptools import setup
+from setuptools.config import read_configuration
+
+config = read_configuration('./setup.cfg')
+setup()

bader_comsar-0.0.3/src/bader_comsar.egg-info/PKG-INFO

@@ -0,0 +1,104 @@
+Metadata-Version: 2.4
+Name: bader-comsar
+Version: 0.0.3
+Summary: Computational Music and Sound Archiving
+Author: Michael Blaß, Rolf Bader
+Author-email: R_Bader@t-online.de
+License: BSD-3-Clause
+Project-URL: Source code, https://codeberg.org/rbader/comsar
+Project-URL: Bug tracker, https://codeberg.org/rbader/comsar/issues
+Project-URL: Documentation, https://codeberg.org/rbader/comsar
+Keywords: comsar,music,analysis,ethnomusicology
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: Implementation :: CPython
+Classifier: Topic :: Scientific/Engineering
+Classifier: Topic :: Database
+Classifier: Topic :: Multimedia :: Sound/Audio :: Analysis
+Classifier: Intended Audience :: Science/Research
+Classifier: Intended Audience :: Information Technology
+Classifier: License :: OSI Approved :: BSD License
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: bader-apollon>=0.1.5
+Requires-Dist: numpy>=1.23
+Requires-Dist: pandas
+Requires-Dist: scipy>=1.6
+Requires-Dist: matplotlib>=3
+Requires-Dist: scikit-learn>=1.0
+Dynamic: license-file
+
+# comsar — Computational Music and Sound Archiving
+
+**comsar** is a Python toolkit for content-based analysis of music and sound,
+with a focus on ethnomusicology (timbre, pitch/melody, tonal systems, rhythm and
+corpus visualisation with Self-Organizing Maps).
+
+It is the top layer of a three-package stack maintained by **Rolf Bader**:
+
+| Package | Role | Repository |
+|---|---|---|
+| [**apollon**](https://codeberg.org/rbader/apollon) | Backbone: audio I/O, feature extraction, HMM, SOM (C-accelerated) | `codeberg.org/rbader/apollon` |
+| [**chainsaddiction**](https://codeberg.org/rbader/chainsaddiction) | Poisson Hidden-Markov-Models in C (used for rhythm / time-series) | `codeberg.org/rbader/chainsaddiction` |
+| [**comsar**](https://codeberg.org/rbader/comsar) | High-level music analysis (`PitchTrack`, `TimbreTrack`, tonal systems, SOM) | `codeberg.org/rbader/comsar` |
+
+This fork combines the modern comsar code base with the pitch-tracking and
+tonal-system analysis (`PitchTrack`) merged back from the older comsar version.
+
+> **Distribution names.** The original PyPI names `apollon`, `comsar` and
+> `chainsaddiction` belong to the upstream authors. This fork is published as
+> `bader-apollon`, `bader-comsar` and `bader-chainsaddiction`. The **import**
+> names are unchanged: you still write `import comsar`, `import apollon`, etc.
+
+## Installation (no compiler needed)
+
+Pre-compiled wheels are provided for **Windows, macOS and Linux**
+(CPython 3.9–3.13). Installing comsar pulls apollon and chainsaddiction
+automatically:
+
+```
+pip install bader-comsar
+```
+
+To also run the example notebooks:
+
+```
+pip install bader-comsar jupyterlab
+```
+
+For source builds, step-by-step Windows/macOS/Linux instructions, and
+troubleshooting, see the **[full manual](docs/MANUAL.md)**.
+
+## Quick start
+
+```python
+from comsar import PitchTrack, TimbreTrack
+
+# Pitch / melody / tonal-system analysis
+pt = PitchTrack()
+result = pt.extract("my_audio.wav")
+print(result.features)          # pandas DataFrame
+
+# Timbre feature track
+tt = TimbreTrack()
+timbre = tt.extract("my_audio.wav")
+```
+
+Runnable notebooks are in [`examples/`](examples/).
+
+## Documentation
+
+* **[docs/MANUAL.md](docs/MANUAL.md)** — full manual: architecture,
+  installation, module reference, example walkthrough, troubleshooting,
+  and how releases/wheels are built.
+* **[examples/](examples/)** — Jupyter notebooks for the main workflows.
+
+## License
+
+BSD-3-Clause. Original work © Michael Blaß; this fork maintained by Rolf Bader.

bader_comsar-0.0.3/src/bader_comsar.egg-info/SOURCES.txt

@@ -0,0 +1,28 @@
+LICENSE
+README.md
+pyproject.toml
+setup.cfg
+setup.py
+src/bader_comsar.egg-info/PKG-INFO
+src/bader_comsar.egg-info/SOURCES.txt
+src/bader_comsar.egg-info/dependency_links.txt
+src/bader_comsar.egg-info/not-zip-safe
+src/bader_comsar.egg-info/requires.txt
+src/bader_comsar.egg-info/top_level.txt
+src/comsar/__init__.py
+src/comsar/scales.csv
+src/comsar/_tracks/__init__.py
+src/comsar/cli/__init__.py
+src/comsar/cli/apollon_hmm.py
+src/comsar/cli/apollon_onsets.py
+src/comsar/cli/apollon_position.py
+src/comsar/cli/comsar_features.py
+src/comsar/tracks/__init__.py
+src/comsar/tracks/_form.py
+src/comsar/tracks/_pitch.py
+src/comsar/tracks/_rhythm.py
+src/comsar/tracks/_timbre.py
+src/comsar/tracks/helpers.py
+src/comsar/tracks/utilities.py
+src/comsar/tracks/schema/TonalSystem.schema.json
+src/comsar/tracks/schema/ngram.schema.json

bader_comsar-0.0.3/src/bader_comsar.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

bader_comsar-0.0.3/src/bader_comsar.egg-info/not-zip-safe

@@ -0,0 +1 @@
+

bader_comsar-0.0.3/src/bader_comsar.egg-info/requires.txt

@@ -0,0 +1,6 @@
+bader-apollon>=0.1.5
+numpy>=1.23
+pandas
+scipy>=1.6
+matplotlib>=3
+scikit-learn>=1.0

bader_comsar-0.0.3/src/bader_comsar.egg-info/top_level.txt

@@ -0,0 +1 @@
+comsar

bader_comsar-0.0.3/src/comsar/__init__.py

@@ -0,0 +1,22 @@
+"""comsar -- Computational Music and Sound Archiving.
+
+Top-level convenience re-exports so that user code / notebooks can simply do::
+
+    from comsar import PitchTrack, TimbreTrack
+"""
+try:
+    from importlib.metadata import version as _version, PackageNotFoundError
+except ImportError:                       # Python < 3.8 fallback
+    from importlib_metadata import version as _version, PackageNotFoundError
+
+try:
+    # Distribution name on PyPI is "bader-comsar"; the import name stays "comsar".
+    __version__ = _version("bader-comsar")
+except PackageNotFoundError:              # e.g. running from a source checkout
+    __version__ = "0.0.3"
+
+# __version__ is set *before* importing the tracks subpackage, because
+# comsar.tracks._pitch references ``comsar.__version__`` at runtime.
+from .tracks import TimbreTrack, PitchTrack
+
+__all__ = ["TimbreTrack", "PitchTrack", "__version__"]

bader_comsar-0.0.3/src/comsar/_tracks/__init__.py

@@ -0,0 +1,21 @@
+"""Backward-compatibility shim.
+
+Older comsar versions kept the implementation under ``comsar._tracks``.
+The current layout lives under ``comsar.tracks``. This package re-exports the
+old import paths so that legacy notebooks keep working, e.g.::
+
+    from comsar._tracks.utilities import ngramParams, TonalSystemParams
+"""
+import sys as _sys
+
+from comsar.tracks import utilities, helpers
+from comsar.tracks import _pitch as pitch
+from comsar.tracks import _timbre as timbre
+
+# Register the modules under their legacy dotted paths so that
+# ``from comsar._tracks.<name> import ...`` resolves without separate files.
+for _name, _mod in (("utilities", utilities), ("helpers", helpers),
+                    ("pitch", pitch), ("timbre", timbre)):
+    _sys.modules[f"{__name__}.{_name}"] = _mod
+
+del _sys, _name, _mod

bader_comsar-0.0.3/src/comsar/cli/__init__.py

@@ -0,0 +1,8 @@
+# Licensed under the terms of the BSD-3-Clause license.
+# Copyright (C) 2019 Michael Blaß
+# mblass@posteo.net
+
+from . import apollon_features
+from . import apollon_onsets
+from . import apollon_hmm
+from . import apollon_position

bader_comsar-0.0.3/src/comsar/cli/apollon_hmm.py

@@ -0,0 +1,102 @@
+#!/usr/bin/env python3
+
+# Licensed under the terms of the BSD-3-Clause license.
+# Copyright (C) 2019 Michael Blaß
+# mblass@posteo.net
+
+
+import argparse
+import json
+import pathlib
+import sys
+import typing
+
+import numpy as np
+
+from .. import io
+from .. hmm import PoissonHmm
+from .. types import Array as _Array
+from .. import tools
+
+
+def _load_track_file(track_file: str) -> dict:
+    track_file = pathlib.Path(track_file)
+    with track_file.open('r') as fobj:
+        track_data = json.load(fobj, object_hook=io.decode_array)
+    return track_data
+
+
+def _parse_feature_file(track_file: str, feature_path: str) -> _Array:
+    feature = _load_track_file(track_file)
+    for key in feature_path.split('.'):
+        try:
+            feature = feature[key]
+        except KeyError:
+            print('Error. Node "{}" not in "{}".'.format(key, track_file))
+            exit(10)
+    return _scaling(feature, key)
+
+
+
+def _scaling(data: _Array, feature: str) -> _Array:
+    features1000 = ['skewness', 'kurtosis', 'loudness',
+                    'roughness', 'sharpness']
+    if feature in features1000:
+        out = tools.scale(data, 1, 1000)
+    else:
+        out = data
+    return out.round().astype(int)
+
+
+def _train_n_hmm(data: _Array, m_states: int, n_trails: int):
+    """Trains ``n_trails`` HMMs each initialized with a random tpm.
+
+    Args:
+        data:      Possibly unporcessed input data set.
+        m_states:  Number of states.
+        n_trails:  Number of trails.
+
+    Returns:
+        Best model regarding to log-likelihood.
+    """
+    trails = []
+    for i in range(n_trails):
+        hmm = PoissonHmm(data, m_states, init_lambda='hist', init_gamma='softmax')
+        hmm.fit(data)
+        if hmm.success and not np.isnan(hmm.quality.nll):
+            trails.append(hmm)
+
+    for i in range(n_trails):
+        hmm = PoissonHmm(data, m_states, init_lambda='linear', init_gamma='softmax')
+        hmm.fit(data)
+        if hmm.success and not np.isnan(hmm.quality.nll):
+            trails.append(hmm)
+
+    for i in range(n_trails):
+        hmm = PoissonHmm(data, m_states, init_lambda='quantile', init_gamma='softmax')
+        hmm.fit(data)
+        if hmm.success and not np.isnan(hmm.quality.nll):
+            trails.append(hmm)
+
+    if len(trails) == 0:
+        return None
+    return min(trails, key=lambda hmm: abs(hmm.quality.nll))
+
+
+def main(argv=None) -> int:
+    if argv is None:
+        argv = sys.argv
+
+    for trf in argv.track_files:
+        feature = _parse_feature_file(trf, argv.feature_path)
+        hmm = _train_n_hmm(feature, argv.mstates, 5)
+        if hmm is None:
+            print('Error. Could not train HMM on {}'.format(trf))
+            continue
+        out_path = io.generate_outpath(trf, argv.outpath, 'hmm')
+        io.dump_json(hmm.to_dict(), out_path)
+    return 0
+
+
+if __name__ == '__main__':
+    sys.exit(main())

bader_comsar-0.0.3/src/comsar/cli/apollon_onsets.py

@@ -0,0 +1,67 @@
+# Licensed under the terms of the BSD-3-Clause license.
+# Copyright (C) 2019 Michael Blaß
+# mblass@posteo.net
+
+import argparse
+import multiprocessing as mp
+import sys
+
+from .. import onsets
+
+
+def _parse_cml(argv):
+    parser = argparse.ArgumentParser(description='Apollon onset detection engine')
+
+    parser.add_argument('--amplitude', action='store_true',
+                        help='Detect onsets based on local extrema in the time domain signal.')
+
+    parser.add_argument('--entropy', action='store_true',
+                        help='Detect onsets based on time domain entropy maxima.')
+
+    parser.add_argument('--flux', action='store_true',
+                        help='Detect onsets based on spectral flux.')
+
+    parser.add_argument('-o', '--outpath', action='store',
+                        help='Output file path.')
+
+    parser.add_argument('filepath', type=str, nargs=1)
+    return parser.parse_args(argv)
+
+
+def _amp(a):
+    print('Amplitude')
+    return a
+
+def _entropy(a):
+    print('Entropy')
+    return a
+
+def _flux(a):
+    print('Flux')
+    return a
+
+
+def main(argv=None):
+    if argv is None:
+        argv = sys.argv
+
+    args = _parse_cml(argv)
+
+
+    args = _parse_cml(argv)
+    detectors = {'amplitude': _amp,
+                 'entropy': _entropy,
+                 'flux': _flux}
+
+    methods = [func for name, func in detectors.items() if getattr(args, name)]
+    if len(methods) == 0:
+        print('At least one detection method required. Aborting.')
+        return 1
+
+    with mp.Pool(processes=3) as pool:
+        results = [pool.apply_async(meth, (i,)) for i, meth in enumerate(methods)]
+        out = [res.get() for res in results]
+    return out
+
+if __name__ == '__main__':
+    sys.exit(main())