The genicam module is the official Python binding of GenICam that is developed and maintained by the GenICam committee.
About the genicam module
The genicam module consists of two sub-modules. The one is genapi and the other is gentl. The genapi module gives you a way to control GenICam features of the target device supports. On the other hand, the gentl module gives you a way to control functionality that the target GenTL Producer supports.
Using the genicam module
The genapi module
In this section, you will learn how to use the genapi module.
Creating a node map object
First, you create a node map object instantiating the NodeMap class:
from genicam.genapi import NodeMap
node_map = NodeMap()And then, load a device description file on the node map object. The NodeMap object supports several ways to make it. One is to load the file content as a str object:
file_content = 'blabla'
node_map.load_xml_from_string(file_content)Another way is to load the file as an XML file:
file = an_xml_file
node_map.load_xml_from_file(file)The other ways is to load the file as a Zip file:
file = a_zip_file
node_map.load_xml_from_zip_file(file)Changing a feature value
Once you loaded a device description file on a node map object, you would start to control GenICam feature nodes to control the target device. Now assume that we are going to control a GenICam feature node called Foo. To get the value of Foo, we code as follows:
a = node_map.Foo.valueOn the other hand, if Foo is an Integer node then we code as follows to set a value:
node_map.Foo.value = 42If Foo is a Boolean node, then you code as follows:
node_map.Foo.value = TrueOr if Foo is an Enumeration node, then you code as follows; it also works for a case where Foo is a String node:
node_map.Foo.value = 'Bar'If Foo is a Command node, then you can execute the command with the following code:
node_map.Foo.execute()The gentl module
In this section, you will learn how to use the gentl module.
[TO BE DOCUMENTED]
Links
Harvester
There is a sister project of the GenICam Python binding. It’s called Harvester and is a reference implementation of the GenICam Python binding. Harvester gives you an intuitive way for image acquisition to make your life easier.
Harvester is distributed under the Apache version 2 license so you can use it for free; however, note that GenICam applies for another license. The source code can be found at GitHub.
In addition, Haveseter is also uploaded to PyPi repository so You can install that executing the following pip command:
$ pip install harvestersEMVA
In the EMVA website, you can get useful resources to learn and use GenICam standards and its compliant devices and software:
It would be worth knowing the following keywords: GenApi, GenTL, SFNC, GenTL SFNC, CLProtocol, PFNC, and GenCP.
1 maintainer
Metadata
1 maintainer
Release files for genicam 1.6.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Built distributions (wheels)
Total release size: 59.8 MB
Release files / genicam-1.6.0-cp314-cp314-win_amd64.whl
| Download URL | genicam-1.6.0-cp314-cp314-win_amd64.whl |
|---|---|
| Size | 1.8 MB |
| Tags | CPython 3.14 Windows x86-64 |
|
SHA-256 checksum How to use checksums |
7630b7844b273080f21f01881c56667cc68521186b75dd15798f5dee1f8f1037
|
|
BLAKE2b-256 checksum How to use checksums |
2418c6f0b7f3da480aac0c86d104664e9cf144675986cc4e3f108c909bec0ddf
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.10.9
|
Release files / genicam-1.6.0-cp314-cp314-manylinux2014_x86_64.whl
| Download URL | genicam-1.6.0-cp314-cp314-manylinux2014_x86_64.whl |
|---|---|
| Size | 2.8 MB |
| Tags | CPython 3.14 Linux glibc 2.17+ x86-64 |
|
SHA-256 checksum How to use checksums |
d1e12e276eab6dbe8dec37e060ea5a8cc5758cc8c3502a048782e38a0451517d
|
|
BLAKE2b-256 checksum How to use checksums |
38ffa8c90b9a7d99fa6008437491f1198264c22d49572a0013a05bc1c579e034
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.10.9
|
Release files / genicam-1.6.0-cp314-cp314-manylinux2014_armv7l.whl
| Download URL | genicam-1.6.0-cp314-cp314-manylinux2014_armv7l.whl |
|---|---|
| Size | 2.2 MB |
| Tags | CPython 3.14 Linux glibc 2.17+ ARMv7l |
|
SHA-256 checksum How to use checksums |
e3f9ff542bbd2fe389e1a94e4a694ec34f94ab378247c5f7e761b78ff5891d24
|
|
BLAKE2b-256 checksum How to use checksums |
4506ea8b6c2f4536cd8f54961040edae1ad9ff8a3dced2081a2377dac600bb73
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.10.9
|
Release files / genicam-1.6.0-cp314-cp314-manylinux2014_aarch64.whl
| Download URL | genicam-1.6.0-cp314-cp314-manylinux2014_aarch64.whl |
|---|---|
| Size | 2.6 MB |
| Tags | CPython 3.14 Linux glibc 2.17+ ARM64 |
|
SHA-256 checksum How to use checksums |
3dcf4af1fabb1cee06cac0bed6560f0e49180dab1e078501949eaf07596736c3
|
|
BLAKE2b-256 checksum How to use checksums |
f1322ef1193d27bb375e3d9822be883e987d75203fcb417bafa96fd77fe8be18
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.10.9
|
Release files / genicam-1.6.0-cp314-cp314-macosx_13_0_arm64.whl
| Download URL | genicam-1.6.0-cp314-cp314-macosx_13_0_arm64.whl |
|---|---|
| Size | 2.6 MB |
| Tags | CPython 3.14 macOS 13.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
064a87188b6102bac03a8ab1ccff5280e8fa4cf6378448e6286ed6f4cc9f7a64
|
|
BLAKE2b-256 checksum How to use checksums |
502698a864061d25e78b96b7d621814b399a78fb7603ae6a6ac871648587bc49
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.10.9
|
Release files / genicam-1.6.0-cp313-cp313-win_amd64.whl
| Download URL | genicam-1.6.0-cp313-cp313-win_amd64.whl |
|---|---|
| Size | 1.8 MB |
| Tags | CPython 3.13 Windows x86-64 |
|
SHA-256 checksum How to use checksums |
740156c5fa8d82330d36314112f4b755e8333c16f82792174f1a2a2e150519ae
|
|
BLAKE2b-256 checksum How to use checksums |
ae38895e9effffc858ff06996a9eed28decdc9b5b2176b2cfd82df8c4f65bdec
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.10.9
|
Release files / genicam-1.6.0-cp313-cp313-manylinux2014_x86_64.whl
| Download URL | genicam-1.6.0-cp313-cp313-manylinux2014_x86_64.whl |
|---|---|
| Size | 2.8 MB |
| Tags | CPython 3.13 Linux glibc 2.17+ x86-64 |
|
SHA-256 checksum How to use checksums |
a342980e80735b7b1e4f18f6c33d64eccc3e95887dd72f302409f1296bef3dac
|
|
BLAKE2b-256 checksum How to use checksums |
75eb37363beb1880674ff0976ff7607e2e045933c6388d08d98bc0b512df941c
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.10.9
|
Release files / genicam-1.6.0-cp313-cp313-manylinux2014_armv7l.whl
| Download URL | genicam-1.6.0-cp313-cp313-manylinux2014_armv7l.whl |
|---|---|
| Size | 2.2 MB |
| Tags | CPython 3.13 Linux glibc 2.17+ ARMv7l |
|
SHA-256 checksum How to use checksums |
efe646df5e8ca76208c6621e8a5dbea3e9909641801787993ea2d7ec4a704c09
|
|
BLAKE2b-256 checksum How to use checksums |
413725a84938b5ec34fc6123006a3f4173fead4fde3b460b516749a8ae8c1b02
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.10.9
|
Release files / genicam-1.6.0-cp313-cp313-manylinux2014_aarch64.whl
| Download URL | genicam-1.6.0-cp313-cp313-manylinux2014_aarch64.whl |
|---|---|
| Size | 2.6 MB |
| Tags | CPython 3.13 Linux glibc 2.17+ ARM64 |
|
SHA-256 checksum How to use checksums |
f4d6496660507b32a7f6ef05f5344bcd305ea3e2158a41bf53169663d7a72e70
|
|
BLAKE2b-256 checksum How to use checksums |
105986ae5cbc1a89f70c2b3b906e692a46b977e9230664781cd5a304012f6b20
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.10.9
|
Release files / genicam-1.6.0-cp313-cp313-macosx_13_0_arm64.whl
| Download URL | genicam-1.6.0-cp313-cp313-macosx_13_0_arm64.whl |
|---|---|
| Size | 2.6 MB |
| Tags | CPython 3.13 macOS 13.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
f5c35275014f4793b34a21ebe8bbcb269a87b5d1bf129daf2818c6160f8758c9
|
|
BLAKE2b-256 checksum How to use checksums |
7ff1b5f641ad64c296462ab2ca314b8a471827142b949606ebe8b69bff7e6a08
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.10.9
|
Release files / genicam-1.6.0-cp312-cp312-win_amd64.whl
| Download URL | genicam-1.6.0-cp312-cp312-win_amd64.whl |
|---|---|
| Size | 1.8 MB |
| Tags | CPython 3.12 Windows x86-64 |
|
SHA-256 checksum How to use checksums |
1d2bb3f39443c5bc248fcbde83a3a973370ca43588a7c1ded7d7324d7d9427d3
|
|
BLAKE2b-256 checksum How to use checksums |
a34ae643cac4031ad7b1780ab19bcdeb6b0545e829b2ee10ea37ca1185d9417d
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.10.9
|
Release files / genicam-1.6.0-cp312-cp312-manylinux2014_x86_64.whl
| Download URL | genicam-1.6.0-cp312-cp312-manylinux2014_x86_64.whl |
|---|---|
| Size | 2.8 MB |
| Tags | CPython 3.12 Linux glibc 2.17+ x86-64 |
|
SHA-256 checksum How to use checksums |
83da90404da189a87273864f2c97c761c1807fc6fc532fabd3bf50c0ae28f8ae
|
|
BLAKE2b-256 checksum How to use checksums |
309c49d68f5055e970e4e4d834bc3df686a01f7bd82e070888fc7ad2c86e2eaf
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.10.9
|
Release files / genicam-1.6.0-cp312-cp312-manylinux2014_armv7l.whl
| Download URL | genicam-1.6.0-cp312-cp312-manylinux2014_armv7l.whl |
|---|---|
| Size | 2.2 MB |
| Tags | CPython 3.12 Linux glibc 2.17+ ARMv7l |
|
SHA-256 checksum How to use checksums |
b65beca4b425442922a2f2beefae1e3109ce166cfd726fcd9d2ac59ff1d57e24
|
|
BLAKE2b-256 checksum How to use checksums |
8fac3b8496c446715008e77dda7439735c428f163aab0a3f643352407a259a52
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.10.9
|
Release files / genicam-1.6.0-cp312-cp312-manylinux2014_aarch64.whl
| Download URL | genicam-1.6.0-cp312-cp312-manylinux2014_aarch64.whl |
|---|---|
| Size | 2.6 MB |
| Tags | CPython 3.12 Linux glibc 2.17+ ARM64 |
|
SHA-256 checksum How to use checksums |
3a1a16b89fec69d52142781f280ce2c01a4c1422da1cd08893ed1cd630d11c30
|
|
BLAKE2b-256 checksum How to use checksums |
0768499657bf3e5111fe1c87e3364c2ae6b59fe912d7184fccf591eafd762ceb
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.10.9
|
Release files / genicam-1.6.0-cp312-cp312-macosx_13_0_arm64.whl
| Download URL | genicam-1.6.0-cp312-cp312-macosx_13_0_arm64.whl |
|---|---|
| Size | 2.6 MB |
| Tags | CPython 3.12 macOS 13.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
d0becabb469d0f51f9d4820d655d2788c620a8ee1c8abcfa4703cac87ba27f53
|
|
BLAKE2b-256 checksum How to use checksums |
b7840dc939a435deef267d82bc6aaa4b7ed9c89510766454640622608d0e7ce5
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.10.9
|
Release files / genicam-1.6.0-cp311-cp311-win_amd64.whl
| Download URL | genicam-1.6.0-cp311-cp311-win_amd64.whl |
|---|---|
| Size | 1.8 MB |
| Tags | CPython 3.11 Windows x86-64 |
|
SHA-256 checksum How to use checksums |
ef1d25c7e9823689dbfb9e08d8fdb46e0f05982ca9c27d1eeacc1aa8fcd69f6e
|
|
BLAKE2b-256 checksum How to use checksums |
d4ec19092034d0f66646d97b85e1549b6b4e2448f5287bb3a76b5a8cd677ba4a
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.10.9
|
Release files / genicam-1.6.0-cp311-cp311-manylinux2014_x86_64.whl
| Download URL | genicam-1.6.0-cp311-cp311-manylinux2014_x86_64.whl |
|---|---|
| Size | 2.8 MB |
| Tags | CPython 3.11 Linux glibc 2.17+ x86-64 |
|
SHA-256 checksum How to use checksums |
589b1152f22ca766f8b5e1dff9c1b4006c2eb7f5ee33152619ef6ece8a5a3f47
|
|
BLAKE2b-256 checksum How to use checksums |
e6b3252e5d64022984de4a78220c456f1f91742dbd7bb02d5b3926ed4c228015
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.10.9
|
Release files / genicam-1.6.0-cp311-cp311-manylinux2014_armv7l.whl
| Download URL | genicam-1.6.0-cp311-cp311-manylinux2014_armv7l.whl |
|---|---|
| Size | 2.2 MB |
| Tags | CPython 3.11 Linux glibc 2.17+ ARMv7l |
|
SHA-256 checksum How to use checksums |
a750ffb11194f02740531bc0f62bf7013d39f2eea65f5e283c7811ab757fc987
|
|
BLAKE2b-256 checksum How to use checksums |
389268c0033f076ad1defed2e6bf1cec8fc720a24622fb0389013b058e841234
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.10.9
|
Release files / genicam-1.6.0-cp311-cp311-manylinux2014_aarch64.whl
| Download URL | genicam-1.6.0-cp311-cp311-manylinux2014_aarch64.whl |
|---|---|
| Size | 2.6 MB |
| Tags | CPython 3.11 Linux glibc 2.17+ ARM64 |
|
SHA-256 checksum How to use checksums |
4207d7ccee9deb755ad372c0b473fd2f23e4e42da61e06e4a7873d199b883a0f
|
|
BLAKE2b-256 checksum How to use checksums |
bd1bbf993221a155d2fd35c8201be97cd0376e005bf1cc82dec27105a712d3b1
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.10.9
|
Release files / genicam-1.6.0-cp311-cp311-macosx_13_0_arm64.whl
| Download URL | genicam-1.6.0-cp311-cp311-macosx_13_0_arm64.whl |
|---|---|
| Size | 2.6 MB |
| Tags | CPython 3.11 macOS 13.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
2a5bfeb3b9796cf6667192c2957f8ea7ec240ff42e76cc6e3e05d1d0230bf68a
|
|
BLAKE2b-256 checksum How to use checksums |
3e3997c9a39fde61441731a383bde6a86b079a5a9d1d22c6d9eb16556b77016e
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.10.9
|
Release files / genicam-1.6.0-cp310-cp310-win_amd64.whl
| Download URL | genicam-1.6.0-cp310-cp310-win_amd64.whl |
|---|---|
| Size | 1.8 MB |
| Tags | CPython 3.10 Windows x86-64 |
|
SHA-256 checksum How to use checksums |
dc8fa336bc3d3bcb8f22bd6e4df9dd7fa99f53237fc7813fce4053eaafb3aac5
|
|
BLAKE2b-256 checksum How to use checksums |
2a849d5513437ced20749a58145632d7c9f4f11c7fcf1f819ab9233fe04c6840
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.10.9
|
Release files / genicam-1.6.0-cp310-cp310-manylinux2014_x86_64.whl
| Download URL | genicam-1.6.0-cp310-cp310-manylinux2014_x86_64.whl |
|---|---|
| Size | 2.8 MB |
| Tags | CPython 3.10 Linux glibc 2.17+ x86-64 |
|
SHA-256 checksum How to use checksums |
eb5bcae2749005ad649d18ccce23368a463a889f7b20987549f63344e5c2158c
|
|
BLAKE2b-256 checksum How to use checksums |
1d45f8d0b0a42acb22655d4a694bcb9b1594990224774c80d30f9b7d2a004cee
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.10.9
|
Release files / genicam-1.6.0-cp310-cp310-manylinux2014_armv7l.whl
| Download URL | genicam-1.6.0-cp310-cp310-manylinux2014_armv7l.whl |
|---|---|
| Size | 2.2 MB |
| Tags | CPython 3.10 Linux glibc 2.17+ ARMv7l |
|
SHA-256 checksum How to use checksums |
596295c2fb71c211f14454a40f1270cc411a447eb4087098d80ee2c02fab62e2
|
|
BLAKE2b-256 checksum How to use checksums |
c6341e610e0f605b88b57fd47912c71c00819f9b30b2b6f10eb83bdcb3dd44d7
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.10.9
|
Release files / genicam-1.6.0-cp310-cp310-manylinux2014_aarch64.whl
| Download URL | genicam-1.6.0-cp310-cp310-manylinux2014_aarch64.whl |
|---|---|
| Size | 2.6 MB |
| Tags | CPython 3.10 Linux glibc 2.17+ ARM64 |
|
SHA-256 checksum How to use checksums |
2c75d6d38de9b7a72ae3e49a7cf03901fa4a167f9d049c5450913094b0411886
|
|
BLAKE2b-256 checksum How to use checksums |
2fbf035e0ab1fe09dc9b85a31bacd3cfb66460d48eb0a9b770e847bed61ffd54
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.10.9
|
Release files / genicam-1.6.0-cp310-cp310-macosx_13_0_arm64.whl
| Download URL | genicam-1.6.0-cp310-cp310-macosx_13_0_arm64.whl |
|---|---|
| Size | 2.6 MB |
| Tags | CPython 3.10 macOS 13.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
6e4dd58017fb5168c3164ba6ff1642a7798d74ebc58e3b7c0e32ea18dcfc45a0
|
|
BLAKE2b-256 checksum How to use checksums |
1bdfc979b35566a00c7a98e53254dff4d9c44b88ac9c7b5638b03eb606d76356
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.10.9
|
