Available commands for scripts
There are 122 script commands for CADAM3D. They are divided in 8 distinct sections.
Section 0: File, general (commands 0 to 4)
Command |
Description |
0 |
Open a file Val = file name and extension |
1 |
Save file No Value |
2 |
Save as… Val = folder and file name with extension |
3 |
Close file No Value |
4 |
Units Val = (default is 0) :
|
Section 1: Reservoir (commands 100 to 121)
Command |
Description |
100 |
Volumetric weight of water Val = density with corresponding units kN/m3, kip/ft3 |
101 |
Reservoir elevation upstream under normal conditions Val = expected elevation, units m, ft |
102 |
Reservoir elevation downstream under normal conditions Val = expected elevation, units m, ft |
103 |
Reservoir elevation upstream under flood conditions Val = expected elevation, units m, ft |
104 |
Reservoir elevation downstream under flood conditions Val = expected elevation, units m, ft |
105 |
Ice normal load per unit length Val = expected load, units kN/m, kip/ft |
106 |
Ice normal load per unit length on gates Val = expected load, units kN/m, kip/ft |
107 |
Ice normal thickness Val = expected thickness, units = m, ft |
108 |
Ice extreme load per unit length Val = expected load, units kN/m, kip/ft |
109 |
Ice extreme load per unit length on gates Val = expected load, units kN/m, kip/ft |
110 |
Ice extreme thickness Val = expected thickness, units m, ft |
111 |
Ice dynamic compressive strength Val = expected strength, units kPa, ksf |
112 |
Ice thickness – dynamic impact case Val = expected thickness, units m, ft |
113 |
Floating debris force Val = expected force, units = kN/m, kip/ft |
114 |
Point of application of debris load at reservoir surface Val = elevation, units = m, ft |
115 |
Elevation above crest where debris is no longer effective Val = elevation, units = m, ft |
116 |
Sediments elevation Val = expected elevation, units = m, ft |
117 |
Volumetric weight of sediments Val = expected density, units = kN/m3, kip/ft3 |
118 |
Internal friction angle of sediments Val = expected angle, units = deg |
119 |
Assumptions for sediments pressure distribution Val = 0 to 3 (default value : 1) :
|
120 |
Overtopping crest pressure: Percentage of upstream pressure Val = expected percentage, units % (e.g.: 100 for 100%) |
121 |
Overtopping crest pressure: Percentage of downstream pressure Val = expected percentage, units % (e.g.: 100 for 100%) |
Section 2: Model : drainage galleries (commands 201 to 299)
(n=gallery number)
Command |
Description |
201+ (n - 1) * 19 |
Activity Val = integer (default : 1) :
|
202 + (n - 1) * 19 |
X-Coordinate of bottom left corner of gallery Val = numerical value, units = m, ft |
203 + (n - 1) * 19 |
Y-Coordinate of bottom left corner of gallery Val = numerical value, units = m, ft |
204 + (n - 1) * 19 |
Active drains top Val= integer (default : 1) :
|
205 + (n - 1) * 19 |
Evaluation of top drains efficiency Val = integer (default : 1) :
|
206 + (n - 1) * 19 |
Angle of top drain line Val = expected angle, units = degrees |
207 + (n - 1) * 19 |
Shift in X of top drain from the bottom left corner of gallery corner Val = expected coordinate, units = m, ft |
208 + (n - 1) * 19 |
Maximum elevation of top drains Val = expected elevation, units = m, ft |
209 + (n - 1) * 19 |
Efficiency of top drains specified by user Val = numerical value, no units ( 0 < efficiency < 1 ) |
210 + (n - 1) * 19 |
Spacing c/c of top drainage holes Val = expected spacing, units = m, ft |
211 + (n - 1) * 19 |
Diameter of top drainage holes Val = expected diameter, units = m, ft |
212 + (n - 1) * 19 |
Active bottom drains Val = integer (default : 1) :
|
213 + (n - 1) * 19 |
Evaluation of bottom drains efficiency Val = integer (default : 1) :
|
214 + (n - 1) * 19 |
Angle of bottom drain line Val = expected angle, units = degrees |
215 + (n - 1) * 19 |
Shift in X of bottom drain from the bottom left corner of gallery corner Val = expected coordinate, units = m, ft |
216 + (n - 1) * 19 |
Maximum elevation of bottom drains Val = expected elevation, units = m, ft |
217 + (n - 1) * 19 |
Efficiency of bottom drains specified by user Val = numerical value, no units ( 0 < efficiency < 1 ) |
218 + (n - 1) * 19 |
Spacing c/c of bottom drainage holes Val = expected spacing, units = m, ft |
219 + (n - 1) * 19 |
Diameter of bottom drainage holes Val = expected diameter, units = m, ft |
Section 3: Material (commands 300 to 399)
(n=material number; Base material = Total number of materials +1
Command |
Description |
300 |
Concrete volumetric mass Val = expected value, units = kg/m3, lb/ft3 |
301 + (n - 1) * 9 |
Tensile strength material # n Val = expected value, units = kPa, ksf |
302 + (n - 1) * 9 |
Friction angle (peak value) material # n Val = expected value, units = degrees |
303 + (n - 1) * 9 |
Cohesion (peak value) material # n Val = expected value, units = kPa, ksf |
304 + (n - 1) * 9 |
Minimal required compression to activate peak cohesion for material # n Val = expected value, units = kPa, ksf |
305 + (n - 1) * 9 |
Type of model defining maximum shear strength for material # n Val = integer (default : 1) :
|
306 + (n - 1) * 9 |
Residual friction angle material # n Val = expected value, units = degrees |
307 + (n - 1) * 9 |
Residual cohesion material # n Val = expected value, units = kPa, ksf |
308 + (n - 1) * 9 |
Minimal required compression to activate residual cohesion for material # n Val = expected value, units = kPa, ksf |
309 + (n - 1) * 9 |
Type of model defining residual shear strength for material # n Val = integer (default : 1) :
|
Section 4: Seismic (commands 500 to 507)
Command |
Description |
500 |
Seismic analysis method Val = integer (default : 1) :
|
501 |
Peak ground horizontal acceleration Val = expected acceleration, units = g |
502 |
Peak ground vertical acceleration Val = expected acceleration, units = g |
503 |
Peak spectral horizontal acceleration Val = expected spectral acceleration, units = g |
504 |
Sustained vertical acceleration Val = expected sustained acceleration , units = g |
505 |
Sustained horizontal acceleration Val = expected sustained acceleration , units = g |
506 |
Sustained spectral horizontal acceleration Val = expected sustained acceleration , units = g |
507 |
Modal combinations Val = integer (default : 2) :
|
Section 5: Analysis (commands 600 to 610 and command 699)
Command |
Description |
600 |
Analysis type Val = integer (default : 0) :
|
601 |
Crack initiation criterion: Related to tensile strength for normal cases Val = expected coefficient, no units |
602 |
Crack propagation criterion: Related to tensile strength for normal cases Val = expected coefficient, no units |
603 |
Crack initiation criterion: Related to tensile strength for abnormal cases Val = expected coefficient, no units |
604 |
Crack propagation criterion: Related to tensile strength for abnormal cases Val = expected coefficient, no units |
605 |
Crack initiation criterion: Related to tensile strength for extreme cases Val = expected coefficient, no units |
606 |
Crack propagation criterion: Related to tensile strength for extreme cases Val = expected coefficient, no units |
607 |
Dynamic amplification factor for tensile strength Val = amplification factor, no units |
608 |
Update of uplift pressure in cracked condition for static analysis Val = integer (default : 2) :
|
609 |
Update of uplift pressure in cracked condition for seismic analysis Val = integer (default : 1) :
|
610 |
Update of uplift pressure in cracked condition for post-seismic analysis Val = integer (default : 2) :
|
699 |
Start analysis No Value |
Section 6: Loading results (commands 700 to 774)
All results are presented in the form of forces (kN, kip) and moments (kN-m, kip-ft) with respect to the downstream end of the joint. The resultant uplift pressure is also given (normal load) at the joint (kN, kip). No value is required.
Command |
Description |
|
|
700 |
Self-weight: Structure |
|
701 |
Self-weight: Drainage system |
|
702 |
Self-weight: Added volumes |
|
703 |
Self-weight: Added voids |
|
704 |
Self-weight: Concentrated masses |
|
705 |
Self-weight: All |
|
706 |
Hydrostatic upstream – Normal level |
|
707 |
Hydrostatic downstream - Normal level |
|
708 |
Hydrostatic upstream – Bulkhead installed - Normal level |
|
709 |
Hydrostatic downstream - Bulkhead installed - Normal level |
|
710 |
Hydrostatic upstream – Flood level |
|
711 |
Hydrostatic downstream - Flood level |
|
712 |
Sediments |
|
713 |
Sediments - Bulkhead installed |
|
714 |
Ice – Normal case |
|
715 |
Ice – Abnormal case |
|
716 |
Ice - Longitudinal impact |
|
717 |
Ice – Transverse impact |
|
718 |
Floating debris |
|
719 |
Uplift pressure (uncracked) – Normal level |
|
720 |
Uplift pressure (uncracked) – Inefficient drains |
|
721 |
Uplift pressure (uncracked) – Flood level |
|
722 |
Uplift pressure (uncracked) – Seismic case |
|
723 |
Uplift pressure (uncracked) - Bulkhead installed |
|
724 |
Uplift pressure (uncracked) – Post-seismic case |
|
725 |
Post-tension |
|
726 |
Added forces |
|
727 |
Pseudo-static horizontal: Structure |
|
728 |
Pseudo-static horizontal: Drainage system |
|
729 |
Pseudo-static horizontal: Added volumes |
|
730 |
Pseudo-static horizontal: Added voids |
|
731 |
Pseudo-static horizontal: Concentrated masses |
|
732 |
Pseudo-static horizontal: All |
|
733 |
Hydrodynamic horizontal – upstream |
|
734 |
Hydrodynamic horizontal – downstream |
|
735 |
Pseudo-static horizontal: Sediments |
|
736 |
Pseudo-static/ Pseudo-dynamic vertical : Structure |
|
737 |
Pseudo-static / Pseudo-dynamic vertical : Drainage system |
|
738 |
Pseudo-static / Pseudo-dynamic vertical : Added volumes |
|
739 |
Pseudo-static/ Pseudo-dynamic vertical : Added voids |
|
740 |
Pseudo-static/ Pseudo-dynamic vertical : Concentrated masses |
|
741 |
Pseudo-static / Pseudo-dynamic vertical : All volumes, voids and masses |
|
742 |
Hydrodynamic vertical – upstream |
|
743 |
Hydrodynamic vertical - downstream |
|
744 |
Pseudo-static vertical : Sediments |
|
745 |
Horizontal hydrostatic upstream modified |
|
746 |
Horizontal hydrostatic downstream modified |
|
747 |
Normal upstream horizontal hydrostatic – unit undergoing maintenance |
|
748 |
Normal downstream horizontal hydrostatic – unit undergoing maintenance |
|
749 |
Hydrostatic – upstream flood - unit undergoing maintenance |
|
750 |
Hydrostatic – downstream flood - unit undergoing maintenance |
|
751 |
Upstream Hydrodynamic horizontal – water in penstock |
|
752 |
Downstream Hydrodynamic horizontal – water in the intake |
|
753 |
Upstream Hydrodynamic horizontal - unit undergoing maintenance |
|
754 |
Downstream Hydrodynamic horizontal - unit undergoing maintenance |
|
755 |
Hydrodynamique vertical amont - eau de la conduite |
|
756 |
Upstream Hydrodynamic vertical – water in penstock |
|
757 |
Upstream Hydrodynamic vertical - unit undergoing maintenance |
|
758 |
Downstream Hydrodynamic vertical - unit undergoing maintenance |
|
759 |
Upstream fill - normal operating level |
|
760 |
Downstream fill - normal operating level |
|
761 |
Upstream fill - flood operating level |
|
762 |
Downstream fill - flood operating level |
|
763 |
Upstream fill horizontal |
|
764 |
Downstream fill horizontal |
|
765 |
Upstream fill vertical |
|
766 |
Downstream fill vertical |
|
767 |
Pseudo-dynamic : Structure - mode 1 |
|
768 |
Pseudo-dynamic : Structure – higher modes |
|
769 |
Pseudo-dynamic : Hydrodynamic upstream - mode 1 |
|
770 |
Pseudo-dynamic : Hydrodynamic upstream – higher modes |
|
771 |
Pseudo-dynamic : Total - mode 1 |
|
772 |
Pseudo-dynamic : Total – higher modes |
|
773 |
Pseudo-dynamic : RSS – peak acceleration |
|
774 |
Pseudo-dynamic : RSS – sustained acceleration |
Section 7: Load combination results (command 800)
Command |
Description |
800 |
Load combination number, if 0 all combinations are displayed Val = integer, no units The first load combination corresponds to number 1 |