설치 및 환경 설정#
pypylon에 대한 배경 정보는 Introduction을 참조하십시오.
pylon Software Suite 설치#
Basler pylon Software Suite를 pypylon 및 3D 카메라용 추가 패키지와 함께 설치합니다.
정보
pypylon wheel 패키지에는 pylon C++ runtimes와 vTools가 이미 포함되어 있습니다. 이는 pypylon을 사용하는 데 충분하며, 추가 드라이버가 필요 없는 전송 계층에서 즉시 작동합니다.
필요한 경우 Basler 웹사이트에서 pylon Software Suite 및 3D 카메라용 추가 패키지를 다운로드할 수 있습니다.
pylon Software Suite의 설치 마법사가 설치 과정을 안내하며 설치할 구성 요소를 결정할 수 있도록 합니다. 다음 구성 요소가 권장됩니다.
- USB/GigE drivers
- CXP GenTL producer 및 drivers(CXP 카메라를 사용하는 경우)
- pylon Viewer
pypylon 설치하기#
pypylon은 PyPi에서 제공됩니다. 설치하려면 다음 명령을 실행하세요.
일부 시스템에서 pip install을 실행하면 다음과 같은 메시지가 나타날 수 있습니다.
error: externally-managed-environment × This environment is externally managed To install Python packages system-wide, use your system package manager, for instance on Ubuntu23.04+.
이는 운영 체제가 Python 설치를 관리함을 의미합니다. pip가 시스템 패키지를 변경하는 것을 방지하는 데 도움이 됩니다.
대안 1: 가상 환경(권장)#
Python "virtual environments"를 사용하면 전역으로 설치하는 대신 특정 응용 프로그램에 대한 격리된 위치에 Python 패키지를 설치할 수 있습니다. venv 폴더에 설치하려면 DIR 다음 단계를 수행해야 합니다.
python3 -m venv <DIR>
source <DIR>/bin/activate # MacOS/ Linux
<DIR>\Scripts\activate # Windows
pip install pypylon
deactivate
이는 Docker, WSL, Raspberry Pi 및 Conda 설정 내에서도 동일하게 작동합니다. 각 프로젝트는 고유한 종속성 트리를 가지며, 한 프로젝트의 업그레이드가 다른 프로젝트에 영향을 미치지 않습니다.
대안 2: 시스템 전체 설치#
sudo python3 -m pip install pypylon --break-system-packages
이 접근 방식은 다소 간단하며 모듈을 모든 사용자가 즉시 사용할 수 있습니다. 그러나 루트 권한이 필요할 뿐만 다음과 같은 단점도 있습니다.
- Debian 패키지 관리와 충돌할 수 있습니다.
- 향후 Debian 또는 Python 업데이트로 인해 문제가 발생할 수 있습니다.
일반적으로 최신 Debian 시스템에서는 이 접근 방식을 권장하지 않습니다.
설치 확인#
pypylon 설치를 확인하려면 다음 명령을 실행합니다.
from pypylon import pylon
factory = pylon.TlFactory.GetInstance()
devices = factory.EnumerateDevices()
print("Detected:", len(devices))
GigE 최적화#
GigE 카메라를 사용할 계획인 경우 다음과 같은 최적화를 권장합니다.
- 전용 네트워크 인터페이스 카드(NIC) 사용
- 점보 프레임 활성화(MTU 9000)
- 절전 기능 비활성화
pypylon 배포#
Pypylon은 완전한 pylon 런타임을 제공합니다. 따라서 pylon Software Suite를 설치할 필요가 없습니다.
카메라 또는 프레임 그래버 드라이버가 추가로 필요한 경우 pylon 배포 가이드를 참조하십시오.