#include <nnet-example-utils.h>

Collaboration diagram for ExampleGenerationConfig:

Public Member Functions
	ExampleGenerationConfig ()

void	ComputeDerived ()
	This function decodes 'num_frames_str' into 'num_frames', and ensures that the members of 'num_frames' are multiples of 'frame_subsampling_factor'. More...

void	Register (OptionsItf *po)

Public Attributes
int32	left_context

int32	right_context

int32	left_context_initial

int32	right_context_final

int32	num_frames_overlap

int32	frame_subsampling_factor

std::string	num_frames_str

std::vector< int32 >	num_frames

Detailed Description

Definition at line 82 of file nnet-example-utils.h.

Constructor & Destructor Documentation

◆ ExampleGenerationConfig()

ExampleGenerationConfig ( )

inline

Definition at line 100 of file nnet-example-utils.h.

References ExampleGenerationConfig::ComputeDerived().

                            :
       left_context(0), right_context(0),
       left_context_initial(-1), right_context_final(-1),
       num_frames_overlap(0), frame_subsampling_factor(1),
       num_frames_str("1") { }

Member Function Documentation

◆ ComputeDerived()

void ComputeDerived ( )

This function decodes 'num_frames_str' into 'num_frames', and ensures that the members of 'num_frames' are multiples of 'frame_subsampling_factor'.

Definition at line 302 of file nnet-example-utils.cc.

References ExampleGenerationConfig::frame_subsampling_factor, rnnlm::i, KALDI_ERR, KALDI_LOG, ExampleGenerationConfig::num_frames, ExampleGenerationConfig::num_frames_str, and kaldi::SplitStringToIntegers().

Referenced by ExampleGenerationConfig::ExampleGenerationConfig(), main(), and ExampleMergingConfig::Register().

                                              {
   if (num_frames_str == "-1") {
     return;
   }
   if (!SplitStringToIntegers(num_frames_str, ",", false, &num_frames) ||
       num_frames.empty()) {
     KALDI_ERR << "Invalid option (expected comma-separated list of integers): "
               << "--num-frames=" << num_frames_str;
   }
 
   int32 m = frame_subsampling_factor;
   if (m < 1) {
     KALDI_ERR << "Invalid value --frame-subsampling-factor=" << m;
   }
   bool changed = false;
   for (size_t i = 0; i < num_frames.size(); i++) {
     int32 value = num_frames[i];
     if (value <= 0) {
       KALDI_ERR << "Invalid option --num-frames=" << num_frames_str;
     }
     if (value % m != 0) {
       value = m * ((value / m) + 1);
       changed = true;
     }
     num_frames[i] = value;
   }
   if (changed) {
     std::ostringstream rounded_num_frames_str;
     for (size_t i = 0; i < num_frames.size(); i++) {
       if (i > 0)
         rounded_num_frames_str << ',';
       rounded_num_frames_str << num_frames[i];
     }
     KALDI_LOG << "Rounding up --num-frames=" << num_frames_str
               << " to multiples of --frame-subsampling-factor=" << m
               << ", to: " << rounded_num_frames_str.str();
   }
 }

◆ Register()

void Register ( OptionsItf * po )

inline

Definition at line 110 of file nnet-example-utils.h.

References OptionsItf::Register().

Referenced by main().

                                 {
     po->Register("left-context", &left_context, "Number of frames of left "
                  "context of input features that are added to each "
                  "example");
     po->Register("right-context", &right_context, "Number of frames of right "
                  "context of input features that are added to each "
                  "example");
     po->Register("left-context-initial", &left_context_initial, "Number of "
                  "frames of left context of input features that are added to "
                  "each example at the start of the utterance (if <0, this "
                  "defaults to the same as --left-context)");
     po->Register("right-context-final", &right_context_final, "Number of "
                  "frames of right context of input features that are added "
                  "to each example at the end of the utterance (if <0, this "
                  "defaults to the same as --right-context)");
     po->Register("num-frames", &num_frames_str, "Number of frames with labels "
                 "that each example contains (i.e. the left and right context "
                 "are to be added to this).  May just be an integer (e.g. "
                 "--num-frames=8), or a principal value followed by "
                 "alternative values to be used at most once for each utterance "
                 "to deal with odd-sized input, e.g. --num-frames=40,25,50 means "
                 "that most of the time the number of frames will be 40, but to "
                 "deal with odd-sized inputs we may also generate egs with these "
                 "other sizes.  All these values will be rounded up to the "
                 "closest multiple of --frame-subsampling-factor.  As a special case, "
                 "--num-frames=-1 means 'don't do any splitting'.");
     po->Register("num-frames-overlap", &num_frames_overlap, "Number of frames of "
                  "overlap between adjacent eamples (applies to chunks of size "
                  "equal to the primary [first-listed] --num-frames value... "
                  "will be adjusted for different-sized chunks).  Advisory; "
                  "will not be exactly enforced.");
     po->Register("frame-subsampling-factor", &frame_subsampling_factor, "Used "
                  "if the frame-rate of the output labels in the generated "
                  "examples will be less than the frame-rate at the input");
   }