Code Monkey home page Code Monkey logo

aind-recognizer's Introduction

Artificial Intelligence Engineer Nanodegree

Probabilistic Models

Project: Sign Language Recognition System

Install

This project requires Python 3 and the following Python libraries installed:

Notes:

  1. It is highly recommended that you install the Anaconda distribution of Python and load the environment included in the "Your conda env for AI ND" lesson.
  2. The most recent development version of hmmlearn, 0.2.1, contains a bugfix related to the log function, which is used in this project. In order to install this version of hmmlearn, install it directly from its repo with the following command from within your activated Anaconda environment:
pip install git+https://github.com/hmmlearn/hmmlearn.git

Code

A template notebook is provided as asl_recognizer.ipynb. The notebook is a combination tutorial and submission document. Some of the codebase and some of your implementation will be external to the notebook. For submission, complete the Submission sections of each part. This will include running your implementations in code notebook cells, answering analysis questions, and passing provided unit tests provided in the codebase and called out in the notebook.

Run

In a terminal or command window, navigate to the top-level project directory AIND_recognizer/ (that contains this README) and run one of the following command:

jupyter notebook asl_recognizer.ipynb

This will open the Jupyter Notebook software and notebook in your browser which is where you will directly edit and run your code. Follow the instructions in the notebook for completing the project.

Additional Information

Provided Raw Data

The data in the asl_recognizer/data/ directory was derived from the RWTH-BOSTON-104 Database. The handpositions (hand_condensed.csv) are pulled directly from the database boston104.handpositions.rybach-forster-dreuw-2009-09-25.full.xml. The three markers are:

  • 0 speaker's left hand
  • 1 speaker's right hand
  • 2 speaker's nose
  • X and Y values of the video frame increase left to right and top to bottom.

Take a look at the sample ASL recognizer video to see how the hand locations are tracked.

The videos are sentences with translations provided in the database.
For purposes of this project, the sentences have been pre-segmented into words based on slow motion examination of the files.
These segments are provided in the train_words.csv and test_words.csv files in the form of start and end frames (inclusive).

The videos in the corpus include recordings from three different ASL speakers. The mappings for the three speakers to video are included in the speaker.csv file.

aind-recognizer's People

Contributors

4ydx avatar akkomar avatar angelmtenor avatar cgearhart avatar clapollo avatar danainschool avatar hosseinsey avatar kkweon avatar marco-zorzi avatar mikeudacity avatar psikarwal avatar ronny-udacity avatar sudkul avatar

Stargazers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

Watchers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

aind-recognizer's Issues

[Enhancement] Readme

Consider giving a brief explanation of jupyter in the README. Something like "This will open Jupyter..., which is where you should directly edit and run your code." I am command line obsessed and didn't realize what Jupyter was initially which is to say I was making and running my own scripts outside of Jupyter.

autoreload location should be before `SelectorCV` implementation

In the beginner of Part 3 there is a jupyter instruction to autoreload modules.

It should go above (at least) the implementation of SelectorCV in Part 2.

# autoreload for automatically reloading changes made in my_model_selectors and my_recognizer
%load_ext autoreload
%autoreload 2

Diff test

The delta features test assumes that the differences are calculated globally within the dataframe, but that causes difference for each video to be initialized relative to the last value in the preceding video. The differences should instead be grouped by video, so that they are re-initialized in the first frame of each sequence.

ModelSelector vs SelectorModel

The ModelSelector class is being referred to as the SelectorModel class in the asl_recognizer notebook. Below is how it is currently written in the notebook for reference.

"Review the SelectorModel class from the codebase found in the my_model_selectors.py module. It is designed to be a strategy pattern for choosing different model selectors. For the project submission in this section, subclass SelectorModel to implement the following model selectors."

Unable to do `udacity submit` due to absence of the `.udacity-pa` folder in the repo

Hi udacity-team

I was trying to submit my solution for review regarding this final project of Term-1 but I wasn't able to do so. It would fail with the following error message

aind-recognizer git/master  9s
(aind) ❯ udacity submit
Traceback (most recent call last):
  File "/Users/eklavya/anaconda/envs/aind/bin/udacity", line 7, in <module>
    from udacity_pa.projectassistant import main_func
  File "/Users/eklavya/anaconda/envs/aind/lib/python3.6/site-packages/udacity_pa/projectassistant.py", line 29, in <module>
    raise  NotProjectAssistantError()
udacity_pa.projectassistant.NotProjectAssistantError: Not an Udacity Project Assistant directory. No .udacity-pa folder found.

After a little digging, I found that the presence of .udacity-pa is necessary for a proper authentication and clearly this was what's lacking from this repo since all other Term-1 repos do have their own respective .udacity-pa/projects.py file.

https://github.com/udacity/AIND-Sudoku/blob/master/.udacity-pa/projects.py

https://github.com/udacity/AIND-Isolation/blob/master/.udacity-pa/projects.py

https://github.com/udacity/AIND-Planning/blob/master/.udacity-pa/projects.py

But it's not in this repo. Could you please fix this soon ?

First unit test for recognizer() can fail when it really shouldn't

The function recognize() in my_recognizer.py as part of Part 3 of this project is suppose to do two things:

  1. Calculate the probabilities (log likelihoods) of all the test samples given the training models
  2. Make a guess based on those log likelihoods

However, one of the unittests can fail if all the training models fail to yield a score for a given test sample which means the resulting list of dicts returned for "probabilities" will not have the same length as the number of test samples and thus the student will see something like:

"Number of training word probabilities in test item dictionary incorrect.")
AssertionError: 107 != 112 : Number of training word probabilities in test item dictionary incorrect.

The above is from the following line in the unit test case TestRecognize of asl_test.py:

def test_recognize_probabilities_interface(self):
probs, _ = recognize(self.models, self.test_set)
self.assertEqual(len(probs), self.test_set.num_items, "Number of test items in probabilities list incorrect.")

I think given there is a possibility that all of the SelectorConstant models can fail to yield a score for a test sample (I found this issue somewhat illuminating since this is what I see occasionally: hmmlearn/hmmlearn#101), the unit test should be more lenient regarding comparing numbers or else the project has to guarantee that a score() can always be generated for all the test word items.

NOTE: To pass this unit test I had to set float('-inf') for certain words which again, is not obvious.

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.