Консольный кран | Справка AnyLogic

• Свойства
• Функции

Разметка MoveByCraneSpace для моделей погрузочно-разгрузочных работMaterial Handling Library Справочник по API — класс крана

Стреловой кран — элемент разметки пространства, который графически определяет башенный кран. Вы можете использовать блок библиотеки обработки материалов MoveByCrane для имитации того, как кран транспортирует агентов (материальные объекты) между двумя точками моделируемой среды.

Стреловой кран имеет два различных режима работы в зависимости от того, как его компоненты перемещаются по отношению друг к другу.

Максимальная высота, на которую может подняться агент (материальный объект) при подъеме стреловым краном, равна высоте самого крана.

Стреловой кран может служить препятствием на пути пешеходов и транспортных средств, перемещающихся в режиме навигации в свободном пространстве.

Элемент стрелового крана предоставляет пользователям набор действий, которые используются для определения дополнительного поведения агента.

Чтобы нарисовать кран

1. Перетащите элемент Jib Crane из раздела Material Handling палитры Space Markup в графический редактор. Вы увидите форму круга с единственной горизонтальной формой стрелы крана.

2. Кран может поднимать или сбрасывать материальные предметы непосредственно с пути, конвейера или железнодорожного пути. В этом случае следует подключить кран к соответствующему элементу разметки пространства, расположив его достаточно близко, чтобы форма крана была выделена зеленым цветом (это означает, что соединение установлено).

3. После того, как кран будет успешно подключен, форма крана будет заполнена цветом, как показано на изображении ниже.

4. Можно настроить начальный угол стрелы и ее длину.
5. Вы можете установить сектор на периферии вращения крана, где стрела не может двигаться. Чтобы включить эту функцию для крана, выберите параметр Имеет заблокированную зону в представлении Свойства . Закрытую зону можно настроить из графического редактора.

6. По умолчанию заблокированная зона крана всегда размещается так, как показано на изображении выше. Если вы поместите стрелу в эту область до включения зоны блокировки, движение крана во время движения модели будет невозможным, и возникнет ошибка.
7. Чтобы настроить внешний вид крана, выберите тип крана в представлении Свойства : либо Промышленный стреловой кран , Башенный кран Cat или Башенный кран с плоской опалубкой . Вы можете изменить Цвет крана в окне Свойства для всех типов и Цвет кабины для последних двух.

Свойства

Общие

Наименование  — Наименование стрелового крана. Имя используется для идентификации и доступа к крану из кода и блоков библиотеки обработки материалов.

Игнорировать  — Если выбрано, стреловой кран исключается из модели.

Виден на верхнем агенте  — Если выбрано, стреловой кран также виден на верхнем агенте, где живет этот агент.

Замок  — Если выбрано, форма крана заблокирована. Заблокированные фигуры не реагируют на щелчки мышью — их невозможно выделить в графическом редакторе, пока вы их не разблокируете. Это часто необходимо, когда вы хотите предотвратить редактирование этой фигуры при рисовании других фигур поверх нее.

Visible  — Здесь вы указываете, будет ли фигура видимой в анимации во время выполнения модели или нет. С помощью элемента управления выберите да или нет .

Тип предмета материала  — Тип предмета материала, который транспортируется этим стреловым краном.

Является препятствием  — Если выбрано, этот стреловой кран будет считаться препятствием для пешеходов и транспортников, движущихся в режиме свободного пространства.

Режим движения компонента  — Здесь вы можете выбрать, как стрела, тележка и крюк крана должны двигаться относительно друг друга. Варианты:

• Шаг за шагом  — компоненты будут перемещаться по одному. Этот режим удовлетворяет условиям безопасности эксплуатации крана.
• Concurrent  — перемещение всех компонентов будет выполняться одновременно. Этот режим значительно быстрее, чем режим Step-by-step , но не так безопасен.

Скорость тележки  — Здесь можно указать скорость движения тележки крана. Свойство является динамическим, поэтому вы можете настроить изменение скорости во время выполнения в зависимости от того, загружен кран или нет. С помощью локальной переменной isLoaded логического типа можно, например, настроить изменение скорости с помощью условного оператора: isLoaded ? agent.mySpeed: 1. Когда кран разгружается, переменная агента имеет значение null. Если вы не указали конкретное значение скорости для ненагруженного крана, тележка будет двигаться со скоростью по умолчанию 0,5 метра в секунду.

Скорость подъема  — Здесь вы можете определить скорость подъема подъемника. Свойство является динамическим, поэтому вы можете настроить изменение скорости во время выполнения в зависимости от того, загружен кран или нет. С помощью локальной переменной isLoaded логического типа можно, например, настроить изменение скорости с помощью условного оператора: isLoaded ? agent.mySpeed: 1. Когда кран разгружается, переменная агента имеет значение null. Если вы не указали конкретное значение скорости для ненагруженного крана, подъемник будет двигаться со скоростью по умолчанию 0,1 метра в секунду.

Скорость вращения стрелы  — Здесь вы можете определить скорость вращения стрелы крана. Свойство является динамическим, поэтому вы можете настроить изменение скорости во время выполнения в зависимости от того, загружен кран или нет. С помощью локальной переменной isLoaded логического типа можно, например, настроить изменение скорости с помощью условного оператора: isLoaded ? agent.mySpeed: 1. Когда кран разгружается, переменная агента имеет значение null. Если вы не указали какое-либо конкретное значение скорости для ненагруженного крана, стрела будет вращаться со скоростью по умолчанию 0,5 оборота в минуту.

Действия

Во всех действиях текущий материальный элемент доступен как локальный переменный агент.

При отказе  — Здесь вы можете ввести код Java, который будет выполняться в случае отказа стрелового крана.

При ремонте  — Здесь вы можете ввести код Java, который будет выполняться при ремонте стрелового крана.

При загрузке  — Здесь вы можете ввести код Java, который будет выполнен сразу после того, как стреловой кран захватит материал.

При разгрузке  — Здесь вы можете ввести код Java, который будет выполнен сразу после того, как стреловой кран освободит материальную единицу.

Внешний вид

Тип  — Здесь вы можете выбрать тип крана: промышленный консольный кран , башенный кран Cat или башенный кран с плоской опалубкой .

Промышленный стреловой кран
Козловой башенный кран
Плоский башенный кран

Вы меняете только внешний вид крана: ваш выбор не влияет на логику его работы.

Цвет кабины  — [Отображается, если для параметра Стиль установлено значение Башенный кран с кошачьей головкой или Башенный кран с плоской опалубкой ] Цвет заливки кабины крана. Выберите No color , если вы не хотите, чтобы область была заполнена.

Цвет крана  — Цвет формы крана. Выберите No color , если вы не хотите, чтобы область была заполнена.

Положение и размер

Уровень  — Уровень, к которому принадлежит этот элемент.

X  — X-координата точки, где находится кран.

Y  — Y-координата точки, где находится кран.

Z  — Z-координата точки, где находится кран.

Длина стрелы  — Здесь можно указать длину стрелы крана.

Высота крана  — Здесь можно указать высоту самого стрелового крана.

Начальный угол стрелы  — Здесь можно указать начальный угол стрелы крана в положительных или отрицательных градусах или радианах. Графическая подсказка, расположенная справа от элемента управления, отображает заданный угол.

Положение тележки  — Здесь можно указать исходное положение тележки крана.

Заблокировал зону  — Если выбран этот параметр, вы можете определить сектор на периферии вращения крана, куда стрела не сможет войти.

Начальный угол зоны  — [Виден, если выбран параметр Имеет заблокированную зону ] Здесь вы можете указать угол, под которым будет начинаться заблокированная зона. Графическая подсказка, расположенная справа от элемента управления, отображает заданный угол.

Угол зоны , ° — [Виден, если выбрано Имеет заблокированную зону ] Здесь вы укажете сектор самой заблокированной зоны. Он будет рассчитываться, начиная с.

Расширенный

Показать в  — Здесь вы можете выбрать, хотите ли вы, чтобы форма отображалась как в 2D, так и в 3D анимации, или только в 2D , или только в 3D .

Показать имя  — Если выбрано, имя фигуры отображается на графической диаграмме.

Для регулировки начального угла стрелы

1. Перетащите ручку, расположенную на конце формы стрелы, по часовой стрелке или против часовой стрелки, чтобы задать начальный угол стрелы. Чтобы предотвратить изменение текущей длины стрелы в процессе, нажмите и удерживайте клавишу Shift при перетаскивании ручки.

2. При перемещении рукоятки фактический угол стрелы будет отображаться в строке состояния AnyLogic.

Для регулировки длины стрелы

1. Перетащите ручку вдоль формы стрелы, чтобы изменить длину стрелы. Чтобы предотвратить изменение начального угла стрелы в процессе, нажмите и удерживайте клавишу Ctrl при перетаскивании ручки.

2. При перемещении рукоятки фактическая длина стрелы будет отображаться в строке состояния AnyLogic.

Чтобы настроить зону блокировки крана

1. Чтобы включить зону блокировки крана, выберите параметр Имеет зону блокировки в представлении Свойства крана . В графическом редакторе он будет отображаться в виде синего сектора формы круга журавля. Сектор будет иметь две ручки для регулировки.
2. Перетащите синюю ручку по часовой стрелке или против часовой стрелки, чтобы указать, где угол, где должна начинаться заблокированная зона крана.

3. Чтобы предотвратить изменение текущего размера заблокированной зоны, нажмите и удерживайте кнопку Ctrl, перетаскивая синий маркер.
4. Перетащите белую ручку, чтобы настроить размер заблокированной зоны.

5. Если вы хотите увеличить или уменьшить заблокированную зону, изменив начальный и конечный углы в равной степени, нажмите и удерживайте клавишу Shift, перетаскивая любой маркер.

Функции

Вы можете динамически изменять свойства крана во время выполнения модели, используя следующий API.

Рабочее состояние

Функция	Описание
логическое значение isReady()	Возвращает true, если кран готов к работе, в противном случае возвращает false.
логическое значение isFailed()	Возвращает true, если кран вышел из строя (сломался) и не работает, в противном случае возвращает false.
логическое значение isLoaded()	Возвращает true, если кран в данный момент загружен материальным предметом. В противном случае эта функция возвращает false.
недействительный сбой ()	Инициирует отказ крана. Кран перестает работать.
недействительный ремонт ()	Ремонт крана. Кран снова становится доступным.

Статистика использования

Функция	Описание
двойной getUtilization()	Возвращает использование крана: долю времени, в течение которого кран был занят. Возвращаемое значение использования крана находится в диапазоне [0..1].
недействительный resetStats ()	Сбрасывает статистику использования крана.

Уровень

Функция	Описание
Уровень получитьУровень()	Возвращает уровень, на котором находится этот кран.

Препятствие

Функция	Описание
логическое значение isObstacle()	Возвращает true, если этот кран считается препятствием для пешеходов и транспортных средств, движущихся в режиме свободного пространства. В противном случае возвращает ложь.
void setObstacle (логическое значение isObstacle)	Устанавливает этот кран в качестве препятствия для пешеходов и транспортников, движущихся в режиме свободного пространства. isObstacle — если true, кран устанавливается как препятствие. В противном случае нет.

Механизм

Функция	Описание
JibCraneMovementMode getMovementMode()	Возвращает режим движения тележки, стрелы и крюка крана относительно друг друга. Допустимые значения: JIB_CRANE_MOVEMENT_STEP_BY_STEP JIB_CRANE_MOVEMENT_CONCURRENT
void setMovementMode (MovementMode JibCraneMovementMode)	Задает режим движения тележки, стрелы и крюка крана относительно друг друга. trafficMode — режим движения компонентов. Допустимые значения: JIB_CRANE_MOVEMENT_STEP_BY_STEP JIB_CRANE_MOVEMENT_CONCURRENT
double trolleySpeed(Агент агент, юниты SpeedUnits)	Возвращает скорость тележки крана, заданную в свойствах крана, в указанных единицах скорости. Агент — материальный объект, перемещаемый краном. единиц — константа, определяющая единицы скорости.
double liftSpeed(Агент агента, юниты SpeedUnits)	Возвращает скорость работы подъемной лебедки, заданную в свойствах крана, в указанных единицах скорости. Агент — материальный объект, перемещаемый краном. единиц — константа, определяющая единицы скорости.
двойная скорость вращения (агент агента, единицы измерения RotationSpeedUnits)	Возвращает скорость вращения стрелы крана, заданную в свойствах крана, в указанных единицах скорости вращения. Агент — материальный объект, перемещаемый краном. единиц — константа, определяющая единицы скорости вращения.
Позиция getCurrentHookPosition()	Возвращает текущее положение крюка в пикселях с углом стрелы крана как Position.rotation.
Позиция getAbsoluteHookPosition()	Возвращает текущую позицию крюка относительно начала координат агента, где находится кран. Положение возвращается в пикселях с углом стрелы крана как Position.rotation.

Размеры и компоненты

Функция	Описание
double getCraneHeight (единицы измерения длины)	Возвращает высоту крана в указанных единицах. единиц — константа, определяющая единицы длины.
void setCraneHeight (двойная высота, единицы измерения LengthUnits)	Устанавливает высоту крана в указанных единицах. height — новое значение высоты. единиц — константа, определяющая единицы длины.
двойной getJibLength()	Возвращает длину стрелы крана в пикселях.
двойной getJibLength (единицы длины)	Возвращает длину стрелы крана в указанных единицах. единиц — константа, определяющая единицы длины.
void setJibLength (двойная длина, единицы измерения LengthUnits)	Задает длину стрелы крана в указанных единицах. length — новое значение длины. единиц — константа, определяющая единицы длины.
двойной getInitialJibAngle (единицы измерения углов)	Возвращает исходный угол положения стрелы крана. единиц — константа, определяющая единицы измерения угла.
void setInitialJibAngle (двойной угол, единицы AngleUnits)	Задает начальный угол положения стрелы крана. angle — новое значение угла. единицы — константа, определяющая единицы измерения угла.

Заблокированная зона

Функция	Описание
логическое значение isBlockedZoneEnabled()	Возвращает true, если включена заблокированная зона крана, в противном случае возвращает false.
двойной getBlockedZoneStartAngle()	Возвращает угол, где начинается зона блокировки крана.
двойной getBlockedZoneAngle()	Возвращает дельту угла заблокированной зоны крана.
недействительным setBlockedZoneEnabled (логическое значение hasBlockedZone)	Включает или отключает заблокированную зону. hasBlockedZone — заблокированная зона. Если этот параметр имеет значение true, заблокированная зона включена. Если false, заблокированная зона отключена.
void setBlockedZoneStartAngle (двойной угол, единицы AngleUnits)	Устанавливает угол, под которым начинается зона блокировки крана. angle — новое значение угла. единицы — константа, определяющая единицы измерения угла.
void setBlockedZoneAngle (двойной угол, единицы измерения AngleUnits)	Устанавливает дельта-угол зоны блокировки крана. angle — новое значение угла. единицы — константа, определяющая единицы измерения угла.
void setBlockedZone (двойной startAngle, двойной deltaAngle, единицы измерения AngleUnits)	Включает заблокированную зону с заданными параметрами. startAngle — значение начального угла заблокированной зоны. deltaAngle — дельта-угол значения заблокированной зоны. единиц — константа, определяющая единицы измерения угла.

Кран типа

Функция	Описание
JibCraneType getType()	Возвращает тип внешнего вида крана. Допустимые значения: JIB_CRANE_INDUSTRIAL JIB_CRANE_CAT_HEAD JIB_CRANE_FLAT_TOP
void setType (тип JibCraneType)	Устанавливает тип внешнего вида крана. Тип — новый тип внешнего вида крана. Допустимые значения: JIB_CRANE_INDUSTRIAL JIB_CRANE_CAT_HEAD JIB_CRANE_FLAT_TOP

Цвет

Функция	Описание
Цвет получитьЦвет()	Возвращает цвет крана или ноль, если кран не имеет цвета.
void setColor (Цвет цвета)	Устанавливает цвет крана.  – новый цвет/
Цвет getTrolleyColor()	Возвращает цвет кабины крана или ноль, если кабина крана не имеет цвета.
void setTrolleyColor (Цвет тележки)	Задает цвет кабины крана. cabColor — новый цвет.

Видимость

Функция	Описание
логическое значение является видимым ()	Возвращает true, если кран виден; в противном случае возвращает false.
недействительным setVisible (логическое v)	Устанавливает видимость крана. v — видимость. Если v равно true — кран будет виден, если false — не будет виден.

Позиция

Функция	Описание
двойной получитьX()	Возвращает координату X центральной точки крана.