piccal/README.md

# Picadae Calibration Programs


## Install
sudo dnf install python3-devel jack-audio-connection-kit-devel

prerequisites:
pyyaml
sounddevice
soundfile
pthon-rtmidi

export PYTHONPATH=${HOME}/src/picadae/control/app
python p_ac.py -c p_ac.yml

## Data collection

Record a sequence of notes of decreasing dynamic level

python p_ac.py # start the interactive data collection program

Capture note 60 and 61 using the full_pulseL[] and holdDutyPctD{} from the p_ac.yml

`c 60 61` 





![Plot Seq 1](doc/do_td_plot.png)
`python plot_seq.py ~/temp/p_ac_3_od p_ac.yml 60 10`
`do_td_plot(inDir,cfg.analysisArgs, pitch, take_id )`

![Multi Plot 1](doc/multi_plot.png)
`python plot_seq.py p_ac.yml ~/temp/p_ac_3_od td_multi_plot 60 3 60 4 60 5`
plot_seq.py `do_td_multi_plot(inDir,cfg.analysisArgs,[(36,4), (48,2)] )`

![Spectral Ranges](doc/plot_spectral_ranges.png)
`python plot_seq.py p_ac.yml ~/temp/p_ac_3_od plot_spectral_ranges 60 3 60 4`


![Multi Usec dB](doc/us_db.png)
`python plot_seq_1.py p_ac.yml ~/temp/p_ac_3_od us_db 84`

![Usec dB Spread](doc/us_db_map.png)
`python plot_seq_1.py p_ac.yml ~/temp/p_ac_3_od us_db_map 84 72`

![Min Max](doc/min_max_db.png)
`python plot_seq_1.py p_ac.yml ~/temp/p_ac_3_od min_max 36 48 60 72 84`


![Min Max 2](doc/min_max_db_2.png)
The last number in the list is the 'takeId'
`python plot_seq_1.py p_ac.yml ~/temp/p_ac_3_od min_max_2 36 48 60 72 84 2`

`python plot_seq_1.py p_ac.yml ~/temp/p_ac_3_od manual_db`

Interpolate across the min and max db values to form the min/max curves for the complete
set of keys.  The anchor points for the curves are taken from cfg record
manuMinD,manualAnchorPitchMinDbL, and manualMaxDbL.

````
      # select the event (takeId, eventIdx) to use to represent the min value for each pitch
      manualMinD: {
        36: [2, 10],
        48: [2, 10],
        60: [2, 10],
        72: [2, 10],
        84: [2, 10]
        },

      # leave 60 out of the min anchor point list
      manualAnchorPitchMinDbL: [ 36,48,72,84 ],
      
      manualAnchorPitchMaxDbL: [ 36,48,60,72,84 ],

````