Skip to content

Commit 4cb6c9d

Browse files
committed
Make it clearer that this project is using public datasets and welcomes improvements.
1 parent a5f249e commit 4cb6c9d

File tree

1 file changed

+4
-4
lines changed

1 file changed

+4
-4
lines changed

README.md

+4-4
Original file line numberDiff line numberDiff line change
@@ -4,13 +4,13 @@ EmoPy is a python toolkit with deep neural net classes which accurately predict
44
![Labeled FER Images](readme_docs/labeled_images.png "Labeled Facial Expression Images")
55
*Figure from [@Chen2014FacialER]*
66

7-
The aim of this project is to make accurate [Facial Expression Recognition (FER)](https://en.wikipedia.org/wiki/Emotion_recognition) models free, open, easy to use, and easy to integrate into different projects.
7+
The aim of this project is, using existing public datasets, to make accurate [Facial Expression Recognition (FER)](https://en.wikipedia.org/wiki/Emotion_recognition) models free, open, easy to use, and easy to integrate into different projects.
88

99
The developers of EmoPy have written two guides you may find useful:
1010
* [Recognizing human facial expressions with machine learning](https://www.thoughtworks.com/insights/blog/recognizing-human-facial-expressions-machine-learning)
1111
* [EmoPy: a machine learning toolkit for emotional expression](https://www.thoughtworks.com/insights/blog/emopy-machine-learning-toolkit-emotional-expression)
1212

13-
We aim to expand our development community, and we are open to suggestions and contributions. Please [contact us](mailto:[email protected]) to discuss.
13+
We aim to expand our development community, and we are open to suggestions and contributions. Usually these type of algorithms are used commercially, so we want to help open source the best possible version of them in order to improve public access and engagement in this area. Please [contact us](mailto:[email protected]) to discuss.
1414

1515
## Overview
1616

@@ -24,15 +24,15 @@ EmoPy includes several modules that are plugged together to build a trained FER
2424
- `directory_data_loader.py`
2525
- `data_generator.py`
2626

27-
The `fermodel.py` module uses pretrained models for FER prediction, making it the easiest entry point to get a trained model up and running quickly.
27+
The `fermodel.py` module uses pre-trained models for FER prediction, making it the easiest entry point to get a trained model up and running quickly.
2828

2929
Each of the modules contains one class, except for `neuralnets.py`, which has one interface and four subclasses. Each of these subclasses implements a different neural net architecture using the Keras framework with Tensorflow backend, allowing you to experiment and see which one performs best for your needs.
3030

3131
The [EmoPy documentation](https://emopy.readthedocs.io/) contains detailed information on the classes and their interactions. Also, an overview of the different neural nets included in this project is included below.
3232

3333
## Datasets
3434

35-
Try out the system using your own dataset or a small dataset we have provided in the [examples/image_data](examples/image_data) subdirectory. The sample datasets we provide will not yield good results due to their small size, but they serve as a great way to get started.
35+
Try out the system using your own dataset or a small dataset we have provided in the [Emopy/examples/image_data](Emopy/examples/image_data) subdirectory. The sample datasets we provide will not yield good results due to their small size, but they serve as a great way to get started.
3636

3737
Predictions ideally perform well on a diversity of datasets, illumination conditions, and subsets of the standard 7 emotion labels (happiness, anger, fear, surprise, disgust, sadness, calm/neutral) seen in FER research. Some good example public datasets are the [Extended Cohn-Kanade](http://www.consortium.ri.cmu.edu/ckagree/) and [FER+](https://github.com/Microsoft/FERPlus).
3838

0 commit comments

Comments
 (0)