معرفی شرکت ها
darwin-py-0.9.0
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشتر
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشتر
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشتر
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشتر
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشترتوضیحات
Library and command line interface for darwin.v7labs.com
| ویژگی | مقدار |
|---|---|
| سیستم عامل | - |
| نام فایل | darwin-py-0.9.0 |
| نام | darwin-py |
| نسخه کتابخانه | 0.9.0 |
| نگهدارنده | [] |
| ایمیل نگهدارنده | [] |
| نویسنده | V7 |
| ایمیل نویسنده | info@v7labs.com |
| آدرس صفحه اصلی | https://docs.v7labs.com/reference/getting-started-2 |
| آدرس اینترنتی | https://pypi.org/project/darwin-py/ |
| مجوز | MIT |
# V7 Darwin Python SDK
Official library to manage datasets along with
[V7 Darwin annotation platform](https://darwin.v7labs.com).
Darwin-py can both be used from the [command line](#usage-as-a-command-line-interface-cli) and as a [python library](#usage-as-a-python-library).
Main functions are (but not limited to):
- Client authentication
- Listing local and remote datasets
- Create/remove datasets
- Upload/download data to/from remote datasets
- Direct integration with PyTorch dataloaders
Support tested for python 3.8.
## Installation
```
pip install darwin-py
```
You can now type `darwin` in your terminal and access the command line interface.
If you wish to use the PyTorch bindings, then you can use the `ml` flag to install all the additional requirements
```
pip install darwin-py[ml]
```
To run test, first install the `test` extra package
```
pip install darwin-py[test]
```
---
## Usage as a Command Line Interface (CLI)
Once installed, `darwin` is accessible as a command line tool.
A useful way to navigate the CLI usage is through the help command `-h/--help` which will
provide additional information for each command available.
### Client Authentication
To perform remote operations on Darwin you first need to authenticate.
This requires a [team-specific API-key](https://darwin.v7labs.com/?settings=api-keys).
If you do not already have a Darwin account, you can [contact us](https://www.v7labs.com/contact) and we can set one up for you.
To start the authentication process:
```
$ darwin authenticate
API key:
Make example-team the default team? [y/N] y
Datasets directory [~/.darwin/datasets]:
Authentication succeeded.
```
You will be then prompted to enter your API-key, whether you want to set the corresponding team as
default and finally the desired location on the local file system for the datasets of that team.
This process will create a configuration file at `~/.darwin/config.yaml`.
This file will be updated with future authentications for different teams.
### Listing local and remote datasets
Lists a summary of local existing datasets
```
$ darwin dataset local
NAME IMAGES SYNC_DATE SIZE
mydataset 112025 yesterday 159.2 GB
```
Lists a summary of remote datasets accessible by the current user.
```
$ darwin dataset remote
NAME IMAGES PROGRESS
example-team/mydataset 112025 73.0%
```
### Create/remove a dataset
To create an empty dataset remotely:
```
$ darwin dataset create test
Dataset 'test' (example-team/test) has been created.
Access at https://darwin.v7labs.com/datasets/579
```
The dataset will be created in the team you're authenticated for.
To delete the project on the server:
```
$ darwin dataset remove test
About to delete example-team/test on darwin.
Do you want to continue? [y/N] y
```
### Upload/download data to/from a remote dataset
Uploads data to an existing remote project.
It takes the dataset name and a single image (or directory) with images/videos to upload as
parameters.
The `-e/--exclude` argument allows to indicate file extension/s to be ignored from the data_dir.
e.g.: `-e .jpg`
For videos, the frame rate extraction rate can be specified by adding `--fps <frame_rate>`
Supported extensions:
- Video files: [`.mp4`, `.bpm`, `.mov` formats].
- Image files [`.jpg`, `.jpeg`, `.png` formats].
```
$ darwin dataset push test /path/to/folder/with/images
100%|████████████████████████| 2/2 [00:01<00:00, 1.27it/s]
```
Before a dataset can be downloaded, a release needs to be generated:
```
$ darwin dataset export test 0.1
Dataset test successfully exported to example-team/test:0.1
```
This version is immutable, if new images / annotations have been added you will have to create a new release to included them.
To list all available releases
```
$ darwin dataset releases test
NAME IMAGES CLASSES EXPORT_DATE
example-team/test:0.1 4 0 2019-12-07 11:37:35+00:00
```
And to finally download a release.
```
$ darwin dataset pull test:0.1
Dataset example-team/test:0.1 downloaded at /directory/choosen/at/authentication/time.
```
---
## Usage as a Python library
The framework is designed to be usable as a standalone python library.
Usage can be inferred from looking at the operations performed in `darwin/cli_functions.py`.
A minimal example to download a dataset is provided below and a more extensive one can be found in
[darwin_demo.py](./darwin_demo.py).
```python
from darwin.client import Client
client = Client.local() # use the configuration in ~/.darwin/config.yaml
dataset = client.get_remote_dataset("example-team/test")
dataset.pull() # downloads annotations and images for the latest exported version
```
Follow [this guide](https://docs.v7labs.com/docs/loading-a-dataset-in-python) for how to integrate darwin datasets directly in PyTorch.
نیازمندی
| مقدار | نام |
|---|---|
| >=2.0.0,<3.0.0 | argcomplete |
| >=4.4.0,<5.0.0 | humanize |
| >=9.4.0,<10.0.0 | pillow |
| >=5.1 | pyyaml |
| >=2.28.1,<3.0.0 | requests |
| >=13.0.1,<14.0.0 | rich |
| >=0.8,<0.9 | dataclasses |
| ==0.1.8 | upolygon |
| >=4.0.0 | jsonschema |
| >=2.1.0,<3.0.0 | deprecation |
| >=1.10.4,<2.0.0 | pydantic |
| >=3.8.5,<4.0.0 | orjson |
| - | numpy |
| >=0.10.2,<0.11.0 | toml |
| >=5.0.0,<6.0.0 | nibabel |
| >=3.10.3,<4.0.0 | connected-components-3d |
| >=1.2.0,<2.0.0 | scikit-learn |
| >=1.13.1,<2.0.0 | torch |
| >=0.14.1,<0.15.0 | torchvision |
| >=22.12.0,<23.0.0 | black |
| >=5.11.4,<6.0.0 | isort |
| >=6.0.0,<7.0.0 | flake8 |
| >=0.991,<0.992 | mypy |
| >=0.22.0,<0.23.0 | responses |
| >=7.2.1,<8.0.0 | pytest |
| >=2.0.1,<3.0.0 | pytest-describe |
| >=1.2.2,<2.0.0 | flake8-pyproject |
| >=1.6.5,<2.0.0 | debugpy |
| >=2.28.11.8,<3.0.0.0 | types-requests |
| >=2.7.0,<3.0.0 | mpire |
| >=4.64.1,<5.0.0 | tqdm |
| >=6.0.12.9,<7.0.0.0 | types-pyyaml |
زبان مورد نیاز
| مقدار | نام |
|---|---|
| >=3.7.0,<3.12 | Python |
نحوه نصب
نصب پکیج whl darwin-py-0.9.0:
pip install darwin-py-0.9.0.whl
نصب پکیج tar.gz darwin-py-0.9.0:
pip install darwin-py-0.9.0.tar.gz