Development status

[felixbur]

Currently nkululeko still has alpha, but i wonder if it shouldn't be stable?

according to this website these are the criteria:

4 - Beta ¶

Required properties: Software is feature complete
Typical steps: External testing, fixing bugs and performance problems. Usability testing.
Semantic version: 0.X.X
[PyPI](https://pypi.org/search/?q=&o=&c=Development+Status+%3A%3A+4+-+Beta): 10,000+ projects, including [pint](https://pypi.org/project/Pint/)

5 - Production/Stable ¶

Required properties: No major bugs known, tests cover the most important cases.
Typical steps: Fixing bugs, adding updates and new features.
Semantic version:

[felixbur]

because really most of what i do these days is implement new features

[bagustris]

Let's move to beta first and then to stable. Just list the current features, classifiers, visualization, data check and segmentation. If all features are working, we make it v1.0 (stable). Let's list it all in this issue.

Features

• [x] os (opensmile)
• [x] xbow
• [ ] mld (mid level descriptors)
• [ ] spectra
• [x] trill
• [x] wav2vec
• [x] Hubert

Classifier/models

• [x] MLP
• [x] MLP Regressor
• [x] SVM
• [x] SVR
• [x] XGB
• [x] XGR
• [x] CNN
• [x] Finetuning

Visualization/plots

• [x] TSNE
• [x] epoch
• [x] anim progression
• [x] epoch progression
• [x] best model
• [x] Age (value_count)
• [x] Gender (value_count)
• [x] Duration (value_count)

Data check and segmentation

• [x] filter
• [x] check_vad
• [x] check_size

Supported datasets

• [x] androids
• [x] cmu-mosei
• [x] crema-d
• [x] emodb
• [x] emofilm
• [x] emozionalmente
• [x] iemocap
• [x] jtes
• [x] msp-improv
• [x] msp-podcast
• [x] ravdess
• [x] others (clac, gerparas, etc.)

Data:

• [x] balancing
• [X] balancing_strategy (e.g., smote)

More augmentation:

• [ ] augment_types
• [ ] augment_targets

Testing:

• [ ] Unit test

Documentations:

• [ ] tutorials

Those are a lot of features, Felix! I think Nkululeko is now more than an alpha version! Once all is checked, we can mark the beta version (up to version 0.99) before the stable version (v.1.0)

[bagustris]

@felixbur How about submitting Nkululeko to the Journal of Open-source Software (joss) before (or to obtain) the stable 1.0.0 version? Example of similar software is given in below link.

They, the reviewers, will check/review the quality of this repo (via issues, PR, etc). Once they accept Nkululeko (the paper), we should hit version 1.0.0.

https://github.com/openjournals/joss-reviews/issues/4739

[felixbur]

sure, sounds good. We should add a contributing section like this https://github.com/SuperKogito/spafe/blob/master/CONTRIBUTING.md as well

... and done

[felixbur]

Now also pushed initial versions of paper.md and paper.bib, so we can further work on it

[bagustris]

I moved paper.md and paper.bib to paper directory along with other stuff (assets, makefile, etc)