Updated 2017-03-09 23:39:14 by gold

## Introduction edit

gold Here is some Here is some eTCL starter code for calculating tube lengths for pentatonic windchimes from scrap materials. The impetus for these calculations was finding some scrap iron and bamboo on the roadside. Most of the testcases involve replicas or models, using assumptions and rules of thumb.

The eTCL calculator is estimating a pentatonic set from a master length that sounds pleasing. In pseudocode, each new length L1 is [/ \$length0 [ expr { pow([N1/N2],0.5) } ], where N1&N2 are integers and N1 > N2.

### Pseudocode and Equations

`  area = [[* length width ]] # square meters`

### Testcases Section

In planning any software, it is advisable to gather a number of testcases to check the results of the program. The math for the testcases can be checked by pasting statements in the TCL console. Aside from the TCL calculator display, when one presses the report button on the calculator, one will have console show access to the capacity functions (subroutines).

#### Testcase 1

table printed inTCL WIKI format
testcase number: 1
chime 1, master length: 30.
chime N1 integer: 5.
chime N2 integer: 4.
alternate chime from N1/N2 centimeters: 26.8
chime 2, centimeters: 26.8
chime 3, centimeters: 25.9
chime 4, centimeters: 24.4
chime 5, centimeters: 23.7

#### Testcase 2

table printed inTCL WIKI format
testcase number: 2
chime 1, master length: 40.
chime N1 integer: 5.
chime N2 integer: 4.
alternate chime from N1/N2 centimeters: 35.7
chime 2, centimeters: 35.7
chime 3, centimeters: 34.6
chime 4, centimeters: 32.6
chime 5, centimeters: 31.6

#### Testcase 3

table printed inTCL WIKI format
testcase number: 3
chime 1, master length: 100.
chime N1 integer: 5.
chime N2 integer: 4.
alternate chime from N1/N2 centimeters: 89.4
chime 2, centimeters: 89.4
chime 3, centimeters: 86.6
chime 4, centimeters: 81.6
chime 5, centimeters: 79.0

### References:

• Cocquerillat, D. 1968. Palmearies et cultures de l’Enna d’Uruk (559–520).

## Appendix Code edit

### appendix TCL programs and scripts

```        # pretty print from autoindent and ased editor
# wind chime calculator
# written on Windows XP on eTCL
# working under TCL version 8.5.6 and eTCL 1.0.1
# gold on TCL WIKI , 14jun2014
package require Tk
namespace path {::tcl::mathop ::tcl::mathfunc}
frame .frame -relief flat -bg aquamarine4
pack .frame -side top -fill y -anchor center
set names {{} {master length centimeters:} }
lappend names {N1  integer:}
lappend names {N2  integer: }
lappend names {length from N1/N2 centimeters: }
lappend names {length centimeters:}
lappend names {length centimeters: }
lappend names {length centimeters: }
foreach i {1 2 3 4 5 6 7 8} {
label .frame.label\$i -text [lindex \$names \$i] -anchor e
entry .frame.entry\$i -width 35 -textvariable side\$i
set msg "Calculator for Wind Chimes
from TCL WIKI,
written on eTCL "
tk_messageBox -title "About" -message \$msg }
proc calculate {     } {
global side1 side2 side3 side4 side5
global side6 side7 side8 testcase_number
incr testcase_number
set \$side1 [* \$side1 1. ]
set \$side2 [* \$side2 1. ]
set \$side3 [* \$side3 1. ]
set \$side4 [* \$side4 1. ]
set N1 \$side2
set N2 \$side3
set length0 \$side1
set term1 [/ 1. 2. ]
set term2 [/ 5. 4. ]
set term3 [/ 4. 3. ]
set term4 [/ 3. 2. ]
set term5 [/ 8. 5. ]
set term7 [/ \$N1 \$N2 ]
set length2 [/ \$length0 [ expr { pow(\$term2,\$term1) } ] ]
set length3 [/ \$length0 [ expr { pow(\$term3,\$term1) } ] ]
set length4 [/ \$length0 [ expr { pow(\$term4,\$term1) } ] ]
set length5 [/ \$length0 [ expr { pow(\$term5,\$term1) } ] ]
set length6 [/ \$length0 [ expr { pow(\$term7,\$term1) } ] ]
set side4 \$length6
set side5 \$length2
set side6 \$length3
set side7 \$length4
set side8 \$length5
}
proc fillup {aa bb cc dd ee ff gg hh} {
.frame.entry1 insert 0 "\$aa"
.frame.entry2 insert 0 "\$bb"
.frame.entry3 insert 0 "\$cc"
.frame.entry4 insert 0 "\$dd"
.frame.entry5 insert 0 "\$ee"
.frame.entry6 insert 0 "\$ff"
.frame.entry7 insert 0 "\$gg"
.frame.entry8 insert 0 "\$hh"}
proc clearx {} {
foreach i {1 2 3 4 5 6 7 8} {
.frame.entry\$i delete 0 end } }
proc reportx {} {
global side1 side2 side3 side4 side5
global side6 side7 side8 testcase_number
console show;
puts "%|table| printed in|TCL WIKI format |% "
puts "&|testcase number:| \$testcase_number| |& "
puts "&|chime 1,  master length:| \$side1| |& "
puts "&|chime N1 integer: |\$side2| |& "
puts "&|chime N2 integer: |\$side3| |& "
puts "&|alternate chime from N1/N2 centimeters: | \$side4| |& "
puts "&|chime 2, centimeters: |\$side5| |& "
puts "&|chime 3, centimeters: |\$side6| |& "
puts "&|chime 4, centimeters: | \$side7| |& "
puts "&|chime 5, centimeters: | \$side8| |& "
}
frame .buttons -bg aquamarine4
::ttk::button .calculator -text "Solve" -command { calculate   }
::ttk::button .test2 -text "Testcase1" -command {clearx;fillup 30. 5. 4.  26.8 26.8  25.8 24.5 23.7 }
::ttk::button .test3 -text "Testcase2" -command {clearx;fillup 40. 5.  4.  26.8 35.7  34.6 32.65 31.6 }
::ttk::button .test4 -text "Testcase3" -command {clearx;fillup 100. 5. 4.  26.8 89.4  86.6 81.6 79.05 }
::ttk::button .clearallx -text clear -command {clearx }
::ttk::button .cons -text report -command { reportx }
::ttk::button .exit -text exit -command {exit}
pack  .clearallx .cons .about .exit .test4 .test3 .test2   -side bottom -in .buttons
grid .frame .buttons -sticky ns -pady {0 10}
. configure -background aquamarine4 -highlightcolor brown -relief raised -border 30
wm title . "Wind Chime Calculator "       ```

### Pushbutton Operation

For the push buttons, the recommended procedure is push testcase and fill frame, change first three entries etc, push solve, and then push report. Report allows copy and paste from console.

For testcases in a computer session, the eTCL calculator increments a new testcase number internally, eg. TC(1), TC(2) , TC(3) , TC(N). The testcase number is internal to the calculator and will not be printed until the report button is pushed for the current result numbers (which numbers will be cleared on the next solve button.) The command { calculate; reportx } or { calculate ; reportx; clearx } can be added or changed to report automatically. Another wrinkle would be to print out the current text, delimiters, and numbers in a TCL wiki style table as
```  puts " %| testcase \$testcase_number | value| units |comment |%"
puts " &| volume| \$volume| cubic meters |based on length \$side1 and width \$side2   |&"  ```