Merge branch 'master' of https://github.com/DerMoehre/FAVE

chrisbrickhouse · Oct 9, 2022 · 0ac55f5 · 0ac55f5
2 parents 58b1add + 66611d2
commit 0ac55f5
Show file tree

Hide file tree

Showing 72 changed files with 1,838 additions and 13,251 deletions.
diff --git a/docs/_build/doctrees/code/align/aligner.doctree b/docs/_build/doctrees/code/align/aligner.doctree
diff --git a/docs/_build/doctrees/code/align/index.doctree b/docs/_build/doctrees/code/align/index.doctree
diff --git a/docs/_build/doctrees/code/align/transcriptprocessor.doctree b/docs/_build/doctrees/code/align/transcriptprocessor.doctree
diff --git a/docs/_build/doctrees/code/aligner.doctree b/docs/_build/doctrees/code/aligner.doctree
diff --git a/docs/_build/doctrees/code/cmudictionary.doctree b/docs/_build/doctrees/code/cmudictionary.doctree
diff --git a/docs/_build/doctrees/code/extract/esps.doctree b/docs/_build/doctrees/code/extract/esps.doctree
diff --git a/docs/_build/doctrees/code/extract/index.doctree b/docs/_build/doctrees/code/extract/index.doctree
diff --git a/docs/_build/doctrees/code/extract/mahalanobis.doctree b/docs/_build/doctrees/code/extract/mahalanobis.doctree
diff --git a/docs/_build/doctrees/code/extract/plotnik.doctree b/docs/_build/doctrees/code/extract/plotnik.doctree
diff --git a/docs/_build/doctrees/code/extract/remeasure.doctree b/docs/_build/doctrees/code/extract/remeasure.doctree
diff --git a/docs/_build/doctrees/code/extract/vowel.doctree b/docs/_build/doctrees/code/extract/vowel.doctree
diff --git a/docs/_build/doctrees/code/praat.doctree b/docs/_build/doctrees/code/praat.doctree
diff --git a/docs/_build/doctrees/code/transcriptprocessor.doctree b/docs/_build/doctrees/code/transcriptprocessor.doctree
diff --git a/docs/_build/doctrees/environment.pickle b/docs/_build/doctrees/environment.pickle
diff --git a/docs/_build/doctrees/index.doctree b/docs/_build/doctrees/index.doctree
diff --git a/docs/_build/doctrees/usage/installation.doctree b/docs/_build/doctrees/usage/installation.doctree
diff --git a/docs/_build/doctrees/usage/quickstart.doctree b/docs/_build/doctrees/usage/quickstart.doctree
diff --git a/docs/_build/html/.buildinfo b/docs/_build/html/.buildinfo
@@ -1,4 +1,4 @@
 # Sphinx build info version 1
 # This file hashes the configuration used when building these files. When it is not found, a full rebuild will be done.
-config: 95450042ea89bddbb1481c62b8e92e75
+config: a9e501948c645bf032c7e86e32c92cb5
 tags: 645f666f9bcd5a90fca523b33c5a78b7
diff --git a/docs/_build/html/_sources/code/aligner.rst.txt b/docs/_build/html/_sources/code/aligner.rst.txt
diff --git a/docs/_build/html/_sources/code/transcriptprocessor.rst.txt b/docs/_build/html/_sources/code/transcriptprocessor.rst.txt
diff --git a/docs/_build/html/_sources/index.rst.txt b/docs/_build/html/_sources/index.rst.txt
@@ -6,21 +6,21 @@
 Forced Alignment and Vowel Extraction (FAVE)
 ============================================
 
-Welcome to the FAVE documentation
+This website documents the FAVE software, version 2. 
 
+.. warning::
+   If you have used FAVE before, please read :doc:`usage/whats-new` to familiarize yourself with the differences between the current and legacy versions of FAVE. 
+
+Guides and documentation
+------------------------
 .. toctree::
    :maxdepth: 2
 
-   Installing FAVE <usage/installation>
-   Quickstart guide <usage/quickstart>
-   fave.align module <code/align/index>
-   fave.extract module <code/extract/index>
-   code/cmudictionary
-   code/praat
-
+   usage/index
+   code/index
 
-Indices and tables
-==================
+Indices
+-------
 
 * :ref:`genindex`
 * :ref:`modindex`

diff --git a/docs/_build/html/_sources/usage/installation.rst.txt b/docs/_build/html/_sources/usage/installation.rst.txt
@@ -1,4 +1,27 @@
-Installing FAVE 2.0
-===================
+Installing FAVE 2
+=================
 
-To be created
+Required software
+-----------------
+
+FAVE sometimes requires other software libraries in order to work. 
+ * FAVE-align requires `SoX <http://sox.sourceforge.net/>`_ and `HTK <https://htk.eng.cam.ac.uk/>`_.
+ * FAVE-extract requires `Praat <https://www.fon.hum.uva.nl/praat/>`_.
+
+You will need to manually install these if they are not already installed on your computer.
+
+.. warning::
+   Mac users: HTK might need slight modification before it works. See `this bug report <https://github.com/JoFrhwld/FAVE/issues/48>`_.
+
+Install with PIP
+----------------
+
+FAVE is available on the Python Package Index (PyPI) as ``fave``. You can install it using:
+
+.. code-block:: console
+
+   python3 -m pip install fave
+
+Other package managers
+^^^^^^^^^^^^^^^^^^^^^^
+Work is ongoing to publish FAVE as a debian package, but no other package system is supported at the moment. If you would like to package FAVE for your system, please feel free to :doc:`contribute <../contributing>`!
diff --git a/docs/_build/html/_sources/usage/quickstart.rst.txt b/docs/_build/html/_sources/usage/quickstart.rst.txt
@@ -1,4 +1,24 @@
 Quickstart guide to using FAVE 2.0
 ==================================
 
-To be created
+ #. Install FAVE and its dependencies according to :doc:`the directions <installation>`.
+ #. Download the ``FAAValign.py`` and ``extractFormants.py`` scripts.
+ #. Check your transcription for out-of-dictionary words
+
+    .. code-block:: console
+       :caption: Check for out-of-dictionary words
+
+       python3 FAAValign.py --check unknown_words.txt AudioFile.wav TranscriptionFile.txt OutputAlignment.TextGrid
+ #. Open ``unknown_words.txt`` and create a transcription for each word listed.
+ #. Align your audio and transcripts including your new transcriptions:
+
+    .. code-block:: console
+       :caption: Begin forced alignment
+
+       python3 FAAValign.py --import custom_dictionary.txt AudioFile.wav TranscriptionFile.txt OutputAlignment.TextGrid
+ #. Extract formant data using the default settings:
+
+    .. code-block:: console
+       :caption: Extract formant data
+
+       python3 extractFormants.py AudioFile.wav Alignment.TextGrid OutputFileName.tsv