1 tplarson 1.1 full instructions with introduction can be found in 
 2              instructions_audio.txt .  this file provides the minimum information 
 3              needed to run the Sonification of Solar Harmonics (SoSH) Tool.  other 
 4              important information regarding pure data is found in README_audio.txt .
 5              
 6              if you are using the version of the SoSH Tool that includes demo data 
 7              files, these will already be found in the data directory that was 
 8              unpacked with the zip archive, in which case you may skip to step 2 
 9              below.  the demo data files are the following four: mdi.average.modes, 
10              mdi.average.modes.msplit, mdi.1216d_l=2_m=1_datar.wav, and 
11              mdi.1216d_l=2_m=1_datai.wav
12              
13              
14              follow these steps:
15              
16              1) download data
17              
18              the data are available at http://sun.stanford.edu/~tplarson/audio/, 
19              where you will find separate directories for MDI and HMI.  within each, 
20              you will find a series of directories that are day numbers suffixed with 
21              'd'.  the day number corresponds to the first day of the 72 day 
22 tplarson 1.1 timeseries.  day number 1216 was 1 may 1996.  a full table converting 
23              day numbers to dates can be found at the above url as well.
24              
25              clicking on a directory will show two ascii tables containing the mode 
26              fits; download both of these to your data directory.  then click on the 
27              wavfiles subdirectory, where you will find a selection of modes, 
28              labelled by l and m.  except for m=0, each mode has both a real and an 
29              imaginary part, labelled by "datar" and "datai" respectively.  pick an 
30              assortment of modes and download them to your data directory.
31              
32              alternatively, averaged mode fits can be found directly in each of the 
33              "MDI" and "HMI" directories.  you may elect to use these averaged fits 
34              for all day numbers.  this option is the default for most patches.
35              
36              
37              2) using the patch
38              
39              open the patch modefilter_standalone.pd .  if you are not using the data 
40              directory which was unpacked with the zip archive, you will need to set 
41              the path to the directory where you put the data.  do this by clicking 
42              the light blue bang at lower left.  a dialog box will open; just select 
43 tplarson 1.1 any file in your data directory and the object [set-directory] will 
44              strip the file name and output the path.  you should now see your path 
45              show up in the message box at right.  if you now save the patch file, 
46              this will be saved as your default data directory and you won't need to 
47              set it any more.
48              
49              next, click on the message box with "pd dsp 1", which will turn on 
50              digital signal processing (DSP).  finally, the inputs you must provide 
51              are the day number corresponding to the 72 day timeseries, the spherical 
52              harmonic degree l, the radial order n, and the azimuthal order m.  note 
53              that even if you want to leave one of these at its default value of 
54              zero, you must still click on the number box and enter 0.  now, to 
55              search for this mode, click the green bang at the upper left.  if found, 
56              the input arrays will be loaded, the fft will run, the gain will be 
57              generated, the gain and the fft will be multiplied and shifted before 
58              being inverse transformed, and the filtered audio will play.  to hear 
59              it, enter a number for the output level.  you will likely want to adjust 
60              the playback sample rate and downshift factor. you can turn off playback 
61              by clicking the toggle.  you may also elect to save the output as a wav 
62              file file by clicking the light blue bang at lower right.
63              
64 tplarson 1.1 EXAMPLE: if using the demo data files, simply turn on DSP and then enter 
65              the following 4 integers at the top of the patch: 1 for degree l, 21 for 
66              radial order n, 1 for azimuthal order m, and 1216 for day number.  do 
67              press enter each time.  once done, click the circle beneath "search for 
68              modes".  at lower right, enter a number for the output level.  once the 
69              fft completes, the sound will play.  it will be quite high.  to hear the 
70              effect of down shifting, enter 4 for the downshift factor.
71              
72              
73              3) skip to the end
74              
75              open example_sum.pd to see an example of how to play 5 modes at once.  
76              first reset the data directory if needed.  set the day number for all 
77              five, and then specify the separate modes along the right edge.  details 
78              can be found in section 5 of the full instructions.