Skip to main content
JSON Manual Created Edited

Divide Elements

Input URI

{base url} + ope/DIVIDEELEM



Active Methods

POST



JSON Schema

Details

{
    "DIVIDEELEM": {
        "$schema": "http://json-schema.org/draft-07/schema#",
        "type": "object",
        "properties": {
            "Argument": {
                "type": "object",
                "properties": {
                    "TARGETS": {
                        "type": "array",
                        "items": {
                            "type": "integer"
                        }
                    },
                    "START_NUMBER": {
                        "type": "object",
                        "properties": {
                            "NODE_NUMBER": {
                                "type": "object",
                                "properties": {
                                    "NUMBER_OPTION": {
                                        "type": "string",
                                        "enum": [
                                            "Smallest",
                                            "Largest",
                                            "User"
                                        ]
                                    },
                                    "USER_NUM": {
                                        "type": "integer"
                                    }
                                }
                            },
                            "ELEM_NUMBER": {
                                "type": "object",
                                "properties": {
                                    "NUMBER_OPTION": {
                                        "type": "string",
                                        "enum": [
                                            "Smallest",
                                            "Largest",
                                            "User"
                                        ]
                                    },
                                    "USER_NUM": {
                                        "type": "integer"
                                    }
                                }
                            }
                        }
                    },
                    "DIVIDE": {
                        "type": "object",
                        "properties": {
                            "ELEM_TYPE": {
                                "type": "string",
                                "enum": [
                                    "Frame",
                                    "Wall",
                                    "Planar",
                                    "Solid"
                                ]
                            },
                            "DIV_METHOD": {
                                "type": "string",
                                "enum": [
                                    "Equal",
                                    "Unequal",
                                    "ParametricUnequal",
                                    "ParallelBracing",
                                    "DividebyNode"
                                ]
                            },
                            "OPTION": {
                                "type": "object",
                                "properties": {
                                    "EQUAL_OPTION": {
                                        "type": "object",
                                        "properties": {
                                            "NUM_X": {
                                                "type": "integer"
                                            },
                                            "NUM_Y": {
                                                "type": "integer"
                                            },
                                            "NUM_Z": {
                                                "type": "integer"
                                            }
                                        }
                                    },
                                    "UNEQUAL_OPTION": {
                                        "type": "object",
                                        "properties": {
                                            "DIST_X": {
                                                "type": "string"
                                            },
                                            "DIST_Y": {
                                                "type": "string"
                                            },
                                            "DIST_Z": {
                                                "type": "string"
                                            }
                                        }
                                    },
                                    "PARAMETRIC_OPTION": {
                                        "type": "object",
                                        "properties": {
                                            "RATIO_X": {
                                                "type": "string"
                                            },
                                            "RATIO_Y": {
                                                "type": "string"
                                            },
                                            "RATIO_Z": {
                                                "type": "string"
                                            }
                                        }
                                    },
                                    "PARALLEL_OPTION": {
                                        "type": "object",
                                        "properties": {
                                            "NUM_OF_DIVISIONS": {
                                                "type": "integer"
                                            },
                                            "MAIN_POST_ELEM": {
                                                "type": "array",
                                                "items": {
                                                    "type": "integer"
                                                }
                                            }
                                        }
                                    },
                                    "BY_NODE_OPTION": {
                                        "type": "object",
                                        "properties": {
                                            "ELEM_NUM": {
                                                "type": "integer"
                                            },
                                            "NODE_NUM": {
                                                "type": "integer"
                                            }
                                        }
                                    }
                                }
                            },
                            "SUBDIVIDE_ELEM": {
                                "type": "boolean"
                            },
                            "MERGE_DUPLICATE_NODES": {
                                "type": "object",
                                "properties": {
                                    "OPT_CHECK": {
                                        "type": "boolean"
                                    },
                                    "TOLERANCE": {
                                        "type": "number"
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}


Request Examples

Frame - Equal Distance

{
    "Argument": {
        "TARGETS": [
            1
        ],
        "DIVIDE": {
            "ELEM_TYPE": "Frame",
            "DIV_METHOD": "Equal",
            "OPTION": {
                "EQUAL_OPTION": {
                    "NUM_X": 10
                }
            }
        }
    }
}

Frame - Unequal Distance

{
    "Argument": {
        "TARGETS": [
            1
        ],
        "DIVIDE": {
            "ELEM_TYPE": "Frame",
            "DIV_METHOD": "Unequal",
            "OPTION": {
                "UNEQUAL_OPTION": {
                    "DIST_X": "3@2.0"
                }
            }
        }
    }
}

Frame - Parametric Unequal Distance

{
    "Argument": {
        "TARGETS": [
            1
        ],
        "DIVIDE": {
            "ELEM_TYPE": "Frame",
            "DIV_METHOD": "ParametricUnequal",
            "OPTION": {
                "PARAMETRIC_OPTION": {
                    "RATIO_X": "3@0.3"
                }
            }
        }
    }
}

Frame - Parallel Bracing

{
    "Argument": {
        "DIVIDE": {
            "ELEM_TYPE": "Frame",
            "DIV_METHOD": "ParallelBracing",
            "OPTION": {
                "PARALLEL_OPTION": {
                    "NUM_OF_DIVISIONS": 3,
                    "MAIN_POST_ELEM": [
                        1,
                        3
                    ]
                }
            }
        }
    }
}

Frame - Divide by Node

{
    "Argument": {
        "DIVIDE": {
            "ELEM_TYPE": "Frame",
            "DIV_METHOD": "DividebyNode",
            "OPTION": {
                "BY_NODE_OPTION": {
                    "ELEM_NUM": 1,
                    "NODE_NUM": 10
                }
            }
        }
    }
}

Planar - Equal Distance

{
    "Argument": {
        "TARGETS": [
            1
        ],
        "DIVIDE": {
            "ELEM_TYPE": "Planar",
            "DIV_METHOD": "Equal",
            "OPTION": {
                "EQUAL_OPTION": {
                    "NUM_X": 3,
                    "NUM_Y": 2
                }
            }
        }
    }
}

Planar - Unequal Distance

{
    "Argument": {
        "TARGETS": [
            1
        ],
        "DIVIDE": {
            "ELEM_TYPE": "Planar",
            "DIV_METHOD": "Unequal",
            "OPTION": {
                "UNEQUAL_OPTION": {
                    "DIST_X": "2@2.5",
                    "DIST_Y": "2@3.0"
                }
            }
        }
    }
}

Planar - Parametric Unequal Distance

{
    "Argument": {
        "TARGETS": [
            1
        ],
        "DIVIDE": {
            "ELEM_TYPE": "Planar",
            "DIV_METHOD": "ParametricUnequal",
            "OPTION": {
                "PARAMETRIC_OPTION": {
                    "RATIO_X": "2@0.2",
                    "RATIO_Y": "3@0.3"
                }
            }
        }
    }
}

Wall - Equal Distance

{
    "Argument": {
        "TARGETS": [
            1
        ],
        "DIVIDE": {
            "ELEM_TYPE": "Wall",
            "DIV_METHOD": "Equal",
            "OPTION": {
                "EQUAL_OPTION": {
                    "NUM_X": 2,
                    "NUM_Z": 3
                }
            }
        }
    }
}

Wall - Unequal Distance

{
    "Argument": {
        "TARGETS": [
            1
        ],
        "DIVIDE": {
            "ELEM_TYPE": "Wall",
            "DIV_METHOD": "Unequal",
            "OPTION": {
                "UNEQUAL_OPTION": {
                    "DIST_X": "3@2.0",
                    "DIST_Z": "4@1.5"
                }
            }
        }
    }
}

Wall - Parametric Unequal Distance

{
    "Argument": {
        "TARGETS": [
            1
        ],
        "DIVIDE": {
            "ELEM_TYPE": "Wall",
            "DIV_METHOD": "ParametricUnequal",
            "OPTION": {
                "PARAMETRIC_OPTION": {
                    "RATIO_X": "3@0.2",
                    "RATIO_Z": "4@0.2"
                }
            }
        }
    }
}

Solid - Equal Distance

{
    "Argument": {
        "TARGETS": [
            1
        ],
        "DIVIDE": {
            "ELEM_TYPE": "Solid",
            "DIV_METHOD": "Equal",
            "OPTION": {
                "EQUAL_OPTION": {
                    "NUM_X": 2,
                    "NUM_Y": 3,
                    "NUM_Z": 4
                }
            }
        }
    }
}

Solid - Unequal Distance

{
    "Argument": {
        "TARGETS": [
            1
        ],
        "DIVIDE": {
            "ELEM_TYPE": "Solid",
            "DIV_METHOD": "Unequal",
            "OPTION": {
                "UNEQUAL_OPTION": {
                    "DIST_X": "3@2.5",
                    "DIST_Y": "4@1.0",
                    "DIST_Z": "1,2,3"
                }
            }
        }
    }
}

Solid - Parametric Unequal Distance

{
    "Argument": {
        "TARGETS": [
            1
        ],
        "DIVIDE": {
            "ELEM_TYPE": "Solid",
            "DIV_METHOD": "ParametricUnequal",
            "OPTION": {
                "PARAMETRIC_OPTION": {
                    "RATIO_X": "3@0.3",
                    "RATIO_Y": "4@0.2",
                    "RATIO_Z": "0.1,0.2,0.3"
                }
            }
        }
    }
}


Response Examples

Retrun Created Element

{
    "DIVIDEELEM": {
        "1": {
            "TYPE": "PLATE",
            "MATL": 1,
            "SECT": 1,
            "NODE": [
                1,
                5,
                8,
                7,
                0,
                0,
                0,
                0
            ],
            "ANGLE": 0,
            "STYPE": 1
        }
    }
}


Specifications

No. Description Key Value Type Default Required

1

Divide Element ID Number

"TARGETS"

Array
[Integer]

-

Optional

2

Starting Node/Element Number

"START_NUMBER"

Object

System

Optional

(1)

Starting Node Number

"NODE_NUMBER"

Object

-

Optional

i. Node Numbering Option

 • Smallest Unused Number: "Smallest"

 • Largest Used Number+1: "Largest"

 • User-Defined Number: "User"

"NUMBER_OPTION"

String

-

Optional

ii. User-Defined Node Number

 • When "NUMBER_OPTION" is "User"

"USER_NUM"

Integer

-

Optional

(2)

Starting Element Number

"ELEM_NUMBER"

Object

-

Optional

i. Element Numbering Option

 • Smallest Unused Number: "Smallest"

 • Largest Used Number+1: "Largest"

 • User-Defined Number: "User"

"NUMBER_OPTION"

String

-

Optional

ii. User-Defined Element Number

 • When "NUMBER_OPTION" is "User"

"USER_NUM"

Integer

-

Optional

3

Setting Divide

"DIVIDE"

Object

-

Required

(1)

Element Type

 • Line Element: "Frame"

 • Wall Element ᴳ⁾: "Wall"

 • Planar Element: "Planar"

 • Solid Element: "Solid"

"ELEM_TYPE"

String

-

Required

(2)

Divide Methods

 • Equal Distance: "Equal"

 • Unequal Distance: "Unequal"

 • Parametric Unequal Distance: "Parametric Unequal"

 • Parallel Bracing: "Parallel Bracing"

 • Divide by Node: "Divide by Node"

"DIV_METHOD"

String

-

Required

(3)

Divide Option

"OPTION"

Object

   

Equal Distance

i. Divide at Equal Distances

"EQUAL_OPTION"

Object

-

Required

i-1. Number of Divisions in ECS x-Direction

 • Frame, Wall, Solid, Planar

"NUM_X"

Integer

-

Required

i-2. Number of Divisions in ECS y-Direction

 • Solid, Planar

"NUM_Y"

Integer

-

Required

i-3. Number of Divisions in ECS z-Direction

 • Solid, Wall

"NUM_Z"

Integer

-

Required

Unequal Distance

i. Divide at Unequal Distances

"UNEQUAL_OPTION"

Object

-

Required

i-1. Unequal Distances as Many Times as Desired in ECS x-direction

 • Frame, Wall, Solid, Planar

"DIST_X"

String

-

Required

i-2. Unequal Distances as Many Times as Desired in ECS y-direction

 • Solid, Planar

"DIST_Y"

String

-

Required

i-3. Unequal Distances as Many Times as Desired in ECS z-direction

 • Solid, Wall

"DIST_Z"

String

-

Required

Parametric Unequal Distance

i. Unequal Distances Defined in Terms of Distance Ratios

"PARAMETRIC_OPTION"

Object

-

Required

i-1. Relative Unequal Distance Ratios in ECS x-Direction

 • Frame, Wall, Solid, Planar

"RATIO_X"

String

-

Required

i-2. Relative Unequal Distance Ratios in ECS y-Direction

 • Solid, Planar

"RATIO_Y"

String

-

Required

i-3. Relative Unequal Distance Ratios in ECS z-Direction

 • Solid, Wall

"RATIO_Z"

String

-

Required

Parallel Bracing

i. Parallel Bracing Keeps Braces between Two Posts Parallel, Regardless of Post Angle

"PARALLEL_OPTION

Object

-

Required

i-1. Number of Divisions

 • Frame

"NUM_OF_DIVISIONS"

Integer

-

Required

i-2. Relative Unequal Distance Ratios in ECS y-Direction

 • Frame

"MAIN_POST_ELEM"

Array
[Integer]

-

Required

Divide by Node

i. Divide the Element into Two New Elements using the Node.

"BY_NODE_OPTION

Object

-

Required

i-1. Element Number

 • Frame

"ELEM_NUM"

Integer

-

Required

i-2. Node Number to Divide Element

 • Frame

"NODE_NUM"

Integer

-

Required

(4)

Subdivide Frame Elements

"SUBDIVIDE_ELEM"

Boolean

-

Optional

(5)

Merge Duplicate Nodes

"MERGE_DUPLICATE_NODES"

Object

-

Optional

i. Activation Option

"OPT_CHECK"

Boolean

-

Optional

ii. Merging Tolerance

"TOLERANCE"

Number

-

Optional



MIDAS GEN NX only

0
Was this article helpful?