For programmatic upload of files to Cellencis
Project description
\n# biomage-programmatic-interface
About
This python package provides an easy way to create projects and upload samples into Biomage.
Installation
To install the package execute the following line:
pip install biomage-programmatic-interface
Usage
In order to use the package you first need to create an account in Biomage (https://scp.biomage.net/) if you don't have one yet.
Then the package is used in the following way:
import biomage_programmatic_interface as bpi
# 1. Authenticate user and create a connection tunnel with the api
# Default instance-url: https://api.scp.biomage.net/
connection = bpi.Connection('email', 'password', 'instance_url')
# 2. Create an experiment
experiment = connection.create_experiment('experiment name')
# 3. Upload samples associated with the experiment
experiment.upload_samples('local/path/to/samples')
Once the upload is complete you can navigate to Biomage and process your project there.
Connection
class
The object accepts 3 parameters:
email
- Biomage emailpassword
- Biomage passwordinstance_url
- Biomage instance url
- Copy the url of the Biomage instance excluding
https://
- If the url is https://scp.biomage.net/ enter just the domain name:
scp.biomage.net
Development
If you cloned the repository and want to try using your local version, do the following:
- Install the local version of the pip package:
cd programmatic_interface
make install
- Now you can import the package and use your local version
import biomage_programmatic_interface as bpi
NOTE: There is NO need to run make install
every time you make changes to the package. When the local changes have been saved the changes will be automatically reflected.
Running with local instance of Cellenics
When creating the connection
object set the instance_url
to local
. Now the programmatic interface will use your local api (https://localhost:3000)
import biomage_programmatic_interface as bpi
conn = bpi.Connection(<YOUR EMAIL>, <YOUR PASSWORD>, 'local')
...
Running with staged environment
Set the full path of the instance url (e.g. https://api-{ENVIRONMENT NAME}.scp-staging.biomage.net/
)
import biomage_programmatic_interface as bpi
conn = bpi.Connection(<YOUR EMAIL>, <YOUR PASSWORD>, 'https://api-{ENVIRONMENT NAME}.scp-staging.biomage.net/')
...
NOTE: the url is that of the api (i.e. api-
) and not that of the ui
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for biomage_programmatic_interface-0.0.28.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | c213c8864a423e17ddb642926f42aa683d8a58133b17db281c5b269120b5e33d |
|
MD5 | 91e4410a7174c84ed56f67ac122739c1 |
|
BLAKE2b-256 | 3c9bf9d44ebe1eee292bc60335164432862d5fcd14a0bb52c87d5a4ecb210564 |
Hashes for biomage_programmatic_interface-0.0.28-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 7a40b4fc4267a052f9c34f83bd03a9e103dbf187d82325cfb5651abdfa26ae4f |
|
MD5 | 67dbdda5fddd20fca3dde1f2c3a89990 |
|
BLAKE2b-256 | 117fa9d296c5eeb74b17d87ff2b08be929403a3f7b8606c48bab43da9b8d6cb0 |