Skip to main content

Pytorch Feature Map Extractor

Project description

MapExtrackt

Downloads Release

Convolutional Neural Networks Are Beautiful

We all take our eyes for granted, we glance at an object for an instant and our brains can identify with ease. However distorted the information may be, we do a pretty good job at it.

Low light, obscured vision, poor eyesight... There are a myriad of situations where conditions are poor but still we manage to understand what an object is. Context helps, but we humans were created with sight in mind.

Computers have a harder time, but modern advances with convolutional neural networks are making this task a reality.

Computers are amazing, the neural networks and maps they create are beautiful.

Why not have an explore?


MapExtrakt makes viewing feature maps a breeze.

Catch a glimpse of how a computer can see.

MapExtrakt Usage


First import your model

import torchvision
model = torchvision.models.vgg19(pretrained=True)

Import MapExtract's Feature Extractor and load in the model

from MapExtrackt import FeatureExtractor
fe = FeatureExtractor(model)

Set image to be analysed - input can be PIL Image, Numpy array or filepath. We are using the path

fe.set_image("pug.jpg")

View Layers

fe.display_from_map(layer_no=1)

Example Output

View Single Cells At a Time

fe.display_from_map(layer_no=2, cell_no=4)

Example Output

Slice the class to get a range of cells (Layer 2 Cells 0-9)

fe[2,0:10]

Example Output

Or Export Layers To Video

fe.write_video(out_size=(1200,800), file_name="output.avi", time_for_layer=60, transition_perc_layer=0.2)
MapExtrackt

More Examples

For LOTS more - view the jupyter notebook.

Examples


Installation

It's as easy as PyPI

pip install mapextrackt

or build from source in terminal

git clone https://github.com/lewis-morris/mapextrackt &&\
cd mapextrackt &&\
pip install -e .

Todo List

  • Add the ability to slice the class i.e FeatureExtractor[1,3]
  • Show parameters on the image
  • Fix video generation
  • Enable individual cells to be added to video
  • Add video parameters such as duration in seconds.
  • Clean up code
  • Make speed improvements

Author

Created by me, initially to view the outputs for my own pleasure.

If anyone has any suggestions or requests please send them over I'd be more than happy to consider.

lewis.morris@gmail.com

Project details


Download files

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

Source Distribution

mapextrackt-0.4.8.6.tar.gz (11.9 kB view details)

Uploaded Source

Built Distributions

mapextrackt-0.4.8.6-py3.7.egg (25.3 kB view details)

Uploaded Source

mapextrackt-0.4.8.6-py3-none-any.whl (13.4 kB view details)

Uploaded Python 3

File details

Details for the file mapextrackt-0.4.8.6.tar.gz.

File metadata

  • Download URL: mapextrackt-0.4.8.6.tar.gz
  • Upload date:
  • Size: 11.9 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.1.1 pkginfo/1.4.2 requests/2.22.0 setuptools/45.2.0 requests-toolbelt/0.8.0 tqdm/4.30.0 CPython/3.8.5

File hashes

Hashes for mapextrackt-0.4.8.6.tar.gz
Algorithm Hash digest
SHA256 a2ec8a82b85a6c7d8dc56e1277efbca0a8eb2b825edf69823e1e0b5bac553b2c
MD5 6c25292d928a21b78afad72fe9e22f0e
BLAKE2b-256 49e760d2137b020a23f275b48ee441974887c4915d3150b436fe8284e2457c74

See more details on using hashes here.

File details

Details for the file mapextrackt-0.4.8.6-py3.7.egg.

File metadata

  • Download URL: mapextrackt-0.4.8.6-py3.7.egg
  • Upload date:
  • Size: 25.3 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.1.1 pkginfo/1.4.2 requests/2.22.0 setuptools/45.2.0 requests-toolbelt/0.8.0 tqdm/4.30.0 CPython/3.8.5

File hashes

Hashes for mapextrackt-0.4.8.6-py3.7.egg
Algorithm Hash digest
SHA256 ac93605beaf05aaa3dc83367b5a88ea6768cb289e9aeadac2e454c0c9d246a7a
MD5 d7ce5da1d9a95b47c11cc93448fdacf4
BLAKE2b-256 226294904a071d639354810a89f35432ced5cb73d52067555153e83cd94fa5c7

See more details on using hashes here.

File details

Details for the file mapextrackt-0.4.8.6-py3-none-any.whl.

File metadata

  • Download URL: mapextrackt-0.4.8.6-py3-none-any.whl
  • Upload date:
  • Size: 13.4 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.1.1 pkginfo/1.4.2 requests/2.22.0 setuptools/45.2.0 requests-toolbelt/0.8.0 tqdm/4.30.0 CPython/3.8.5

File hashes

Hashes for mapextrackt-0.4.8.6-py3-none-any.whl
Algorithm Hash digest
SHA256 9294c5d6981895ceb0c3c214c754c5424c92e0ec6b07121f979570df7cf63eaa
MD5 f300df5aa8aff4b02319698de7fc0a63
BLAKE2b-256 9e0e5246b16a87a568d09b483c0818881500abff7a0080018c08d6a96ce2a15d

See more details on using hashes here.

Supported by

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