Skip to main content
JSON Manual Created Edited

DESIGN/STEEL/KDS-41-30-2022/DREULT : Steel Design Result

Input URI

{base url} + DESIGN/STEEL/KDS-41-30-2022/DREULT



Active Methods

POST



JSON Schema

Details

{
  "type": "object",
  "required": [
    "Argument"
  ],
  "additionalProperties": false,
  "properties": {
    "Argument": {
      "type": "object",
      "required": [
        "EXPORT_PATH",
        "RESULT_GRAPHIC"
      ],
      "additionalProperties": false,
      "properties": {
        "EXPORT_PATH": {
          "type": "string",
          "description": "Image file save path and file name."
        },
        "FIGURE_NAME": {
          "type": "string",
          "description": "Smart report image name."
        },
        "SET_HIDDEN": {
          "type": "boolean",
          "description": "Hidden option.",
          "default": false
        },
        "ACTIVE": {
          "type": "object",
          "description": "View/Active settings. For detailed field specifications, refer to the Active documentation."
        },
        "WIDTH": {
          "type": "integer",
          "description": "Image width in pixels.",
          "default": 1000,
          "minimum": 100,
          "maximum": 10000
        },
        "HEIGHT": {
          "type": "integer",
          "description": "Image height in pixels.",
          "default": 1000,
          "minimum": 100,
          "maximum": 10000
        },
        "STAGE_NAME": {
          "type": "string",
          "description": "Construction stage name."
        },
        "ANGLE": {
          "type": "object",
          "description": "View angle settings.",
          "required": [],
          "additionalProperties": false,
          "properties": {
            "HORIZONTAL": {
              "type": "number",
              "description": "Horizontal rotation angle.",
              "default": 0
            },
            "VERTICAL": {
              "type": "number",
              "description": "Vertical rotation angle.",
              "default": 0
            }
          }
        },
        "DISPLAY": {
          "type": "object",
          "description": "View/Display settings. For detailed field specifications, refer to the Display documentation."
        },
        "PERSPECTIVE": {
          "type": "boolean",
          "description": "Enable perspective view.",
          "default": false
        },
        "ZOOM_LEVEL": {
          "type": "number",
          "description": "Zoom level.",
          "default": 100,
          "minimum": 25,
          "maximum": 200
        },
        "BGCOLOR_TOP": {
          "type": "object",
          "description": "Top background color.",
          "additionalProperties": false,
          "properties": {
            "R": {
              "type": "integer",
              "description": "Red component.",
              "minimum": 0,
              "maximum": 255
            },
            "G": {
              "type": "integer",
              "description": "Green component.",
              "minimum": 0,
              "maximum": 255
            },
            "B": {
              "type": "integer",
              "description": "Blue component.",
              "minimum": 0,
              "maximum": 255
            }
          }
        },
        "RESULT_GRAPHIC": {
          "type": "object",
          "description": "Result graphic display settings.",
          "required": [
            "CURRENT_MODE",
            "LOAD_CASE_COMB"
          ],
          "additionalProperties": false,
          "properties": {
            "CURRENT_MODE": {
              "type": "string",
              "description": "Current mode.",
              "oneOf": [
                {
                  "title": "Steel Design",
                  "const": "INFLL_DESIGN_STEEL"
                }
              ]
            },
            "LOAD_CASE_COMB": {
              "type": "object",
              "description": "Load cases and combinations.",
              "required": [
                "TYPE",
                "NAME"
              ],
              "additionalProperties": false,
              "properties": {
                "TYPE": {
                  "type": "string",
                  "description": "Load case type.",
                  "oneOf": [
                    {
                      "title": "Steel Design Load Combination",
                      "const": "CBS"
                    }
                  ]
                },
                "NAME": {
                  "type": "string",
                  "description": "Load case or combination name."
                }
              }
            },
            "COMPONENTS": {
              "type": "object",
              "description": "Component selection for design result display.",
              "required": [],
              "additionalProperties": false,
              "properties": {
                "COMP": {
                  "type": "string",
                  "description": "Design component to display.",
                  "default": "Combined",
                  "oneOf": [
                    {
                      "title": "Axial",
                      "const": "Axial"
                    },
                    {
                      "title": "Shear-y",
                      "const": "Shear-y"
                    },
                    {
                      "title": "Shear-z",
                      "const": "Shear-z"
                    },
                    {
                      "title": "Bend-y",
                      "const": "Bend-y"
                    },
                    {
                      "title": "Bend-z",
                      "const": "Bend-z"
                    },
                    {
                      "title": "Combined",
                      "const": "Combined"
                    }
                  ]
                }
              }
            },
            "TYPE_OF_DISPLAY": {
              "type": "object",
              "description": "Display options for design result visualization.",
              "required": [],
              "additionalProperties": false,
              "properties": {
                "CONTOUR": {
                  "type": "object",
                  "description": "Contour display settings.",
                  "required": [],
                  "additionalProperties": false,
                  "properties": {
                    "OPT_CHECK": {
                      "type": "boolean",
                      "description": "Enable contour display.",
                      "default": false
                    },
                    "NUM_OF_COLOR": {
                      "type": "integer",
                      "description": "Number of contour colors.",
                      "default": 12,
                      "minimum": 2,
                      "maximum": 20
                    },
                    "COLOR_TYPE": {
                      "type": "string",
                      "description": "Contour color type.",
                      "default": "vrgb",
                      "oneOf": [
                        {
                          "title": "V->R->G->B",
                          "const": "vrgb"
                        },
                        {
                          "title": ">R->G->B",
                          "const": "rgb"
                        },
                        {
                          "title": "R->B->G",
                          "const": "rbg"
                        },
                        {
                          "title": "Gray Scaled",
                          "const": "gray scaled"
                        }
                      ]
                    },
                    "OPTIONS": {
                      "type": "object",
                      "description": "Contour options.",
                      "required": [],
                      "additionalProperties": false,
                      "properties": {
                        "GRADIENT_FILL": {
                          "type": "boolean",
                          "description": "Use gradient fill.",
                          "default": false
                        },
                        "CONTOUR_FILL": {
                          "type": "boolean",
                          "description": "Use contour fill.",
                          "default": true
                        }
                      }
                    }
                  }
                },
                "VALUES": {
                  "type": "object",
                  "description": "Value display settings.",
                  "required": [],
                  "additionalProperties": false,
                  "properties": {
                    "OPT_CHECK": {
                      "type": "boolean",
                      "description": "Enable value display.",
                      "default": false
                    },
                    "DECIMAL_PT": {
                      "type": "integer",
                      "description": "Decimal places.",
                      "default": 0,
                      "minimum": 0,
                      "maximum": 15
                    },
                    "VALUE_EXP": {
                      "type": "boolean",
                      "description": "Use exponential notation.",
                      "default": false
                    },
                    "MINMAX_ONLY": {
                      "type": "object",
                      "description": "Min/max display settings.",
                      "required": [],
                      "additionalProperties": false,
                      "properties": {
                        "MAXMIN": {
                          "type": "string",
                          "description": "Min/max display mode.",
                          "default": "Min & Max",
                          "oneOf": [
                            {
                              "title": "Min. & Max",
                              "const": "Min & Max"
                            },
                            {
                              "title": "Absolut Max",
                              "const": "Abs Max"
                            },
                            {
                              "title": "Maximum",
                              "const": "max"
                            },
                            {
                              "title": "MMinimumin",
                              "const": "min"
                            }
                          ]
                        },
                        "LIMIT_SCALE": {
                          "type": "integer",
                          "description": "Scale limit.",
                          "default": 0
                        }
                      }
                    },
                    "SET_ORIENT": {
                      "type": "integer",
                      "description": "Value text orientation.",
                      "default": 0
                    }
                  }
                },
                "LEGEND": {
                  "type": "object",
                  "description": "Legend display settings.",
                  "required": [],
                  "additionalProperties": false,
                  "properties": {
                    "OPT_CHECK": {
                      "type": "boolean",
                      "description": "Enable legend display.",
                      "default": false
                    },
                    "POSITION": {
                      "type": "string",
                      "description": "Legend position.",
                      "default": "left",
                      "oneOf": [
                        {
                          "title": "Right",
                          "const": "right"
                        },
                        {
                          "title": "Left",
                          "const": "left"
                        },
                        {
                          "title": "Top",
                          "const": "top"
                        },
                        {
                          "title": "Bottom",
                          "const": "bottom"
                        }
                      ]
                    },
                    "VALUE_EXP": {
                      "type": "boolean",
                      "description": "Use exponential notation for legend values.",
                      "default": true
                    },
                    "DECIMAL_PT": {
                      "type": "integer",
                      "description": "Decimal places for legend values.",
                      "default": 0,
                      "minimum": 0,
                      "maximum": 15
                    }
                  }
                },
                "CODE_CHECKING_RATIO": {
                  "type": "object",
                  "description": "Steel code checking ratio display settings.",
                  "required": [],
                  "additionalProperties": false,
                  "properties": {
                    "CHECK": {
                      "type": "boolean",
                      "description": "Enable code checking ratio display.",
                      "default": true
                    },
                    "DISPLAY_MEMBERS": {
                      "type": "object",
                      "description": "Steel member types to display.",
                      "required": [],
                      "additionalProperties": false,
                      "properties": {
                        "BEAM": {
                          "type": "boolean",
                          "description": "Display beam members.",
                          "default": true
                        },
                        "COLUMN": {
                          "type": "boolean",
                          "description": "Display column members.",
                          "default": true
                        },
                        "BRACE": {
                          "type": "boolean",
                          "description": "Display brace members.",
                          "default": true
                        }
                      }
                    },
                    "COLUMN_SECTION_SIZE": {
                      "type": "object",
                      "description": "Column section size display settings.",
                      "required": [],
                      "additionalProperties": false,
                      "properties": {
                        "SCALE_FACTOR": {
                          "type": "number",
                          "description": "Scale factor for column section visualization.",
                          "default": 1,
                          "minimum": 0.1,
                          "maximum": 100
                        }
                      }
                    },
                    "VALUE_OPTION": {
                      "type": "object",
                      "description": "Value display format settings.",
                      "required": [],
                      "additionalProperties": false,
                      "properties": {
                        "DECIMAL_PLACES": {
                          "type": "integer",
                          "description": "Number of decimal places.",
                          "default": 2,
                          "minimum": 0,
                          "maximum": 15
                        },
                        "EXPONENTIAL": {
                          "type": "boolean",
                          "description": "Use exponential notation.",
                          "default": false
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}


Request Examples

Example

{
  "Argument": {
    "EXPORT_PATH": "C:\\MIDAS\\result\\steel design result.jpg",
    "SET_HIDDEN": true,
    "WIDTH": 1000,
    "HEIGHT": 1000,
    "PERSPECTIVE": false,
    "ZOOM_LEVEL": 100,
    "RESULT_GRAPHIC": {
      "CURRENT_MODE": "INFLL_DESIGN_STEEL",
      "LOAD_CASE_COMB": {
        "TYPE": "CBS",
        "NAME": "STEEL_gLCB5"
      },
      "COMPONENTS": {
        "COMP": "Combined"
      },
      "TYPE_OF_DISPLAY": {
        "LEGEND": {
          "OPT_CHECK": true,
          "VALUE_EXP": false,
          "DECIMAL_PT": 3
        },
        "CONTOUR": {
          "OPT_CHECK": true,
          "OPTIONS": {
            "GRADIENT_FILL": true
          }
        },
        "VALUES": {
          "OPT_CHECK": true,
          "DECIMAL_PT": 5,
          "VALUE_EXP": true,
          "SET_ORIENT": 15,
          "MINMAX_ONLY": {
            "MAXMIN": "min",
            "LIMIT_SCALE": 5
          }
        },
        "CODE_CHECKING_RATIO": {
          "CHECK": true,
          "DISPLAY_MEMBERS": {
            "COLUMN": true,
            "BEAM": false,
            "BRACE": true
          }
        }
      }
    }
  }
}


Response Examples

Example

{
  "message": "MIDAS GEN NX command complete"
}


Specifications

Keyed Object Entry

No. Description Key Value Type Default Required

Root Object

1

Map of keyed objects where each key is a string identifier.

"Argument"

object

-

Required


Item (Value Object Schema)

No. Description Key Value Type Default Required

General

1

Image File Save Path & File Name

e.g., C:\MIDAS\Result\image.jpg

"EXPORT_PATH"

string

-

Required

2

Smart Report Image Name

"FIGURE_NAME"

string

-

Optional

3

Hidden Option

"SET_HIDDEN"

boolean

false

Optional

4

Active *)

"ACTIVE"

object

-

Optional

5

Image Width

Constraints:

• Value Range: >= 100, <= 10000

"WIDTH"

integer

1000

Optional

6

Image Height

Constraints:

• Value Range: >= 100, <= 10000

"HEIGHT"

integer

1000

Optional

7

Construction Stage Name

"STAGE_NAME"

string

-

Optional

8

Angle

"ANGLE"

object

-

Optional

8.1

Horizontal

"HORIZONTAL"

number

0

Optional

8.2

Vertical

"VERTICAL"

number

0

Optional

9

Display Settings *)

"DISPLAY"

object

-

Optional

10

Perspective

"PERSPECTIVE"

boolean

false

Optional

11

Zoom Level

Constraints:

• Value Range: >= 25, <= 200

"ZOOM_LEVEL"

number

100

Optional

12

Background Color Top

"BGCOLOR_TOP"

object

-

Optional

12.1

Red

Constraints:

• Value Range: >= 0, <= 255

"R"

integer

-

Optional

12.2

Green

Constraints:

• Value Range: >= 0, <= 255

"G"

integer

-

Optional

12.3

Blue

Constraints:

• Value Range: >= 0, <= 255

"B"

integer

-

Optional

13

Result Graphic

"RESULT_GRAPHIC"

object

-

Required

13.1

Current Mode

• Steel Design: "INFLL_DESIGN_STEEL"

"CURRENT_MODE"

string

-

Required

13.2

Load Cases/Combinations

"LOAD_CASE_COMB"

object

-

Required

13.2.1

Load Case Type

• Steel Design Load Combination: "CBS"

"TYPE"

string

-

Required

13.2.2

Load Name

"NAME"

string

-

Required

13.3

Components

"COMPONENTS"

object

-

Optional

13.3.1

Ratio by Components

• Axial: "Axial"

• Shear-y: "Shear-y"

• Shear-z: "Shear-z"

• Bend-y: "Bend-y"

• Bend-z: "Bend-z"

• Combined: "Combined"

"COMP"

string

"Combined"

Optional

13.4

Type of Display

"TYPE_OF_DISPLAY"

object

-

Optional

13.4.1

Contour

"CONTOUR"

object

-

Optional

13.4.1.1

Check

"OPT_CHECK"

boolean

false

Optional

13.4.1.2

Number of Color

Constraints:

• Value Range: >= 2, <= 20

"NUM_OF_COLOR"

integer

12

Optional

13.4.1.3

Color Type

• V->R->G->B: "vrgb"

• >R->G->B: "rgb"

• R->B->G: "rbg"

• Gray Scaled: "gray scaled"

"COLOR_TYPE"

string

"vrgb"

Optional

13.4.1.4

Options

"OPTIONS"

object

-

Optional

13.4.1.4.1

Gradient Fill

"GRADIENT_FILL"

boolean

false

Optional

13.4.1.4.2

Contour Fill

"CONTOUR_FILL"

boolean

true

Optional

13.4.2

Values

"VALUES"

object

-

Optional

13.4.2.1

Check

"OPT_CHECK"

boolean

false

Optional

13.4.2.2

Decimal Pt.

Constraints:

• Value Range: >= 0, <= 15

"DECIMAL_PT"

integer

0

Optional

13.4.2.3

Exponential

"VALUE_EXP"

boolean

false

Optional

13.4.2.4

Min/Max Only

"MINMAX_ONLY"

object

-

Optional

13.4.2.4.1

MinMax Type of Values

• Min. & Max: "Min & Max"

• Absolut Max: "Abs Max"

• Maximum: "max"

• MMinimumin: "min"

"MAXMIN"

string

"Min & Max"

Optional

13.4.2.4.2

Limit Scale

"LIMIT_SCALE"

integer

0

Optional

13.4.2.5

Orientation

"SET_ORIENT"

integer

0

Optional

13.4.3

Legend

"LEGEND"

object

-

Optional

13.4.3.1

Check

"OPT_CHECK"

boolean

false

Optional

13.4.3.2

Position

• Right: "right"

• Left: "left"

• Top: "top"

• Bottom: "bottom"

"POSITION"

string

"left"

Optional

13.4.3.3

Exponential

"VALUE_EXP"

boolean

true

Optional

13.4.3.4

Decimal Pt.

Constraints:

• Value Range: >= 0, <= 15

"DECIMAL_PT"

integer

0

Optional

When "COMP" is Combined

13.4.4

Code Checking Ratio

"CODE_CHECKING_RATIO"

object

-

Optional

13.4.4.1

Check

"CHECK"

boolean

true

Optional

13.4.4.2

Display Members

"DISPLAY_MEMBERS"

object

-

Optional

13.4.4.2.1

Beam

"BEAM"

boolean

true

Optional

13.4.4.2.2

Column

"COLUMN"

boolean

true

Optional

13.4.4.2.3

Brace

"BRACE"

boolean

true

Optional

13.4.4.3

Column Section Size

"COLUMN_SECTION_SIZE"

object

-

Optional

13.4.4.3.1

Scale Factor

Constraints:

• Value Range: >= 0.1, <= 100

"SCALE_FACTOR"

number

1

Optional

13.4.4.4

Value Option

"VALUE_OPTION"

object

-

Optional

13.4.4.4.1

Decimal Places

Constraints:

• Value Range: >= 0, <= 15

"DECIMAL_PLACES"

integer

2

Optional

13.4.4.4.2

Exponential

"EXPONENTIAL"

boolean

false

Optional



- Active ↗

- Display ↗



0
Was this article helpful?