piccal/README.md

* Picadae Calibration Programs

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

c 60 60 # caputre note 60 using the full_pulseL[] from the p_ac.yml






# plot third take of note 60 
python plot_seq.py ~/temp/p_ac_3_oa/60 p_ac.yml 3

# record a calibration take: CalibrateKeys.start
uses cfg.full_pulseL[] for the pulse sequence
use cfg.calibrateArgs.holdDutyPctD{} for hold PWM duty cycle

# obsolete plotting function in calibrate_plot.py
python calibrate_plot.py ~/temp/p_ac_3_oa/60/2 p_ac.yml 60






![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 ],

````