alfred-py: Born For Deeplearning

PyPI Version PyPI downloads CI testing License Slack PRs Welcome

alfred-py can be called from terminal via alfred as a tool for deep-learning usage. It also provides massive utilities to boost your daily efficiency APIs, for instance, if you want draw a box with score and label, if you want logging in your python applications, if you want convert your model to TRT engine, just import alfred, you can get whatever you want. More usage you can read instructions below.

Functions Summary

Since many new users of alfred maybe not very familiar with it, conclude functions here briefly, more details see my updates:

  • Visualization, draw boxes, masks, keypoints is very simple, even 3D boxes on point cloud supported;
  • Command line tools, such as view your annotation data in any format (yolo, voc, coco any one);
  • Deploy, you can using alfred deploy your tensorrt models;
  • DL common utils, such as torch.device() etc;
  • Renders, render your 3D models.

A pic visualized from alfred:

alfred vis segmentation annotation in coco format

Install

To install alfred, it is very simple:

requirements:

lxml [optional]
pycocotools [optional]
opencv-python [optional]

then:

pip install alfred-py

alfred is both a lib and a tool, you can import it's APIs, or you can directly call it inside your terminal.

A glance of alfred, after you installed above package, you will have alfred:

  • data module:

    # show VOC annotations
alfred data vocview -i JPEGImages/ -l Annotations/
# show coco annotations
alfred data cocoview -j annotations/instance_2017.json -i images/
# show yolo annotations
alfred data yoloview -i images -l labels
# show detection label with txt format
alfred data txtview -i images/ -l txts/
# convert coco to voc
alfred data coco2voc -c /path/to/coco -j annotations.json
# show more of data
alfred data -h

# eval tools
alfred data evalvoc -h

  • cab module:

    # count files number of a type
alfred cab count -d ./images -t jpg
# split a txt file into train and test
alfred cab split -f all.txt -r 0.9,0.1 -n train,val

  • vision module:

    # extract video to images
alfred vision extract -v video.mp4
# combine images to video
alfred vision 2video -d images/

  • -h to see more:

    usage: alfred [-h] [--version] {vision,text,scrap,cab,data} ...

positional arguments:
  {vision,text,scrap,cab,data}
    vision              vision related commands.
    text                text related commands.
    scrap               scrap related commands.
    cab                 cabinet related commands.
    data                data related commands.

optional arguments:
  -h, --help            show this help message and exit
  --version, -v         show version info.

    inside every child module, you can call it's -h as well: alfred text -h.

if you are on windows, you can install pycocotools via: pip install "git+https://github.com/philferriere/cocoapi.git#egg=pycocotools&subdirectory=PythonAPI", we have made pycocotools as an dependencies since we need pycoco API.

Updates

alfred-py has been updating for 3 years, and it will keep going!

  • 2024.08.02: Version 3.1.1 - Added COCO to VOC conversion, fixed syntax errors, added pyproject.toml for modern packaging, added __version__ to package.

  • 2023.04.28: Update the 3d keypoints visualizer, now you can visualize Human3DM kpts in realtime: For detailes reference to examples/demo_o3d_server.py. The result is generated from MotionBert.

  • 2022.01.18: Now alfred support a Mesh3D visualizer server based on Open3D:

    from alfred.vis.mesh3d.o3dsocket import VisOpen3DSocket

def main():
    server = VisOpen3DSocket()
    while True:
        server.update()


if __name__ == "__main__":
    main()

    Then, you just need setup a client, send keypoints3d to server, and it will automatically visualized out. Here is what it looks like:

  • 2021.12.22: Now alfred supported keypoints visualization, almost all datasets supported in mmpose were also supported by alfred:

    from alfred.vis.image.pose import vis_pose_result

# preds are poses, which is (Bs, 17, 3) for coco body
vis_pose_result(ori_image, preds, radius=5, thickness=2, show=True)

Project links

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Latest release

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for jinfagang from gravatar.com jinfagang

Credits

Author: Lucas Jin

License

Apache Software License (Apache-2.0)

Requires

Python >=3.6

Provides Extra

dev coco vision

Tags

deep learning script helper tools

Classifiers

Report project as malware

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

alfred_py-3.1.1.tar.gz (1.8 MB view details)

Uploaded Source

File details

Details for the file alfred_py-3.1.1.tar.gz.

File metadata

  • Download URL: alfred_py-3.1.1.tar.gz
  • Upload date:
  • Size: 1.8 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.12.0

File hashes

Hashes for alfred_py-3.1.1.tar.gz
Algorithm Hash digest
SHA256 1bb1410e131f5b413c5cfd77d5641ede602a269ac1e1c04f9f6481bfefca231a
MD5 3938126731c3385b70dd55ff6f462979
BLAKE2b-256 125cf6b2e13c4ec56dc877c9acd60994d93b290ca979815a8b7a3a6b36f939c9

See more details on using hashes here.

Release history Release notifications | RSS feed

This release

3.1.1

3.1.0

3.0.15

3.0.14

3.0.13

3.0.12

3.0.11

3.0.10

3.0.9

3.0.8

3.0.7

3.0.6

3.0.5

3.0.4

3.0.3

3.0.1

2.2022.10.17.1

2.12.6

2.12.5

2.12.4

2.12.3

2.12.2

2.12.1

2.11.1

2.11

2.10.9

2.10.8

2.10.7

2.10.6

2.10.5

2.10.4

2.10.3

2.10.2

2.10.1

2.10.0

2.9.6

2.9.5

2.9.4

2.9.3

2.9.2

2.8.15

2.8.14

2.8.13

2.8.12

2.8.11

2.8.10

2.8.9

2.8.8

2.8.7

2.8.6

2.8.5

2.8.4

2.8.3

2.8.2

2.8.1

2.8.0

2.7.9

2.7.5

2.7.4

2.7.3

2.7.1

2.7.0

2.6.16

2.6.15

2.6.14

2.6.13

2.6.12

2.6.11

2.6.10

2.6.9

2.6.8

2.6.7

2.6.6

2.6.5

2.6.4

2.6.3

2.6.2

2.6.1

2.6.0

2.5.21

2.5.20

2.5.19

2.5.18

2.5.17

2.5.16

2.5.15

2.5.14

2.5.13

2.5.10

2.5.9

2.5.8

2.5.7

2.5.6

2.5.5

2.5.4

2.5.3

2.5.2

2.5.1

2.5

2.4.10

2.4.9

2.4.8

2.4.7

2.4.6

2.4.5

2.4.4

2.4.3

2.4.2

2.4.1

2.4.0

2.3.9

2.3.8

2.3.6

2.3.5

2.3.4

2.3.3

2.3.2

2.3.1

2.3

2.2.1

2.1

2.0

1.0.6

1.0.5

1.0.4

1.0.3

1.0.2

0.1.2

0.1.1

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page