|
1 |
| -# pyifcb - Imaging FlowCytobot Python API, generation 2 |
| 1 | +# pyifcb - Imaging FlowCytobot Python API |
2 | 2 |
|
3 | 3 | ## Overview
|
4 | 4 |
|
5 |
| -This module provides facilities for accessing and managing data generated by the Imaging FlowCytobot. It can read and write IFCB data in various formats, including the instrument's native format, and can serve as the basis of any application that uses IFCB data. |
| 5 | +This module provides facilities for accessing data generated by the Imaging FlowCytobot. It can read and write IFCB data in various formats, including the instrument's native format, and can serve as the basis of any application that uses IFCB data. |
6 | 6 |
|
7 |
| -Generation 1 of this data system was called the IFCB Data Dashboard. In this, generation 2, features of the dashboard are being broken out into smaller, independent modules that can be used together. |
8 |
| - |
9 |
| -## Authors and contributors |
10 |
| - |
11 |
| -Joe Futrelle ( [email protected]) - Woods Hole Oceanographic Institution |
12 |
| - |
13 |
| -## Installation via anaconda |
14 |
| - |
15 |
| -To create a conda environment called "pyifcb": |
| 7 | +## Installation |
16 | 8 |
|
| 9 | +### With `pip`: |
17 | 10 | ```
|
18 |
| -conda env create -f environment.yml |
19 |
| -conda activate pyifcb |
20 |
| -python setup.py install |
| 11 | +pip install git+https://github.com/joefutrelle/pyifcb |
21 | 12 | ```
|
| 13 | +It is strongly recommended that you use a version tag when installing pyifcb. See [releases](https://github.com/joefutrelle/pyifcb/releases) for available version tags. |
22 | 14 |
|
23 |
| -Or to update an existing conda environment: |
24 |
| - |
| 15 | +For example to install pyifcb 1.1.1, |
25 | 16 | ```
|
26 |
| -conda update -n {name of existing envrionment} -f environment.yml |
27 |
| -conda activate {name of existing environment} |
28 |
| -python setup.py install |
| 17 | +pip install 'git+https://github.com/joefutrelle/[email protected]' |
29 | 18 | ```
|
30 | 19 |
|
31 |
| -If you want to update your pyifcb installation when the code is updated, use `python setup.py develop` instead. |
32 |
| - |
33 |
| -## Status |
| 20 | +### From the latest git commit: |
| 21 | +``` |
| 22 | +git clone https://github.com/joefutrelle/pyficb |
| 23 | +cd pyifcb |
| 24 | +pip install . |
| 25 | +``` |
34 | 26 |
|
35 |
| -As of 2017-04-28 pyifcb requires Python 3. |
| 27 | +## Documentation |
36 | 28 |
|
37 |
| -As of 2017-01-04 this is mostly complete and the APIs are not likely to change much, but there is no stable release yet so APIs may still change. The Wiki and code-level documentation is up to date. |
| 29 | +For complete documentation, see this repo's [wiki](https://github.com/joefutrelle/pyifcb/wiki). |
38 | 30 |
|
39 | 31 | 
|
40 | 32 |
|
0 commit comments