matplotlib.pyplot.ginput

matplotlib.pyplot.ginput(*args, **kwargs) [source]

Блокирующий вызов для взаимодействия с графиком.

Ожидает, пока пользователь n раз кликнет по графику, и возвращает координаты каждого клика в списке.

Возможны три вида взаимодействия:

• Добавить точку.
• Удалить последнюю добавленную точку.
• Остановить взаимодействие и вернуть добавленные точки.

Действия присваиваются кнопкам мыши с помощью аргументов mouse_add, mouse_pop и mouse_stop. Кнопки мыши определяются числами:

• 1: левая кнопка мыши
• 2: средняя кнопка мыши
• 3: правая кнопка мыши
• None: кнопка мыши не используется

Параметры:

n : int, optional, default: 1 Количество кликов мышью для накопления. Если отрицательное, накапливать клики до тех пор, пока ввод не будет завершен вручную. timeout : scalar, optional, default: 30 Время ожидания в секундах. Если ноль или отрицательное значение, таймаут не будет активирован. show_clicks : bool, optional, default: True Если True, отображает красный крест в месте каждого клика. mouse_add : {1, 2, 3, None}, optional, default: 1 (left click) Кнопка мыши для добавления точек. mouse_pop : {1, 2, 3, None}, optional, default: 3 (right click) Кнопка мыши для удаления последней добавленной точки. mouse_stop : {1, 2, 3, None}, optional, default: 2 (middle click) Кнопка мыши для остановки ввода.

Возвращаемое значение:

points : list of tuples Список координат кликов (x, y).

Примечания

Клавиатура также может использоваться для выбора точек, если у мыши отсутствует одна или несколько кнопок. Кнопки Delete и Backspace действуют как правая кнопка мыши (т.е., удаление последней точки), клавиша Enter завершает ввод, а любая другая клавиша (не используемая менеджером окон) выбирает точку.

Примеры использования matplotlib.pyplot.ginput

Интерактивные функции