Skip to content

Latest commit

 

History

History
130 lines (99 loc) · 8.9 KB

INPUT_FILE_FORMAT.md

File metadata and controls

130 lines (99 loc) · 8.9 KB

Input File Format

The following document will provide users with the specification for the input file format which can be used to quickly fill in the VDisp GUI.

Notation

  • field:Type means field must be of type Type.

  • field:Type{value1, value2, ...} means field must be of type Type, and its value must be one of [value1, value2, ...].

  • field:Type[a, b] means field must be of type Type, and its value must be in range [a,b]. Round-brackets, (), will be used to indicate the boundary is exclusive, while square-brackets, [], will be used to indicate the boundary is inclusive.

  • field:Type(+) means field must be of type Type, and its value must be positive.

For more info on Julia types, see our Getting Started With Julia Guide.

Format

For all VDisp input files, the "body" of the input file remains the same and is specified as follows:

Line 1 > title:String
Line 2 > method:Int{0, 1, 2}, unitSystem:Int{0, 1}
Line 3 > foundationType:Int{0, 1}, foundationLength:Float(+), foundationWidth:Float(+)
Line 4 > appliedPressure:Float(+), forcePoint:Int{0, 1} 
Line 5 > outputIncrements:Int{0, 1}, saturationAboveWaterTable:Int{0, 1}
Line 6 > materials:Int(+)
Line 7 (Repeat for each material) > materialIndex:Int[0, materials), materialName:String, specificGravity:Float(+), voidRatio:Float(+), waterContent:Float[0,100] 
Line 8 > totalDepth:Float(+)
Line 9 > depthToFoundation:Float(+), depthToGroundWaterTable:Float(+)
Line 10 > 0, layerBoundary1Depth:Float(+), layerBoundary2Depth:Float(+), ... , totalDepth
Line 11 > materialIndexLayer1:Int[0, materials),  materialIndexLayer2:Int[0, materials), ...
Line 12 > subdivisionsLayer1:Int(+), subdivisionsLayer1:Int(+), ...

Line 10 must have materials+2 entries, with the first entry being 0 and the last being totalDepth. Lines 11 and 12 must have materials entries.

Next comes the “method specific” part of the input file. The format depends on the choice for method and the options are specified as follows:

0 — Consolidation / Swell

Line 13 > heaveBeginDepth:Float[0, heaveActiveDepth), heaveActiveDepth:Float(heaveBeginDepth, totalDepth)
Line 14 (Repeat for each material) > materialIndex:Int[0, materials), swellPressure:Float(+), swellIndex:Float(+), compressionIndex:Float(+), maxPastPressure:Float(+)

maxPastPressure is also known as “Preconsolidation Pressure”

1 — Schmertmann

Line 13 > yearsAfterConstruction:Int(+)
Line 14 (Repeat for each material) > materialIndex:Int[0, materials), conePenetrationResistance:Float(+)

2 — Schmertmann Elastic

Line 13 > yearsAfterConstruction:Int(+)
Line 14 (Repeat for each material) > materialIndex:Int[0, materials), elasticModulus:Float(+)

Descriptions

Field Description Units (Metric/Imperial)
title Title of Problem N/A
method Calculation Method.
0 - Consolidation / Swell
1 - Schmertmann
2 - Schmertmann Elastic		 N/A
units Unit System.
0 - Metric
1 - Imperial		 N/A
foundation Foundation Type.
0 - Rectangular Slab
1 - Long Strip Footing		 N/A
foundationLength Length of Foundation m/ft
foundationWidth Width of Foundation m/ft
appliedPressure Pressure Applied on Foundation Pa/tsf
forcePoint Point at Which Force is Applied
0 - Center
1 - Edge/Corner		 N/A
outputIncrements 0 - Output File Will Show Only Total Settlements
1 - Output File Will Show Settlements at Each Depth Increment		 N/A
saturationAboveWaterTable 0 - Hydrostatic Above Water Table
1 - Saturated Above Water Table		 N/A
materials Number of Materials (Soil Layers) N/A
materialIndex Unique Index Value Associated With Each Material N/A
specificGravity Specific Gravity of Material unitless
voidRatio Void Ratio of Material unitless
waterContent Water Content of Material %
totalDepth Total Depth of Soil Profile m/ft
depthToFoundation Depth to Foundation Base m/ft
depthToGroundWaterTable Depth to Ground Water Table m/ft
layerBoundaryiDepth Depth of Boundary Between Layer (i-1) and Layer i m/ft
subdivisionsLayeri Subdivisions of Layer i N/A
heaveBeginDepth Depth From Ground Surface to Where Heave Active Zone Begins m/ft
heaveActiveDepth Depth of Heave Active Zone m/ft
swellPressure Swell Pressure of Material Pa/tsf
swellIndex Swell Index of Material unitless
compressionIndex Compression Index of Material unitless
maxPastPressure Max Past Pressure (aka Preconsolidation Pressure) of Material Pa/tsf
yearsAfterConstruction Time in Years After Construction years
conePenetrationResistance Cone Penetration Resistance of Material KPa/tsf
elasticModulus Elastic Modulus of Material KPa/tsf

Notes

  • Comments: Comments can be placed in input files using the # character. These work exactly like comments in Python or Julia.

  • Whitespace: Any amount of whitespace can be left between fields, as long as rows appear in same order and every field is presented in its corresponding row.

Sample Input File

This is a sample input file, taken from the test cases for VDisp:

# Input file for GUI
Problem 1 - Consolidation/Swell
0,1
0,3.00,3.00
1.00,0

1,1  # Outpt Increments, Saturated Above Water TAble

2
1,Sand,2.6,0.9,20   # Interesting material names!
2,Dirt,2.3,1.35,35

16.0
7.5,15.0
0,12.0,16.0
1,2
12,4

0.0,8.0
1,2,0.1,0.3,2
2,3,0.15,0.35,3