### Install NNLS Chroma Plugin

Source: https://context7.com/shidephen/chordino/llms.txt

Copies the compiled NNLS Chroma plugin to the system's Vamp plugin directory for system-wide availability.

```bash
sudo cp nnls-chroma.so /usr/local/lib/vamp/
```

--------------------------------

### Build NNLS Chroma Plugin Library (Makefiles)

Source: https://context7.com/shidephen/chordino/llms.txt

Instructions for building the NNLS Chroma plugin library on different platforms using Makefiles. Ensure you have the Vamp Plugin SDK installed.

```bash
# Linux build
make -f Makefile.linux

# macOS build
make -f Makefile.osx

# Windows (MinGW) build
make -f Makefile.mingw

# Common build settings (from Makefile.inc):
# - Block size: 16384 samples
# - Step size: 2048 samples
# - Requires: vamp-sdk headers and library

# Install the built plugin (Linux example)
# Copy nnls-chroma.so to Vamp plugin path
cp nnls-chroma.so ~/.vamp/

```

--------------------------------

### Verify NNLS Chroma Plugin Installation

Source: https://context7.com/shidephen/chordino/llms.txt

Checks if the NNLS Chroma plugin is recognized by the Vamp host by listing available plugins and filtering for 'nnls-chroma'.

```bash
vamp-simple-host -l | grep nnls-chroma
```

--------------------------------

### Get Frame-by-Frame Local Tuning with sonic-annotator

Source: https://context7.com/shidephen/chordino/llms.txt

This command extracts local tuning estimates for each frame of the audio. The results are stored in a CSV file.

```bash
sonic-annotator -d vamp:nnls-chroma:tuning:localtuning \
    -w csv --csv-one-file localtuning.csv input.wav
```

--------------------------------

### Get Harmonic Change Detection with Sonic Annotator

Source: https://context7.com/shidephen/chordino/llms.txt

Detects and outputs harmonic changes from an audio file using the Chordino plugin.

```bash
# Get harmonic change detection
sonic-annotator -d vamp:nnls-chroma:chordino:harmonicchange \
    -w csv --csv-one-file harmonicchange.csv input.wav
```

--------------------------------

### Get Global Tuning with sonic-annotator

Source: https://context7.com/shidephen/chordino/llms.txt

Use this command to extract a single tuning value for the entire audio file. The output is saved to a CSV file.

```bash
sonic-annotator -d vamp:nnls-chroma:tuning:tuning \
    -w csv --csv-one-file tuning.csv input.wav
```

--------------------------------

### Get Chord Notes Representation with Sonic Annotator

Source: https://context7.com/shidephen/chordino/llms.txt

Extracts the MIDI note representation of detected chords from an audio file using the Chordino plugin.

```bash
# Get MIDI note representation of chords
sonic-annotator -d vamp:nnls-chroma:chordino:chordnotes \
    -w csv --csv-one-file chordnotes.csv input.wav
```

--------------------------------

### Configure Chordino Parameters

Source: https://context7.com/shidephen/chordino/llms.txt

Configure parameters for chord extraction, including NNLS usage, boost N likelihood, and Harte syntax, using the Chordino plugin.

```bash
# Configure chord extraction parameters
# boostn: boost N (no chord) label likelihood (0-1, default 0.1)
# usehartesyntax: use Chris Harte's chord syntax (0=no, 1=yes)
sonic-annotator -d "vamp:nnls-chroma:chordino:simplechord" \
    -p useNNLS=1 -p rollon=0 -p tuningmode=0 -p whitening=1.0 \
    -p s=0.7 -p boostn=0.1 -p usehartesyntax=0 \
    -w csv --csv-one-file chords.csv input.wav
```

--------------------------------

### Standalone Chord Extraction Program (C++)

Source: https://context7.com/shidephen/chordino/llms.txt

This C++ program demonstrates direct plugin usage within an application. It uses libsndfile for audio input and Vamp Host SDK adapters for processing. Compile with the provided command.

```cpp
// chordextract.cpp - Standalone chord extraction program
// Compile with:
// g++ -D_VAMP_PLUGIN_IN_HOST_NAMESPACE -O2 -ffast-math chordextract.cpp \
//     Chordino.cpp NNLSBase.cpp chromamethods.cpp viterbi.cpp nnls.c \
//     -o chordextract -lsndfile -lvamp-hostsdk -ldl

#define _VAMP_PLUGIN_IN_HOST_NAMESPACE 1

#include <vamp-hostsdk/PluginInputDomainAdapter.h>
#include <vamp-hostsdk/PluginBufferingAdapter.h>
#include "Chordino.h"
#include <sndfile.h>
#include <iostream>

using namespace std;
using namespace Vamp;
using namespace Vamp::HostExt;

int main(int argc, char **argv)
{
    if (argc != 2) {
        cerr << "usage: " << argv[0] << " file.wav" << endl;
        return 2;
    }

    // Open audio file with libsndfile
    SF_INFO sfinfo;
    SNDFILE *sndfile = sf_open(argv[1], SFM_READ, &sfinfo);
    if (!sndfile) {
        cerr << "Failed to open: " << sf_strerror(sndfile) << endl;
        return 1;
    }

    // Create plugin with adapters for FFT and buffering
    Chordino *chordino = new Chordino(sfinfo.samplerate);
    PluginInputDomainAdapter *ia = new PluginInputDomainAdapter(chordino);
    ia->setProcessTimestampMethod(PluginInputDomainAdapter::ShiftData);
    PluginBufferingAdapter *adapter = new PluginBufferingAdapter(ia);

    int blocksize = adapter->getPreferredBlockSize();

    // Initialize for mono input
    if (!adapter->initialise(1, blocksize, blocksize)) {
        cerr << "Failed to initialise Chordino adapter!" << endl;
        return 1;
    }

    // Find chord output index
    int chordFeatureNo = -1;
    Plugin::OutputList outputs = adapter->getOutputDescriptors();
    for (int i = 0; i < (int)outputs.size(); ++i) {
        if (outputs[i].identifier == "simplechord") {
            chordFeatureNo = i;
        }
    }

    // Allocate buffers
    float *filebuf = new float[sfinfo.channels * blocksize];
    float *mixbuf = new float[blocksize];
    Plugin::FeatureList chordFeatures;
    Plugin::FeatureSet fs;

    // Process audio frame by frame
    int frame = 0;
    while (frame < sfinfo.frames) {
        int count = sf_readf_float(sndfile, filebuf, blocksize);
        if (count <= 0) break;

        // Mix down to mono
        for (int i = 0; i < blocksize; ++i) {
            mixbuf[i] = 0.f;
            if (i < count) {
                for (int c = 0; c < sfinfo.channels; ++c) {
                    mixbuf[i] += filebuf[i * sfinfo.channels + c] / sfinfo.channels;
                }
            }
        }

        RealTime timestamp = RealTime::frame2RealTime(frame, sfinfo.samplerate);
        fs = adapter->process(&mixbuf, timestamp);

        chordFeatures.insert(chordFeatures.end(),
                             fs[chordFeatureNo].begin(),
                             fs[chordFeatureNo].end());
        frame += count;
    }

    sf_close(sndfile);

    // Get remaining features (Chordino does main work here)
    fs = adapter->getRemainingFeatures();
    chordFeatures.insert(chordFeatures.end(),
                         fs[chordFeatureNo].begin(),
                         fs[chordFeatureNo].end());

    // Output chord timeline
    for (int i = 0; i < (int)chordFeatures.size(); ++i) {
        cout << chordFeatures[i].timestamp.toString() << ": "
             << chordFeatures[i].label << endl;
    }

    delete[] filebuf;
    delete[] mixbuf;
    delete adapter;
    return 0;
}

```

--------------------------------

### Use Harte Syntax for Chord Labels

Source: https://context7.com/shidephen/chordino/llms.txt

Enables the use of Chris Harte's chord syntax (e.g., "C:maj") for chord labels when using the Chordino plugin.

```bash
# Use Harte syntax for chord labels (e.g., "C:maj" instead of "C")
sonic-annotator -d "vamp:nnls-chroma:chordino:simplechord" \
    -p usehartesyntax=1 \
    -w csv --csv-one-file chords_harte.csv input.wav
```

--------------------------------

### Extract Simple Chord Transcription with Sonic Annotator

Source: https://context7.com/shidephen/chordino/llms.txt

Performs basic chord transcription from an audio file using the Chordino plugin.

```bash
# Extract chord transcription using sonic-annotator
# Plugin identifier: vamp:nnls-chroma:chordino

# Basic chord extraction
sonic-annotator -d vamp:nnls-chroma:chordino:simplechord \
    -w csv --csv-one-file chords.csv input.wav
```

--------------------------------

### Manual Chordino Regression Test

Source: https://context7.com/shidephen/chordino/llms.txt

Performs a manual regression test by running Chordino on an audio file and saving the output to a CSV file for comparison.

```bash
VAMP_PATH=".." sonic-annotator \
    -d vamp:nnls-chroma:chordino:simplechord \
    -w csv --csv-omit-filename \
    --csv-one-file output.csv \
    --csv-force \
    input.ogg
```

--------------------------------

### Run NNLS Chroma Regression Tests

Source: https://context7.com/shidephen/chordino/llms.txt

Executes the regression test suite to verify the accuracy of the Chordino plugin's chord extraction against expected results.

```bash
cd regression
./regression.sh
```

--------------------------------

### Compare Regression Test Output

Source: https://context7.com/shidephen/chordino/llms.txt

Compares the generated output CSV file with the expected results file to identify any discrepancies in chord extraction.

```bash
diff output.csv expected.csv
```

--------------------------------

### Extract Tuned Log-Frequency Spectrum with Sonic Annotator

Source: https://context7.com/shidephen/chordino/llms.txt

Extracts the tuned log-frequency spectrum from an audio file using the NNLS Chroma plugin.

```bash
# Get tuned log-frequency spectrum
sonic-annotator -d vamp:nnls-chroma:nnls-chroma:tunedlogfreqspec \
    -w csv --csv-one-file tunedlogfreq.csv input.wav
```

--------------------------------

### Configure Bass Noise Threshold with sonic-annotator

Source: https://context7.com/shidephen/chordino/llms.txt

Adjust the 'rollon' parameter to set the bass noise threshold when extracting tuning information. This parameter ranges from 0 to 5%.

```bash
sonic-annotator -d "vamp:nnls-chroma:tuning:tuning" \
    -p rollon=0.0 \
    -w csv --csv-one-file tuning.csv input.wav
```

--------------------------------

### Configure NNLS Chroma Parameters

Source: https://context7.com/shidephen/chordino/llms.txt

Configure NNLS transcription, whitening, and normalization parameters for the NNLS Chroma plugin when extracting chromagrams.

```bash
# Configure parameters: NNLS transcription, whitening, normalization
# Parameters: useNNLS (0-1), rollon (0-5%), tuningmode (0=global, 1=local),
#             whitening (0-1), s (0.5-0.9 spectral shape), normtype (0-3)
sonic-annotator -d "vamp:nnls-chroma:nnls-chroma:chroma" \
    -p useNNLS=1 -p whitening=1.0 -p s=0.7 -p tuningmode=0 -p normtype=0 \
    -w csv --csv-one-file chromagram.csv input.wav
```

--------------------------------

### Extract Log-Frequency Spectrum with Sonic Annotator

Source: https://context7.com/shidephen/chordino/llms.txt

Extracts the raw log-frequency spectrum from an audio file using the NNLS Chroma plugin.

```bash
# Get log-frequency spectrum
sonic-annotator -d vamp:nnls-chroma:nnls-chroma:logfreqspec \
    -w csv --csv-one-file logfreq.csv input.wav
```

--------------------------------

### Extract Semitone Spectrum with Sonic Annotator

Source: https://context7.com/shidephen/chordino/llms.txt

Extracts the 84-bin semitone spectrum from an audio file using the NNLS Chroma plugin.

```bash
# Get semitone spectrum (84 bins)
sonic-annotator -d vamp:nnls-chroma:nnls-chroma:semitonespectrum \
    -w csv --csv-one-file semitone.csv input.wav
```

--------------------------------

### Extract Combined 24-D Chromagram with Sonic Annotator

Source: https://context7.com/shidephen/chordino/llms.txt

Generates a combined 24-dimensional chromagram (bass + treble) from an audio file using the NNLS Chroma plugin.

```bash
# Get combined 24-dimensional chromagram (bass + treble)
sonic-annotator -d vamp:nnls-chroma:nnls-chroma:bothchroma \
    -w csv --csv-one-file bothchroma.csv input.wav
```

--------------------------------

### Extract 12-bin Chromagram with Sonic Annotator

Source: https://context7.com/shidephen/chordino/llms.txt

Use this command to extract the standard 12-dimensional chromagram from an audio file using the NNLS Chroma plugin.

```bash
# Extract chromagram using sonic-annotator (command-line Vamp host)
# Plugin identifier: vamp:nnls-chroma:nnls-chroma

# Get the 12-bin chromagram output
sonIC-annotator -d vamp:nnls-chroma:nnls-chroma:chroma \
    -w csv --csv-one-file chromagram.csv input.wav
```

--------------------------------

### Extract Bass Chromagram with Sonic Annotator

Source: https://context7.com/shidephen/chordino/llms.txt

Extracts the bass chromagram representation from an audio file using the NNLS Chroma plugin via sonic-annotator.

```bash
# Get the bass chromagram output
sonic-annotator -d vamp:nnls-chroma:nnls-chroma:basschroma \
    -w csv --csv-one-file basschroma.csv input.wav
```

=== COMPLETE CONTENT === This response contains all available snippets from this library. No additional content exists. Do not make further requests.