Skip to main content
JSON Manual Created Edited

Story Drift(X,Y,Combine) - Story Result Table

Input URI

{base url} + post/TABLE



Active Methods

POST



JSON Schema

Details



Request Examples

Story Drift- X

{
   "Argument": {
       "TABLE_TYPE": "STORY_DRIFT_X",
       "UNIT": {
           "FORCE": "KN",
           "DIST": "MM"
       },
       "LOAD_CASE_NAMES": [
           "RX(RS)"
       ],
       "STYLES": {
           "FORMAT": "FIXED",
           "PLACE": 6
       },
       "ADDITIONAL": {
           "SET_STORY_DRIFT_PARAMS": {
               "RESPONSE_MOD_FACTOR_CHECK": false,
               "DEFLECTION_AMPL_FACTOR_VALUE": 3.0,
               "IMPORTANCE_FACTOR_VALUE": 1.2,
               "SCALE_FACTOR_VALUE": 1.0,
               "ALLOWABLE_RATIO": 0.02,
               "LCOMS": [
                {
                   "NAME": "DL",
                   "FACTOR": 1.0
                }, {
                   "NAME": "LL",
                   "FACTOR": 0.5
                }
               ],
               "BETA": {
                   "FIX_USER_CHECK": "USER",
                   "NAME_FROM": "1F",
                   "NAME_TO": "3F",
                   "VALUE": 1.0
               }
           }
       }
   }
}

Story Drift- Y

{
    "Argument": {
        "TABLE_TYPE": "STORY_DRIFT_Y",
        "UNIT": {
            "FORCE": "KN",
            "DIST": "M"
        },
        "LOAD_CASE_NAMES": [
            "EY(ST)"
        ],
        "STYLES": {
            "FORMAT": "FIXED",
            "PLACE": 10
        },
        "ADDITIONAL": {
            "SET_STORY_DRIFT_PARAMS": {
                "RESPONSE_MOD_FACTOR_CHECK": true,
                "RESPONSE_MOD_FACTOR_VALUE": 3,
                "SCALE_FACTOR_VALUE": 4.0,
                "ALLOWABLE_RATIO": 0.03
            }
        }
    }
}

Story Drift- Comb

{
    "Argument": {
        "EXPORT_PATH": "D:\00.2023년\00.9월\Output.JSON",
        "TABLE_TYPE": "STORY_DRIFT_COMB",
        "LOAD_CASE_NAMES": [
            "RX(RS)",
            "RY(RS)"
        ],
        "STYLES": {
            "FORMAT": "Fixed",
            "PLACE": 4
        },
        "ADDITIONAL": {
            "SET_STORY_DRIFT_PARAMS": {
                "RESPONSE_MOD_FACTOR_CHECK": true,
                "RESPONSE_MOD_FACTOR_VALUE": 3,
                "SCALE_FACTOR_VALUE": 4.0,
                "ALLOWABLE_RATIO": 0.03
            },
            "SET_STORY_DRIFT_CALCULATION_METHOD": {
                "DRIFT_AT_THE_CENTER_OF_MASS": true,
                "AVERAGE_DRIFT_OF_VERTICAL_ELEMENTS": true,
                "DRIFT_OF_A_VERTICAL_LINE_ON_SELECTED_NODE": {
                    "X-DIR": 109
                },
                "AVERAGE_DRIFT_OF_VERTICAL_LINES_ON_SELECTED_NODES": {
                    "X-DIR": [
                        262,
                        260
                    ]
                },
                "SHEAR_WEIGHTED_AVERAGE_DRIFT_OF_VERTICAL_ELEMENTS": true
            }
        }
    }
}  


Response Examples

Story Drift- X

{
   "empty": {
       "FORCE": "KN",
       "DIST": "MM",
       "HEAD": [
           "Index",
           "Load Case",
           "Story",
           "Story Height",
           "P-Delta Incremental Factor",
           "Allowable Story Drift Ratio",
           "Maximum Drift of All Vertical Elements/Node",
           "Maximum Drift of All Vertical Elements/Story Drift",
           "Maximum Drift of All Vertical Elements/Modified Drift",
           "Maximum Drift of All Vertical Elements/Story Drift Ratio",
           "Maximum Drift of All Vertical Elements/Remark",
           "Drift at the Center of Mass/Story Drift",
           "Drift at the Center of Mass/Modified Drift",
           "Drift at the Center of Mass/Drift Factor",
           "Drift at the Center of Mass/Story Drift Ratio",
           "Drift at the Center of Mass/Remark"
       ],
       "DATA": [
           [
               "1",
               "RX(RS)",
               "3F",
               "4000.000000",
               "1.000000",
               "0.020000",
               "21",
               "1.998633",
               "4.996583",
               "0.001249",
               "OK",
               "1.998633",
               "4.996583",
               "1.000000",
               "0.001249",
               "OK"
           ],
           [
               "2",
               "RX(RS)",
               "2F",
               "4000.000000",
               "1.000000",
               "0.020000",
               "9",
               "4.091659",
               "10.229148",
               "0.002557",
               "OK",
               "4.091659",
               "10.229148",
               "1.000000",
               "0.002557",
               "OK"
           ],
           [
               "3",
               "RX(RS)",
               "1F",
               "5000.000000",
               "1.135033",
               "0.020000",
               "1",
               "10.375067",
               "29.440113",
               "0.005888",
               "OK",
               "10.375067",
               "29.440113",
               "1.000000",
               "0.005888",
               "OK"
           ]
       ]
   }
}

Story Drift- Y

{
    "Empty": {
        "FORCE": "KN",
        "DIST": "M",
        "HEAD": [
            "Index",
            "LoadCase",
            "Story",
            "StoryHeight",
            "P-DeltaIncrementalFactor",
            "AllowableStoryDriftRatio",
            "MaximumDriftofAllVerticalElements/Node",
            "MaximumDriftofAllVerticalElements/StoryDrift",
            "MaximumDriftofAllVerticalElements/ModifiedDrift",
            "MaximumDriftofAllVerticalElements/StoryDriftRatio",
            "MaximumDriftofAllVerticalElements/Remark",
            "DriftattheCenterofMass/StoryDrift",
            "DriftattheCenterofMass/ModifiedDrift",
            "DriftattheCenterofMass/DriftFactor",
            "DriftattheCenterofMass/StoryDriftRatio",
            "DriftattheCenterofMass/Remark"
        ],
        "DATA": [
            [
                "1",
                "EY",
                "12F",
                "4.0000000000",
                "-",
                "0.0300000000",
                "0",
                "0.0000000000",
                "0.0000000000",
                "0.0000000000",
                "OK",
                "0.0000000000",
                "0.0000000000",
                "0.0000000000",
                "0.0000000000",
                "OK"
            ],
            [
                "2",
                "EY",
                "11F",
                "4.0000000000",
                "-",
                "0.0300000000",
                "0",
                "0.0000000000",
                "0.0000000000",
                "0.0000000000",
                "OK",
                "0.0000000000",
                "0.0000000000",
                "0.0000000000",
                "0.0000000000",
                "OK"
            ],
            [
                "3",
                "EY",
                "10F",
                "4.0000000000",
                "-",
                "0.0300000000",
                "0",
                "0.0000000000",
                "0.0000000000",
                "0.0000000000",
                "OK",
                "0.0000000000",
                "0.0000000000",
                "0.0000000000",
                "0.0000000000",
                "OK"
            ],
            [
                "4",
                "EY",
                "9F",
                "4.0000000000",
                "-",
                "0.0300000000",
                "0",
                "0.0000000000",
                "0.0000000000",
                "0.0000000000",
                "OK",
                "0.0000000000",
                "0.0000000000",
                "0.0000000000",
                "0.0000000000",
                "OK"
            ],
            [
                "5",
                "EY",
                "8F",
                "4.0000000000",
                "-",
                "0.0300000000",
                "0",
                "0.0000000000",
                "0.0000000000",
                "0.0000000000",
                "OK",
                "0.0000000000",
                "0.0000000000",
                "0.0000000000",
                "0.0000000000",
                "OK"
            ],
            [
                "6",
                "EY",
                "7F",
                "4.0000000000",
                "-",
                "0.0300000000",
                "0",
                "0.0000000000",
                "0.0000000000",
                "0.0000000000",
                "OK",
                "0.0000000000",
                "0.0000000000",
                "0.0000000000",
                "0.0000000000",
                "OK"
            ],
            [
                "7",
                "EY",
                "6F",
                "4.0000000000",
                "-",
                "0.0300000000",
                "0",
                "0.0000000000",
                "0.0000000000",
                "0.0000000000",
                "OK",
                "0.0000000000",
                "0.0000000000",
                "0.0000000000",
                "0.0000000000",
                "OK"
            ],
            [
                "8",
                "EY",
                "5F",
                "4.0000000000",
                "-",
                "0.0300000000",
                "0",
                "0.0000000000",
                "0.0000000000",
                "0.0000000000",
                "OK",
                "0.0000000000",
                "0.0000000000",
                "0.0000000000",
                "0.0000000000",
                "OK"
            ],
            [
                "9",
                "EY",
                "4F",
                "4.0000000000",
                "-",
                "0.0300000000",
                "0",
                "0.0000000000",
                "0.0000000000",
                "0.0000000000",
                "OK",
                "0.0000000000",
                "0.0000000000",
                "0.0000000000",
                "0.0000000000",
                "OK"
            ],
            [
                "10",
                "EY",
                "3F",
                "4.5000000000",
                "-",
                "0.0300000000",
                "0",
                "0.0000000000",
                "0.0000000000",
                "0.0000000000",
                "OK",
                "0.0000000000",
                "0.0000000000",
                "0.0000000000",
                "0.0000000000",
                "OK"
            ],
            [
                "11",
                "EY",
                "2F",
                "4.5000000000",
                "-",
                "0.0300000000",
                "0",
                "0.0000000000",
                "0.0000000000",
                "0.0000000000",
                "OK",
                "0.0000000000",
                "0.0000000000",
                "0.0000000000",
                "0.0000000000",
                "OK"
            ],
            [
                "12",
                "EY",
                "1F",
                "5.0000000000",
                "-",
                "0.0300000000",
                "0",
                "0.0000000000",
                "0.0000000000",
                "0.0000000000",
                "OK",
                "0.0000000000",
                "0.0000000000",
                "0.0000000000",
                "0.0000000000",
                "OK"
            ]
        ]
    }
}

Story Drift- Comb

{
    "Empty": {
        "FORCE": "KN",
        "DIST": "M",
        "HEAD": [
            "Index",
            "Load Case",
            "Story",
            "Story Height",
            "P-Delta Incremental Factor",
            "Allowable Story Drift Ratio",
            "Maximum Drift of All Vertical Elements/Shear-Weighted Average Drift of Vertical Elements",
            "Maximum Drift of All Vertical Elements/Node",
            "Maximum Drift of All Vertical Elements/Story Drift",
            "Maximum Drift of All Vertical Elements/Modified Drift",
            "Maximum Drift of All Vertical Elements/Story Drift Ratio",
            "Drift at the Center of Mass/Remark",
            "Drift at the Center of Mass/Story Drift",
            "Drift at the Center of Mass/Modified Drift",
            "Drift at the Center of Mass/Drift Factor",
            "Drift at the Center of Mass/Story Drift Ratio",
            "Average Drift of Vertical Elements/Remark",
            "Average Drift of Vertical Elements/Story Drift",
            "Average Drift of Vertical Elements/Modified Drift",
            "Average Drift of Vertical Elements/Drift Factor",
            "Average Drift of Vertical Elements/Story Drift Ratio",
            "Drift of a Vertical Line on Selected Node/Remark",
            "Drift of a Vertical Line on Selected Node/Story Drift",
            "Drift of a Vertical Line on Selected Node/Modified Drift",
            "Drift of a Vertical Line on Selected Node/Drift Factor",
            "Drift of a Vertical Line on Selected Node/Story Drift Ratio",
            "Average Drift of Vertical Lines on Selected Nodes/Remark",
            "Average Drift of Vertical Lines on Selected Nodes/Story Drift",
            "Average Drift of Vertical Lines on Selected Nodes/Modified Drift",
            "Average Drift of Vertical Lines on Selected Nodes/Drift Factor",
            "Average Drift of Vertical Lines on Selected Nodes/Story Drift Ratio"
        ],
        "DATA": [
            [
                "1",
                "RX(RS)",
                "1F",
                "6.0000",
                "-",
                "0.0300",
                "48",
                "0.0042",
                "0.0505",
                "0.0084",
                "OK",
                "0.0041",
                "0.0487",
                "1.0379",
                "0.0081",
                "OK",
                "0.0041",
                "0.0489",
                "1.0333",
                "0.0082",
                "OK",
                "-",
                "-",
                "-",
                "-",
                "-",
                "0.0339",
                "0.4074",
                "0.1240",
                "0.0679",
                "NG"
            ],
            [
                "2",
                "RX(RS)",
                "B1",
                "8.2000",
                "-",
                "0.0300",
                "104",
                "0.0031",
                "0.0368",
                "0.0045",
                "OK",
                "0.0031",
                "0.0366",
                "1.0042",
                "0.0045",
                "OK",
                "0.0030",
                "0.0362",
                "1.0155",
                "0.0044",
                "OK",
                "-",
                "-",
                "-",
                "-",
                "-",
                "37.7772",
                "453.3261",
                "0.0001",
                "55.2837",
                "NG"
            ],
            [
                "3",
                "RY(RS)",
                "1F",
                "6.0000",
                "1.0000",
                "0.0300",
                "48",
                "0.0048",
                "0.0574",
                "0.0096",
                "OK",
                "0.0032",
                "0.0383",
                "1.4985",
                "0.0064",
                "OK",
                "0.0033",
                "0.0398",
                "1.4444",
                "0.0066",
                "OK",
                "-",
                "-",
                "-",
                "-",
                "-",
                "0.0269",
                "0.3225",
                "0.1781",
                "0.0538",
                "NG"
            ],
            [
                "4",
                "RY(RS)",
                "B1",
                "8.2000",
                "1.0000",
                "0.0300",
                "104",
                "0.0032",
                "0.0389",
                "0.0047",
                "OK",
                "0.0023",
                "0.0274",
                "1.4203",
                "0.0033",
                "OK",
                "0.0018",
                "0.0218",
                "1.7866",
                "0.0027",
                "OK",
                "-",
                "-",
                "-",
                "-",
                "-",
                "3345.3568",
                "40144.2820",
                "0.0000",
                "4895.6442",
                "NG"
            ]
        ]
    }
}  


Specifications

No. Description Key Value Type Default Required

1

Table Name

 • Response Table Title

"TABLE_NAME"

String

Empty

Optional

2

Result Table Type

 • X-Direction: "STORY_DRIFT_X"

 • Y-Direction: "STORY_DRIFT_Y"

 • XY-Direction : "STORY_DRIFT_COMB"

"TABLE_TYPE"

String

-

Required

3

Result Table Save Path

"EXPORT_PATH"

String

-

Optional

4

Response Unit Setting

"UNIT"

Object

System

Optional

(1)

Force

"FORCE"

String

-

Optional

(2)

Length

"DIST"

String

-

Optional

(3)

Heat

"HEAT"

String

-

Optional

(4)

Temperature

"TEMP"

String

-

Optional

5

Response Number Format

"STYLES"

Object

System

Optional

(1)

Number Format

 • "Default"

 • "Fixed"

 • "Scientific"

 • "General"

"FORMAT"

String

-

Optional

(2)

Digit Place

 • 0 to 15

"PLACE"

Integer

-

Optional

6

Components of Result Table

"COMPONENTS"

Array [String]

-

Read Only

7

Load Name & Type

 • Static Load Cases

   ◦ NAME + "(ST)"

 • Load Combinations

    ◦ NAME + "(CB)"

 • Response Spectrum

    ◦ NAME + "(RS)"

    ◦ NAME + "(ES)"

"LOAD_CASE_NAMES"

Array [String]

All

Optional

8

Additional Setting

"ADDITIONAL"

Object

-

Optional

(1)

Set Story Drift Parameters Setting

"SET_STORY_DRIFT_PARAMS"

Object

-

Optional

i. Set Modification Story Drift Method

 • True : Set Response Modification method (Go to Method 1)

 • False : Set Deflect Amplification Factor (Cd) method Method 2)

"RESPONSE_MOD_FACTOR_CHECK"

Boolean

false

Optional

Method 1 : Set Response Modification method

ii. Response Modification Coefficient

 • When only set "RESPONSE_MOD_FACTOR_CHECK": true

"RESPONSE_MOD_FACTOR_VALUE"

Number

1

Optional

iii. Scale Factor Value

"SCALE_FACTOR_VALUE"

Number

1

Optional

iV. Allowable Ratio

"ALLOWABLE_RATIO"

Number

0.015

Optional

Method 2 : Set Deflect Amplification Factor (Cd) method

ii. Deflection Amplification Factor Value (Cd)

 • When only set "RESPONSE_MOD_FACTOR_CHECK": false

"DEFLECTION_AMPL_FACTOR_VALUE"

Number

1

Optional

iii. Importance Factor Value

"IMPORTANCE_FACTOR_VALUE"

Number

1.5

Optional

iV. Scale Factor Value

"SCALE_FACTOR_VALUE"

Number

1

Optional

V. Allowable Ratio Ratio

"ALLOWABLE_RATIO"

Number

0.015

Optional

Vi. Set Vertical Load Combination for defining a vertical load condition to consider the P-Delta effect

"LCOMS"

Array

[Object]

 

Optional

(1)

Vertical Load Case Name

"NAME"

String

 

Optional

(2)

Vertical Load Factor

"FACTOR"

Number

 

Optional

Vii. Define Beta value

"BETA"

Object

 

Optional

(1)

Beta value method

 • "FIXED" : fixed value, 1.0

 • "USER" : user defined values for each story can be directly entered

"FIX_USER_CHECK"

String

"FIXED"

Optional

(2)

Set Start Story to use beta value

 • When only set "FIX_USER_CHECK": "USER"

"NAME_FROM"

String

-

Optional

(3)

Set End Story to use beta value

 • When only set "FIX_USER_CHECK": "USER"

"NAME_TO"

String

-

Optional

(4)

User defined beta value

 • When only set "FIX_USER_CHECK": "USER

"VALUE"

Number

0

Optional

(2)

Set Additional Story Drift Calculation Method

 • "DRIFT_AT_THE_CENTER_OF_MASS"

 • "AVERAGE_DRIFT_OF_VERTICAL_ELEMENTS"

 • "DRIFT_OF_A_VERTICAL_LINE_ON_SELECTED_NODE"

 • "AVERAGE_DRIFT_OF_VERTICAL_LINES_ON_SELECTED_NODES"

 • "SHEAR_WEIGHTED_AVERAGE_DRIFT_OF_VERTICAL_ELEMENTS"

"SET_STORY_DRIFT_CALCULATION_METHOD"

Object [String]

"DRIFT_AT_THE_CENTER_OF_MASS"

Optional

i. Drift at the Center of Mass "DRIFT_AT_THE_CENTER_OF_MASS"

Boolean

true

Optional

ii. Average Drift of Vertical Elements "AVERAGE_DRIFT_OF_VERTICAL_ELEMENTS"

Boolean

false

Optional

iii. Drift of a Vertical Line on Selected Node "DRIFT_OF_A_VERTICAL_LINE_ON_SELECTED_NODE"

Object

[String]

-

Optional

(1) X Direction

"X_DIR"

Integer

-

Required

(2) Y Direction

"Y_DIR"

Integer

-

Required

(3) Combined

"COMBINED"

Integer

-

Required

iV. Average Drift of Vertical Lines on Selected Nodes

"AVERAGE_DRIFT_OF_VERTICAL_LINES_ON_SELECTED_NODES"

Array

[Object]

-

Optional

(1) X Direction

"X_DIR"

Array [Integer]

-

Required

(2) Y Direction

"Y_DIR"

Array [Integer]

-

Required

(3) Combined

"COMBINED"

Array [Integer]

-

Required

V. Shear-Weighted Average Drift of Vertical Elements

"SHEAR_WEIGHTED_AVERAGE_DRIFT_OF_VERTICAL_ELEMENTS"

Boolean

false

Optional

0
Was this article helpful?