Permalink
Browse files

update WIP

  • Loading branch information...
nitslp-ri committed Jan 23, 2019
1 parent ab5e259 commit dca1cae0622e752096aab7d335aa68e4d2f703bf
@@ -1,6 +1,6 @@
# dnntools

DNN-HMM related tiny tools for Julius
DNN-HMM related tiny tools for Julius.

## Synopsis

@@ -48,4 +48,4 @@ Send feature vector file to Julius running with `-input vecnet` at localhost:
## License

This tool is licensed under the same license with Julius. See the license term
of Julius for details.
of Julius for details.
@@ -1,6 +1,6 @@
# generate-ngram

An N-gram-to-text sentence generator
An N-gram-to-text sentence generator.

## Synopsis

@@ -11,7 +11,7 @@ An N-gram-to-text sentence generator
## Description

`generate-ngram` generates sentences randomly according to the given N-gram
language model. The N-gram file should be a binary N-gram file for Julius.
language model. The N-gram file should be a binary N-gram file for Julius.

You can convert ARPA standard format LM to Julius binary N-gram by `mkbingram`.

This file was deleted.

Oops, something went wrong.
@@ -0,0 +1,72 @@
# accept_check

Check whether a grammar can accept sentences.

## Synopsis

```shell
% accept_check [options] prefix < test_sentences.txt
```

## Description

`accept_check` reads sentences, i.e. word sequences, from standard input one per
line, and check whether they are acceptable or not on a given grammar
(`prefix.dfa` and `prefix.dict`). You can use this tool to verify whether the
to-be-accepted sentences in a grammar task can actually be accepted in the
developing grammar.

If a given word exists in multiple word categories as same label in a grammar,
in that case `accept_check` checks all the possible category sequence patterns
and determine as accepted if at least one of them is acceptable.

### Prerequisites

The grammar definition in Julius consists of several files: `.dict`, `.dfa`, and
optional `.term`. They are generated from BNF-like grammar definition by grammar compilation tool `mkdfa.pl`.
See [Julius grammar-kit GitHub](https://github.com/julius-speech/grammar-kit/) for details. There are also an [example](https://github.com/julius-speech/grammar-kit/tree/master/SampleGrammars_en).

A sentence should be given as space-separated word sequence. It may be required
to add head / tail silence word like sil, depending on your grammar. And should
not contain a short-pause word.

### Installing

This tool will be installed together with Julius.

## Usage

Verifying a sentence "`<s> three apples </s>`" against the sample grammar in [grammar-kit/SampleGrammars_en/](https://github.com/julius-speech/grammar-kit/tree/master/SampleGrammars_en)

```shell
% git clone https://github.com/julius-speech/grammar-kit/
% cd grammar-kit/SampleGrammars_en
% echo '<s> three apples </s>' | ./accept_check fruit
Stat: init_voca: read 31 words
Reading in term file (optional)...done
8 categories, 31 words
DFA has 8 nodes and 13 arcs
-----
please input word sequence>wseq: <s> three apples </s>
cate: NS_B NUM FRUIT_N NS_E
accepted
```

## Options

### `-t`

Use category name instead of word label in input.

### `-s spname`

Short-pause word name to be skipped. (default: "sp")

### `-v`

Debug output.

## License

This tool is licensed under the same license with Julius. See the license term
of Julius for details.

This file was deleted.

Oops, something went wrong.
@@ -0,0 +1,42 @@
# dfa_determinize

Determinize an automaton grammar network.

## Synopsis

```shell
% dfa_determinize [-o outFile] nfaFile
```

## Description

`dfa_determinize` converts a non-deterministic automaton grammar file into an
equivalent deterministic form.

Description about grammars in Julius is available at [Julius grammar-kit
GitHub](https://github.com/julius-speech/grammar-kit/). There is also an [tiny
example of
grammar](https://github.com/julius-speech/grammar-kit/tree/master/SampleGrammars_en).

### Installing

This tool will be installed together with Julius.

## Usage

Determinizing a non-deterministic grammar automaton into deterministic form:

```shell
% dfa_determinize -o outFile inFile
```

## Options

### `-o outFile`

Specify output file. (default: output to standard output)

## License

This tool is licensed under the same license with Julius. See the license term
of Julius for details.

This file was deleted.

Oops, something went wrong.
@@ -0,0 +1,43 @@
# dfa_minimize

Minimize a DFA grammar network.

## Synopsis

```shell
% dfa_minimize [-o outFile] dfaFile
```

## Description

`dfa_minimize` converts .dfa file into an equivalent minimal form. This tool will be automatically invoked inside grammar compilation process in `mkdfa.pl`,

Description about grammars in Julius is available at [Julius grammar-kit
GitHub](https://github.com/julius-speech/grammar-kit/). There is also an [tiny
example of
grammar](https://github.com/julius-speech/grammar-kit/tree/master/SampleGrammars_en).

### Installing

This tool will be installed together with Julius.

## Usage

Minimize a dfa file:

```shell
% dfa_minimize -o out.dfa in.dfa
8 categories, 10 nodes, 17 arcs
-> minimized: 8 nodes, 13 arcs
```

## Options

### `-o outFile`

Specify output file. (default: output to standard output)

## License

This tool is licensed under the same license with Julius. See the license term
of Julius for details.
@@ -1,6 +1,6 @@
# jcontrol

A sample module client for Julius written in C
A sample module client for Julius written in C.

## Synopsis

@@ -180,4 +180,4 @@ Request Julius to activate the temporarily stopped process.
## License

This tool is licensed under the same license with Julius. See the license term
of Julius for details.
of Julius for details.
Oops, something went wrong.

0 comments on commit dca1cae

Please sign in to comment.