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) :

  • 0 : Metric (m, kN, kPa)
  • 1 : Imperial (ft, kip, ksi)


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) :

  • 0 : as a fluid
  • 1 : at rest
  • 2 : passive
  • 3 : active

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) :

  • 1 : Inactive gallery
  • 2 : Active gallery

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) :

  • 1 : inactive drains top
  • 2 : active drains top

205 +

(n - 1) * 19

Evaluation of top drains efficiency 

Val = integer (default : 1) :

  • 1 : user specified efficiency
  • 2 : efficiency evaluated according to Ransford

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) :

  • 1 : bottom drains inactive
  • 2 : bottom drains active

213 +

(n - 1) * 19

Evaluation of bottom drains efficiency 

Val = integer (default : 1) :

  • 1 : user specified efficiency
  • 2 : efficiency evaluated according to Ransford

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) :

  • 1 : Model 1 (discontinuous)
  • 2 : Model 2 (continuous)
  • 3 : Model 3 (with shear resistance in the tensile zone)

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) :

  • 1 : Model 1 (discontinuous)
  • 2 : Model 2 (continuous)
  • 3 : Model 3 (with shear resistance in the tensile zone)


Section 4: Seismic (commands 500 to 507)


Command

Description

500

Seismic analysis method 

Val = integer (default : 1) :

  • 1 : Seismic coefficient method
  • 2 : Chopra’s method 
  • 3 : Bouaanani & Miquel’s method

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) :

  • 0 : First mode only
  • 1 : Higher modes only
  • 2 : Root Sum Square (RSS)
  • 3 : Sum of first mode plus higher modes 


Section 5: Analysis (commands 600 to 610 and command 699)


Command

Description

600

Analysis type

Val = integer (default : 0) :

  • 0 : Non-linear analysis (cracking)
  • 1 : Linear analysis

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) :

  • 0 : No uplift pressure in cracked segment
  • 1 : Uplift pressure remains unchanged in cracked segment
  • 2 : Full uplift pressure in cracked segment

609

Update of uplift pressure in cracked condition for seismic analysis 

Val = integer (default : 1) :

  • 0 : No uplift pressure in cracked segment
  • 1 : Uplift pressure remains unchanged in cracked segment
  • 2 : Full uplift pressure in cracked segment

610

Update of uplift pressure in cracked condition for post-seismic analysis 

Val = integer (default : 2) :

  • 0 : No uplift pressure in cracked segment
  • 1 : Uplift pressure remains unchanged in cracked segment
  • 2 : Full uplift pressure in cracked segment

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