Skip to content

Commit d5edc3c

Browse files
committed
Expand basler tips in docs/
1 parent 86cc958 commit d5edc3c

1 file changed

Lines changed: 61 additions & 3 deletions

File tree

docs/camera_support.md

Lines changed: 61 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -66,12 +66,70 @@ The `get_image_on_time` method has no input arguments, but must return an image
6666

6767
### Camera Specific Tips for Installation & Use:
6868

69-
- For **Basler cameras**, `pylon viewer` need to be installed. It can be downloaded for many platforms on the Basler website.
70-
As an example (tested on ubuntu 20.04, contributed by [@antortjim](https://github.com/antortjim)):
69+
#### Basler cameras
70+
71+
Basler USB3 cameras are compatible with Aravis. However, integration with DeepLabCut can also be obtained with `pypylon`, the python module to drive Basler cameras, and supported by the company. Please note using `pypylon` requires you to install Pylon viewer, a free of cost GUI also developed and supported by Basler and available on several platforms.
72+
73+
* **Pylon viewer**: https://www.baslerweb.com/en/sales-support/downloads/software-downloads/#type=pylonsoftware;language=all;version=all
74+
* `pypylon`: https://github.com/basler/pypylon/releases
75+
76+
If you want to use DeepLabCut with a Basler USB3 camera via pypylon, see the folllowing instructions. Please note this is tested on Ubuntu 20.04. It may (or may not) work similarly in other platforms (contributed by [@antortjim](https://github.com/antortjim)). This procedure should take around 10 minutes:
77+
78+
**Install Pylon viewer**
79+
80+
1. Download .deb file
81+
Download the .deb file in the downloads center of Basler. Last version as of writing this was **pylon 6.2.0 Camera Software Suite Linux x86 (64 Bit) - Debian Installer Package**.
82+
83+
84+
2. Install .deb file
85+
86+
```
87+
sudo dpkg -i pylon_6.2.0.21487-deb0_amd64.deb
88+
```
89+
90+
**Install swig**
91+
92+
Required for compilation of non python code within pypylon
93+
94+
1. Install swig dependencies
95+
96+
You may have to install these in a fresh Ubuntu 20.04 install
97+
98+
```
99+
sudo apt install gcc g++
100+
sudo apt install libpcre3-dev
101+
sudo apt install make
102+
```
103+
104+
2. Download swig
105+
106+
Go to http://prdownloads.sourceforge.net/swig/swig-4.0.2.tar.gz and download the tar gz
107+
108+
3. Install swig
109+
```
110+
tar -zxvf swig-4.0.2.tar.gz
111+
cd swig-4.0.2
112+
./configure
113+
make
114+
sudo make install
115+
```
116+
117+
**Install pypylon**
118+
119+
1. Download pypylon
120+
71121
```
72122
wget https://github.com/basler/pypylon/archive/refs/tags/1.7.2.tar.gz
123+
```
124+
125+
or go to https://github.com/basler/pypylon/releases and get the version you want!
126+
127+
2. Install pypylon
128+
129+
```
73130
tar -zxvf 1.7.2.tar.gz
74131
cd pypylon-1.7.2
75132
python setup.py install
76-
# this installs pypylon version 6.1.1
77133
```
134+
135+
Once you have completed these steps, you should be able to call your Basler camera from DeepLabCut using the BaslerCam camera type that appears after clicking "Add camera")

0 commit comments

Comments
 (0)