Material item dimensions

Since material items are typically handled in the physical space (they are transported by conveyors and occupy a certain space on them), the dimensions of the material items are essential to obtain valid simulation results. The size of each material item is defined by three dimensions (length, width, height), which are set to 1 meter by default.

    Setting dimensions for the material items

    Dimensions of the custom material item type are defined in the Dimensions and movement section of the custom type's properties.

    In case you do not require custom types of material items, the material items in your model will have the default size of 1*1*1 meter.

    You can adjust the item's dimensions (of both default and custom types) in either of the following ways (new dimensions override the dimensions previously defined in the custom type properties):

    Generating material items of a custom size

    Typically material items are generated by the Source block of the AnyLogic Process Modeling Library. You can set the material item dimensions right upon its creation by adjusting the properties of the coresponding Source block. To set the new length, width, and height of the material items being created by the Source block, expand the Agent section of the block's properties, select the option Set dimensions and specify the values in the fields below.

    Changing / obtaining the dimensions programmatically at model runtime

    You can obtain and adjust the current dimensions of existing material items by calling the corresponding functions of the material item:

    double getLength() - Returns the length of the material item, measured in meters.

    double getLength(LengthUnits units) - Returns the length of the material item, measured in the given length units.
    Parameter: units - one of length unit constants

    double getWidth() - Returns the width of the material item.

    double getWidth(LengthUnits units) - Returns the width of the material item, measured in the given length units.
    Parameter: units - one of length unit constants

    double getHeight() - Returns the height of the material item.

    double getHeight(LengthUnits units) - Returns the height of the material item, measured in the given length units.
    Parameter: units - one of length unit constants

    void setDimensions(double lengthInMeters, double widthInMeters, double heightInMeters) - Sets new dimensions of the material item, in meters.
    Parameters: lengthInMeters - new length, in meters
    widthInMeters - new width, in meters
    heightInMeters - new height, in meters

    void setDimensions(double lengthInUnits, double widthInUnits, double heightUnits, LengthUnits units) - Sets new dimensions of the material item, in the given length units.
    Parameters: lengthInUnits - new length, in meters
    widthInUnits - new width, in meters
    heightInUnits - new height, in meters
    units - one of length unit constants

    void setLength(double lengthInMeters) - Sets the new length of the material item, in meters.
    Parameter: lengthInMeters - new length, in meters

    void setLength(double lengthInUnits, LengthUnits units) - Sets the new length of the material item.
    Parameters: lengthInUnits - new length, in specified length units
    units - one of length unit constants

    void setWidth(double widthInMeters) - Sets the new width of the material item, in meters.
    Parameter: widthInMeters - new width, in meters

    void setWidth(double widthInUnits, LengthUnits units) - Sets the new width of the material item.
    Parameters: widthInUnits - new width, in specified length units
    units - one of length unit constants

    void setHeight(double heightInMeters) - Sets the new height of the material item, in meters.
    Parameter: heightInMeters - new height, in meters

    void setHeight(double heightInUnits, LengthUnits units) - Sets the new height of the material item.
    Parameters: heightInUnits - new height, in specified length units
    units - one of length unit constants