cytomine-python-client-2.9.0.tar.gz

STEP 1: Have you installed this repository?

If not, run this installation script command:

curl -s https://packagecloud.io/install/repositories/cytomine-uliege/Cytomine-python-client/script.python.sh | bash
copy
curl -s https://packagecloud.io/install/repositories/cytomine-uliege/Cytomine-python-client/script.python.sh | bash

STEP 2: Install the package
sudo pip install cytomine-python-client==2.9.0

Python client to interact with Cytomine.

Full description:
  # Cytomine Python client
 > Cytomine-python-client is an open-source Cytomine client written in Python. This client is a Python wrapper around Cytomine REST API gateway.
 [![Build Status](https://travis-ci.com/Cytomine-ULiege/Cytomine-python-client.svg?branch=master)](https://travis-ci.com/Cytomine-ULiege/Cytomine-python-client)
 [![GitHub release](https://img.shields.io/github/release/Cytomine-ULiege/Cytomine-python-client.svg)](https://github.com/Cytomine-ULiege/Cytomine-python-client/releases)
 [![GitHub](https://img.shields.io/github/license/Cytomine-ULiege/Cytomine-python-client.svg)](https://github.com/Cytomine-ULiege/Cytomine-python-client/blob/master/LICENSE)
 ## Overview
 The main access point to Cytomine data is its REST API. This client is a Python package that can be imported in an application and allows to import/export data from Cytomine-Core and Cytomine-IMS using RESTful web services e.g. to generate annotation (spatial) statistics, create regions of interest (e.g. tumor masks), add metadata to images/annotations, apply algorithms on image tiles, ...
 See [documentation](http://doc.cytomine.be/display/ALGODOC/%5BDOC%5D+Data+access) for more details.
 ## Requirements
 * Python 2.7 | 3.5+
 ## Install
 **To install *official* release of Cytomine-python-client, see @cytomine. Follow this guide to install forked version by ULiege.**
 ### Automatic installation
 To retrieve package using `pip`:
 pip install --extra-index-url=https://packagecloud.io/cytomine-uliege/Cytomine-python-client/pypi/simple cytomine-python-client
 or, to add the extra index permanently to your `pip` configuration:
 curl -s https://packagecloud.io/install/repositories/cytomine-uliege/Cytomine-python-client/script.python.sh | bash
 pip install cytomine-python-client
 See [package repository](https://packagecloud.io/cytomine-uliege/Cytomine-python-client) for details.
 ### Manual installation
 To download and install manually the package in a Python env, run (here for version 2.7.3):
 wget https://github.com/Cytomine-ULiege/Cytomine-python-client/releases/download/v2.7.3/Cytomine-Python-Client-2.7.3.zip
 unzip Cytomine-Python-Client-2.7.3.zip
 cd Cytomine-Python-Client-2.7.3
 pip install .
 For more details and manual installation with Miniconda, see [manual installation procedure](http://doc.cytomine.be/display/ALGODOC/Data+access+using+Python+client#DataaccessusingPythonclient-Installation).
 ### In a Docker container
 To ease developpement of new Cytomine software, the Cytomine-python-client package is available in Docker containers:
 * [cytomineuliege/software-python3-base](https://hub.docker.com/r/cytomineuliege/software-python3-base/) provides a Python 3.5 environment with client already installed.
 * [cytomineuliege/software-python2-base](https://hub.docker.com/r/cytomineuliege/software-python2-base/) provides a Python 2.7 environment with client already installed.
 These Docker images are tagged with the Python client version number. Two image variants are given for each client version:
 * `cytomineuliege/software-pythonX-base:<version>` is the defacto image. If you are unsure about what your needs are, you probably want to use this one.
 * `cytomineuliege/software-pythonX-base:<version>-slim` is an image that does not contain all the common package contained in the default tag and only contains the minimal packages needed to run Python. If you are working in an environment where only the python image will be deployed and you have space constraints, we recommend to use this one.
 See [official python Docker image](https://hub.docker.com/_/python/) for more details.
 ## Usage
 See [detailed usage documentation](http://doc.cytomine.be/display/ALGODOC/Data+access+using+Python+client#DataaccessusingPythonclient-Usage).
 ### Basic example
 Three parameters are required to connect:
 * `HOST`: The full URL of Cytomine core (e.g. “http://demo.cytomine.be”).
 * `PUBLIC_KEY`: Your cytomine public key.
 * `PRIVATE_KEY`: Your cytomine private key.
 First, the connection object has to be initialized.
 from cytomine import Cytomine
 host = "demo.cytomine.be"
 public_key = "XXX" # check your own keys from your account page in the web interface
 private_key = "XXX"
 cytomine = Cytomine.connect(host, public_key, private_key)
 The next sample code should print “Hello {username}” where {username} is replaced by your Cytomine username and print the list of available projects.
 from cytomine.models import ProjectCollection
 print("Hello {}".format(cytomine.current_user))
 projects = ProjectCollection().fetch()
 print(projects)
 for project in projects:
 print(project)
 ### Other examples
 * [Scripts in examples directory](https://github.com/Cytomine-ULiege/Cytomine-python-client/tree/master/examples)
 * [Documentation by examples](http://doc.cytomine.be/display/ALGODOC/Data+access+using+Python+client#DataaccessusingPythonclient-Usage)
 ## References
 When using our software, we kindly ask you to cite our website url and related publications in all your work (publications, studies, oral presentations,...). In particular, we recommend to cite (Marée et al., Bioinformatics 2016) paper, and to use our logo when appropriate. See our license files for additional details.
 - URL: http://www.cytomine.org/
 - Logo: [Available here](https://cytomine.coop/sites/cytomine.coop/files/inline-images/logo-300-org.png)
 - Scientific paper: Raphaël Marée, Loïc Rollus, Benjamin Stévens, Renaud Hoyoux, Gilles Louppe, Rémy Vandaele, Jean-Michel Begon, Philipp Kainz, Pierre Geurts and Louis Wehenkel. Collaborative analysis of multi-gigapixel imaging data using Cytomine, Bioinformatics, DOI: [10.1093/bioinformatics/btw013](http://dx.doi.org/10.1093/bioinformatics/btw013), 2016.
 ## License
 Apache 2.0

Checksums

MD5 7212ad1ae1fd423ea66f391051300051
SHA1 196ecd46b000b69ba159396d2fe2501493d1be26
SHA256 4e629e857a478d9638cf9d2a3dd2d3f4abe9a954ceba2bd45276df6d39745783
SHA512 8d42d963725b3d02cdf263fd8b6bb71cb1a93cb5adb2c6139c196791b2ce1f2b6c7a8bafd3040ce29c28148f6c4e939dd4a6d76a3bbb3cec86c20e255cfee4bd

Files

  • cytomine-python-client-2.9.0/setup.py
  • cytomine-python-client-2.9.0/setup.cfg
  • cytomine-python-client-2.9.0/requirements.txt
  • cytomine-python-client-2.9.0/requirements-py2.7.txt
  • cytomine-python-client-2.9.0/README.md
  • cytomine-python-client-2.9.0/pyproject.toml
  • cytomine-python-client-2.9.0/PKG-INFO
  • cytomine-python-client-2.9.0/LICENSE
  • cytomine-python-client-2.9.0/cytomine/utilities/wholeslide.py
  • cytomine-python-client-2.9.0/cytomine/utilities/software.py
  • cytomine-python-client-2.9.0/cytomine/utilities/reader.py
  • cytomine-python-client-2.9.0/cytomine/utilities/geometry.py
  • cytomine-python-client-2.9.0/cytomine/utilities/descriptor_reader.py
  • cytomine-python-client-2.9.0/cytomine/utilities/annotations.py
  • cytomine-python-client-2.9.0/cytomine/utilities/__init__.py
  • cytomine-python-client-2.9.0/cytomine/models/user.py
  • cytomine-python-client-2.9.0/cytomine/models/track.py
  • cytomine-python-client-2.9.0/cytomine/models/storage.py
  • cytomine-python-client-2.9.0/cytomine/models/software.py
  • cytomine-python-client-2.9.0/cytomine/models/social.py
  • cytomine-python-client-2.9.0/cytomine/models/property.py
  • cytomine-python-client-2.9.0/cytomine/models/project.py
  • cytomine-python-client-2.9.0/cytomine/models/ontology.py
  • cytomine-python-client-2.9.0/cytomine/models/model.py
  • cytomine-python-client-2.9.0/cytomine/models/imagegroup.py
  • cytomine-python-client-2.9.0/cytomine/models/image.py
  • cytomine-python-client-2.9.0/cytomine/models/collection.py
  • cytomine-python-client-2.9.0/cytomine/models/annotation.py
  • cytomine-python-client-2.9.0/cytomine/models/_utilities/pattern_matching.py
  • cytomine-python-client-2.9.0/cytomine/models/_utilities/parallel.py

Uploaded

almost 2 years ago

Package Size

50.8 KB

Downloads

24

wget

wget --content-disposition "https://packagecloud.io/cytomine-uliege/Cytomine-python-client/packages/python/cytomine-python-client-2.9.0.tar.gz/download?distro_version_id=166"

Homepage

https://www.cytomine.org

License

LICENSE