Skip to content

Commit f24a80e

Browse files
updated readme
1 parent d25c827 commit f24a80e

2 files changed

Lines changed: 16 additions & 24 deletions

File tree

IntrepidCS.png

5.16 KB
Loading

README.md

Lines changed: 16 additions & 24 deletions
Original file line numberDiff line numberDiff line change
@@ -1,41 +1,33 @@
1-
# python_ics
1+
![](IntrepidCS.png)
22

3-
Python C Code module for interfacing to the icsneo40 dynamic library. Code tries to respect PEP 8 (https://www.python.org/dev/peps/pep-0008/). Function naming convention does not follow the tradition c style icsneo40 naming convention as the python_ics module name acts as the namespace (icsneo portion of the function) and function names are suppose to be lowercase with underscores instead of mixedCase like icsneo API.
3+
![](https://github.com/intrepidcs/python_ics/actions/workflows/wheels.yml/badge.svg)
4+
5+
# Description
6+
7+
Python wrapper for interfacing to IntrepidCS Hardware.
48

59
# Installing
610

711
- `pip install python_ics`
812

9-
- Placing icsneo40.dll in the system path as the api uses this DLL extensively.
13+
## Platform specific Installation notes
1014

11-
# How to use
15+
### Windows
1216

13-
#### Documentation
17+
- Windows requires icsneo40.dll to be installed in the PATH. This can be obtained through vspy3 or our hardware installation kit found here: https://cdn.intrepidcs.net/updates/files/RP1210KitInstall.zip
1418

15-
http://python-ics.readthedocs.io/
19+
### Linux
1620

17-
#### C API can be mimiced almost identically by doing the following:
21+
- Linux builds use [libicsneo](https://github.com/intrepidcs/libicsneo) and are built against [manylinux](https://github.com/pypa/manylinux) using cibuildwheel.
1822

19-
>>> import ics as icsneo
20-
>>> devices = icsneo.FindNeoDevices()
21-
>>> for device in devices:
22-
... print(device.Name, device.SerialNumber)
23-
...
24-
neoVI FIRE 59886
25-
26-
#### Recommended Python way by doing the following:
23+
### MacOS
2724

28-
>>> import ics
29-
>>> devices = ics.find_devices()
30-
>>> for device in devices:
31-
... print(device.Name, device.SerialNumber)
32-
...
33-
neoVI FIRE 59886
25+
- Mac builds use [libicsneo](https://github.com/intrepidcs/libicsneo) and are built using cibuildwheel
3426

35-
It should be noted that `ics.NeoDevice` is used a little bit differently than the C API. `ics.NeoDevice` contains two extra members:
27+
# Documentation
28+
29+
http://python-ics.readthedocs.io/
3630

37-
`ics.NeoDevice.AutoHandleClose` and `ics.NeoDevice._Handle`
38-
The handle normally returned from `icsneoOpenNeoDevice()` is stored inside `_Handle` and setting `AutoHandleClose` to `True` (Default) will automatically close the handle when the `ics.NeoDevice` goes out of scope.
3931

4032
# License - MIT
4133

0 commit comments

Comments
 (0)