piccal/README.md
2020-11-30 10:12:38 -05:00

166 lines
3.5 KiB
Markdown

# 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 Cheat Sheet
![Plot Seq 1](doc/do_td_plot.png)
Print a specific pitch and take.
````
python plot_seq.py p_ac.yml ~/temp/p_ac_3_of td_plot 60 2
do_td_plot(inDir,cfg.analysisArgs, pitch, take_id )
````
---
![Multi Usec dB](doc/us_db.png)
Plot all the takes for a given pitch
````
python plot_seq_1.py p_ac.yml ~/temp/p_ac_3_od us_db 84
````
---
![Overlapping USec dB](doc/us_db_takes.png)
Plot a specific set of pitches and takes.
````
python plot_seq_1.py p_ac.yml ~/temp/p_ac_3_of us_db_pitch_take 75 0 76 0 77 0 78 0 72 10 73 1 74 1
````
---
![Overlapping USec dB](doc/us_db_takes_last.png)
Plot the last take from a list of pitches.
````
python plot_seq_1.py p_ac.yml ~/temp/p_ac_3_of us_db_pitch_last 77 78 79 80
````
---
![Multi Plot 1](doc/multi_plot.png)
Plot the time domain envelope for a specific set of pitches and takes.
````
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)
Plot the spectrum with harmonic location markers of a specific set of pitches and takes.
````
# pitch0 takeId0 pitch1 takeId1
python plot_seq.py p_ac.yml ~/temp/p_ac_3_od plot_spectral_ranges 60 3 60 4
````
---
![Usec dB Spread](doc/us_db_map.png)
Plot the microsecond variance to achieve a given decibel value.
````
python plot_seq_1.py p_ac.yml ~/temp/p_ac_3_od us_db_map 84 72
````
---
![Resample](doc/resample_pulse_times.png)
Analyze all takes for given pitch and show the mean us/db curve and
places where resampling may be necessary.
````
python plot_seq.py p_ac.yml ~/temp/p_ac_3_of resample_pulse_times 84
````
---
![Min Max](doc/min_max_db.png)
Plot the min and max decibel values for specified pitches.
````
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)
Plot the min and max decibel values for specified pitches.
````
# pitch0 pitch1 pitch2 pitch3 pitch4 takeId
python plot_seq_1.py p_ac.yml ~/temp/p_ac_3_od min_max_2 36 48 60 72 84 2
````
---
![Manual dB](doc/manual_db.png)
Plot the min and max decibel values for specified set of manually corrected pitches.
````
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 ],
````