|
PLearn 0.1
|
#include <PTest.h>


Public Member Functions | |
| PTest () | |
| Default constructor. | |
| virtual string | classname () const |
| virtual OptionList & | getOptionList () const |
| virtual OptionMap & | getOptionMap () const |
| virtual RemoteMethodMap & | getRemoteMethodMap () const |
| virtual PTest * | deepCopy (CopiesMap &copies) const |
| virtual void | build () |
| Post-constructor. | |
| virtual void | makeDeepCopyFromShallowCopy (CopiesMap &copies) |
| Transforms a shallow copy into a deep copy. | |
| virtual void | perform () |
| The test must be performed in this (virtual) method. | |
| virtual void | run () |
| Launch the test, by: 1. | |
Static Public Member Functions | |
| static string | _classname_ () |
| static OptionList & | _getOptionList_ () |
| static RemoteMethodMap & | _getRemoteMethodMap_ () |
| static Object * | _new_instance_for_typemap_ () |
| static bool | _isa_ (const Object *o) |
| static void | _static_initialize_ () |
| static const PPath & | declaringFile () |
Public Attributes | |
| string | name |
| bool | save |
| PPath | save_path |
Static Public Attributes | |
| static StaticInitializer | _static_initializer_ |
Static Protected Member Functions | |
| static void | declareOptions (OptionList &ol) |
| Declares the class options. | |
Private Types | |
| typedef Object | inherited |
Private Member Functions | |
| void | build_ () |
| This does the actual building. | |
typedef Object PLearn::PTest::inherited [private] |
Reimplemented from PLearn::Object.
Reimplemented in PLearn::ObjectGraphIteratorTest, PLearn::PLCheckTest, PLearn::PLStringutilsTest, PLearn::PPTest, PLearn::PLLogTest, PLearn::PPathTest, PLearn::PStreamBufTest, PLearn::TupleTest, PLearn::PentaTest, PLearn::PLMathTest, PLearn::TMatTest, PLearn::RemoveObservationTest, PLearn::HeapTest, PLearn::ConjRosenbrock, PLearn::BasicIdentityCallsTest, PLearn::InjectionTest, PLearn::InstanceSnippetTest, PLearn::InterfunctionXchgTest, PLearn::MemoryStressTest, PLearn::VariablesTest, PLearn::VarUtilsTest, PLearn::AutoVMatrixTest, PLearn::FileVMatrixTest, PLearn::IndexedVMatrixTest, PLearn::RowBufferedVMatrixTest, and PLearn::MaxSubsamplingTest.
| PLearn::PTest::PTest | ( | ) |
| string PLearn::PTest::_classname_ | ( | ) | [static] |
Reimplemented from PLearn::Object.
Reimplemented in PLearn::ObjectGraphIteratorTest, PLearn::PLCheckTest, PLearn::PLStringutilsTest, PLearn::PPTest, PLearn::PLLogTest, PLearn::PPathTest, PLearn::PStreamBufTest, PLearn::TupleTest, PLearn::PentaTest, PLearn::PLMathTest, PLearn::TMatTest, PLearn::RemoveObservationTest, PLearn::HeapTest, PLearn::ConjRosenbrock, PLearn::BasicIdentityCallsTest, PLearn::InjectionTest, PLearn::InstanceSnippetTest, PLearn::InterfunctionXchgTest, PLearn::MemoryStressTest, PLearn::VariablesTest, PLearn::VarUtilsTest, PLearn::AutoVMatrixTest, PLearn::FileVMatrixTest, PLearn::IndexedVMatrixTest, PLearn::RowBufferedVMatrixTest, and PLearn::MaxSubsamplingTest.
| OptionList & PLearn::PTest::_getOptionList_ | ( | ) | [static] |
Reimplemented from PLearn::Object.
Reimplemented in PLearn::ObjectGraphIteratorTest, PLearn::PLCheckTest, PLearn::PLStringutilsTest, PLearn::PPTest, PLearn::PLLogTest, PLearn::PPathTest, PLearn::PStreamBufTest, PLearn::TupleTest, PLearn::PentaTest, PLearn::PLMathTest, PLearn::TMatTest, PLearn::RemoveObservationTest, PLearn::HeapTest, PLearn::ConjRosenbrock, PLearn::BasicIdentityCallsTest, PLearn::InjectionTest, PLearn::InstanceSnippetTest, PLearn::InterfunctionXchgTest, PLearn::MemoryStressTest, PLearn::VariablesTest, PLearn::VarUtilsTest, PLearn::AutoVMatrixTest, PLearn::FileVMatrixTest, PLearn::IndexedVMatrixTest, PLearn::RowBufferedVMatrixTest, and PLearn::MaxSubsamplingTest.
| RemoteMethodMap & PLearn::PTest::_getRemoteMethodMap_ | ( | ) | [static] |
Reimplemented from PLearn::Object.
Reimplemented in PLearn::ObjectGraphIteratorTest, PLearn::PLCheckTest, PLearn::PLStringutilsTest, PLearn::PPTest, PLearn::PLLogTest, PLearn::PPathTest, PLearn::PStreamBufTest, PLearn::TupleTest, PLearn::PentaTest, PLearn::PLMathTest, PLearn::TMatTest, PLearn::RemoveObservationTest, PLearn::HeapTest, PLearn::ConjRosenbrock, PLearn::BasicIdentityCallsTest, PLearn::InjectionTest, PLearn::InstanceSnippetTest, PLearn::InterfunctionXchgTest, PLearn::MemoryStressTest, PLearn::VariablesTest, PLearn::VarUtilsTest, PLearn::AutoVMatrixTest, PLearn::FileVMatrixTest, PLearn::IndexedVMatrixTest, PLearn::RowBufferedVMatrixTest, and PLearn::MaxSubsamplingTest.
Reimplemented from PLearn::Object.
Reimplemented in PLearn::ObjectGraphIteratorTest, PLearn::PLCheckTest, PLearn::PLStringutilsTest, PLearn::PPTest, PLearn::PLLogTest, PLearn::PPathTest, PLearn::PStreamBufTest, PLearn::TupleTest, PLearn::PentaTest, PLearn::PLMathTest, PLearn::TMatTest, PLearn::RemoveObservationTest, PLearn::HeapTest, PLearn::ConjRosenbrock, PLearn::BasicIdentityCallsTest, PLearn::InjectionTest, PLearn::InstanceSnippetTest, PLearn::InterfunctionXchgTest, PLearn::MemoryStressTest, PLearn::VariablesTest, PLearn::VarUtilsTest, PLearn::AutoVMatrixTest, PLearn::FileVMatrixTest, PLearn::IndexedVMatrixTest, PLearn::RowBufferedVMatrixTest, and PLearn::MaxSubsamplingTest.
| Object * PLearn::PTest::_new_instance_for_typemap_ | ( | ) | [static] |
Reimplemented from PLearn::Object.
Reimplemented in PLearn::ObjectGraphIteratorTest, PLearn::PLCheckTest, PLearn::PLStringutilsTest, PLearn::PPTest, PLearn::PLLogTest, PLearn::PPathTest, PLearn::PStreamBufTest, PLearn::TupleTest, PLearn::PentaTest, PLearn::PLMathTest, PLearn::TMatTest, PLearn::RemoveObservationTest, PLearn::HeapTest, PLearn::ConjRosenbrock, PLearn::BasicIdentityCallsTest, PLearn::InjectionTest, PLearn::InstanceSnippetTest, PLearn::InterfunctionXchgTest, PLearn::MemoryStressTest, PLearn::VariablesTest, PLearn::VarUtilsTest, PLearn::AutoVMatrixTest, PLearn::FileVMatrixTest, PLearn::IndexedVMatrixTest, PLearn::RowBufferedVMatrixTest, and PLearn::MaxSubsamplingTest.
| StaticInitializer PTest::_static_initializer_ & PLearn::PTest::_static_initialize_ | ( | ) | [static] |
Reimplemented from PLearn::Object.
Reimplemented in PLearn::ObjectGraphIteratorTest, PLearn::PLCheckTest, PLearn::PLStringutilsTest, PLearn::PPTest, PLearn::PLLogTest, PLearn::PPathTest, PLearn::PStreamBufTest, PLearn::TupleTest, PLearn::PentaTest, PLearn::PLMathTest, PLearn::TMatTest, PLearn::RemoveObservationTest, PLearn::HeapTest, PLearn::ConjRosenbrock, PLearn::BasicIdentityCallsTest, PLearn::InjectionTest, PLearn::InstanceSnippetTest, PLearn::InterfunctionXchgTest, PLearn::MemoryStressTest, PLearn::VariablesTest, PLearn::VarUtilsTest, PLearn::AutoVMatrixTest, PLearn::FileVMatrixTest, PLearn::IndexedVMatrixTest, PLearn::RowBufferedVMatrixTest, and PLearn::MaxSubsamplingTest.
| void PLearn::PTest::build | ( | ) | [virtual] |
Post-constructor.
The normal implementation should call simply inherited::build(), then this class's build_(). This method should be callable again at later times, after modifying some option fields to change the "architecture" of the object.
Reimplemented from PLearn::Object.
Reimplemented in PLearn::ObjectGraphIteratorTest, PLearn::PLCheckTest, PLearn::PLStringutilsTest, PLearn::PPTest, PLearn::PLLogTest, PLearn::PPathTest, PLearn::PStreamBufTest, PLearn::TupleTest, PLearn::PentaTest, PLearn::PLMathTest, PLearn::TMatTest, PLearn::RemoveObservationTest, PLearn::HeapTest, PLearn::ConjRosenbrock, PLearn::BasicIdentityCallsTest, PLearn::InjectionTest, PLearn::InstanceSnippetTest, PLearn::InterfunctionXchgTest, PLearn::MemoryStressTest, PLearn::VariablesTest, PLearn::VarUtilsTest, PLearn::AutoVMatrixTest, PLearn::FileVMatrixTest, PLearn::IndexedVMatrixTest, PLearn::RowBufferedVMatrixTest, and PLearn::MaxSubsamplingTest.
Definition at line 68 of file PTest.cc.
References PLearn::Object::build(), and build_().
Referenced by PLearn::TMatTest::build(), PLearn::MemoryStressTest::build(), PLearn::HeapTest::build(), and PLearn::ConjRosenbrock::build().
{
inherited::build();
build_();
}


| void PLearn::PTest::build_ | ( | ) | [private] |
This does the actual building.
Reimplemented from PLearn::Object.
Reimplemented in PLearn::ObjectGraphIteratorTest, PLearn::PLCheckTest, PLearn::PLStringutilsTest, PLearn::PPTest, PLearn::PLLogTest, PLearn::PPathTest, PLearn::PStreamBufTest, PLearn::TupleTest, PLearn::PentaTest, PLearn::PLMathTest, PLearn::TMatTest, PLearn::RemoveObservationTest, PLearn::HeapTest, PLearn::ConjRosenbrock, PLearn::BasicIdentityCallsTest, PLearn::InjectionTest, PLearn::InstanceSnippetTest, PLearn::InterfunctionXchgTest, PLearn::MemoryStressTest, PLearn::VariablesTest, PLearn::VarUtilsTest, PLearn::AutoVMatrixTest, PLearn::FileVMatrixTest, PLearn::IndexedVMatrixTest, PLearn::RowBufferedVMatrixTest, and PLearn::MaxSubsamplingTest.
Definition at line 119 of file PTest.cc.
References classname(), and name.
Referenced by build().


| string PLearn::PTest::classname | ( | ) | const [virtual] |
Reimplemented from PLearn::Object.
Reimplemented in PLearn::ObjectGraphIteratorTest, PLearn::PLCheckTest, PLearn::PLStringutilsTest, PLearn::PPTest, PLearn::PLLogTest, PLearn::PPathTest, PLearn::PStreamBufTest, PLearn::TupleTest, PLearn::PentaTest, PLearn::PLMathTest, PLearn::TMatTest, PLearn::RemoveObservationTest, PLearn::HeapTest, PLearn::ConjRosenbrock, PLearn::BasicIdentityCallsTest, PLearn::InjectionTest, PLearn::InstanceSnippetTest, PLearn::InterfunctionXchgTest, PLearn::MemoryStressTest, PLearn::VariablesTest, PLearn::VarUtilsTest, PLearn::AutoVMatrixTest, PLearn::FileVMatrixTest, PLearn::IndexedVMatrixTest, PLearn::RowBufferedVMatrixTest, and PLearn::MaxSubsamplingTest.
Definition at line 56 of file PTest.cc.
Referenced by build_().

| void PLearn::PTest::declareOptions | ( | OptionList & | ol | ) | [static, protected] |
Declares the class options.
Reimplemented from PLearn::Object.
Reimplemented in PLearn::ObjectGraphIteratorTest, PLearn::PLCheckTest, PLearn::PLStringutilsTest, PLearn::PPTest, PLearn::PLLogTest, PLearn::PPathTest, PLearn::PStreamBufTest, PLearn::TupleTest, PLearn::PentaTest, PLearn::PLMathTest, PLearn::TMatTest, PLearn::RemoveObservationTest, PLearn::HeapTest, PLearn::ConjRosenbrock, PLearn::BasicIdentityCallsTest, PLearn::InjectionTest, PLearn::InstanceSnippetTest, PLearn::InterfunctionXchgTest, PLearn::MemoryStressTest, PLearn::VariablesTest, PLearn::VarUtilsTest, PLearn::AutoVMatrixTest, PLearn::FileVMatrixTest, PLearn::IndexedVMatrixTest, PLearn::RowBufferedVMatrixTest, and PLearn::MaxSubsamplingTest.
Definition at line 94 of file PTest.cc.
References PLearn::OptionBase::buildoption, PLearn::declareOption(), PLearn::Object::declareOptions(), name, PLearn::OptionBase::nosave, save, and save_path.
Referenced by PLearn::TMatTest::declareOptions(), PLearn::MemoryStressTest::declareOptions(), PLearn::HeapTest::declareOptions(), and PLearn::ConjRosenbrock::declareOptions().
{
// Option 'name' is declared as 'nosave' because most PTest subclasses will
// either use the default name (= classname()), or set their own name,
// without needing to have the user set it by himself.
// However, a subclass may redeclare this option as a 'buildoption' if
// needed.
declareOption(ol, "name", &PTest::name, OptionBase::nosave,
"The name of this test. If left empty, it will be set to classname()\n"
"at build time.");
declareOption(ol, "save", &PTest::save, OptionBase::buildoption,
"If set to 1, this object will be saved to 'save_path'.");
declareOption(ol, "save_path", &PTest::save_path, OptionBase::buildoption,
"The file where this test object should be saved (if empty, it will\n"
"be set to 'name'.psave).");
// Now call the parent class' declareOptions
inherited::declareOptions(ol);
}


| static const PPath& PLearn::PTest::declaringFile | ( | ) | [inline, static] |
Reimplemented from PLearn::Object.
Reimplemented in PLearn::ObjectGraphIteratorTest, PLearn::PLCheckTest, PLearn::PLStringutilsTest, PLearn::PPTest, PLearn::PLLogTest, PLearn::PPathTest, PLearn::PStreamBufTest, PLearn::TupleTest, PLearn::PentaTest, PLearn::PLMathTest, PLearn::TMatTest, PLearn::RemoveObservationTest, PLearn::HeapTest, PLearn::ConjRosenbrock, PLearn::BasicIdentityCallsTest, PLearn::InjectionTest, PLearn::InstanceSnippetTest, PLearn::InterfunctionXchgTest, PLearn::MemoryStressTest, PLearn::VariablesTest, PLearn::VarUtilsTest, PLearn::AutoVMatrixTest, PLearn::FileVMatrixTest, PLearn::IndexedVMatrixTest, PLearn::RowBufferedVMatrixTest, and PLearn::MaxSubsamplingTest.
Definition at line 81 of file PTest.h.
{};
Reimplemented from PLearn::Object.
Reimplemented in PLearn::ObjectGraphIteratorTest, PLearn::PLCheckTest, PLearn::PLStringutilsTest, PLearn::PPTest, PLearn::PLLogTest, PLearn::PPathTest, PLearn::PStreamBufTest, PLearn::TupleTest, PLearn::PentaTest, PLearn::PLMathTest, PLearn::TMatTest, PLearn::RemoveObservationTest, PLearn::HeapTest, PLearn::ConjRosenbrock, PLearn::BasicIdentityCallsTest, PLearn::InjectionTest, PLearn::InstanceSnippetTest, PLearn::InterfunctionXchgTest, PLearn::MemoryStressTest, PLearn::VariablesTest, PLearn::VarUtilsTest, PLearn::AutoVMatrixTest, PLearn::FileVMatrixTest, PLearn::IndexedVMatrixTest, PLearn::RowBufferedVMatrixTest, and PLearn::MaxSubsamplingTest.
| OptionList & PLearn::PTest::getOptionList | ( | ) | const [virtual] |
Reimplemented from PLearn::Object.
Reimplemented in PLearn::ObjectGraphIteratorTest, PLearn::PLCheckTest, PLearn::PLStringutilsTest, PLearn::PPTest, PLearn::PLLogTest, PLearn::PPathTest, PLearn::PStreamBufTest, PLearn::TupleTest, PLearn::PentaTest, PLearn::PLMathTest, PLearn::TMatTest, PLearn::RemoveObservationTest, PLearn::HeapTest, PLearn::ConjRosenbrock, PLearn::BasicIdentityCallsTest, PLearn::InjectionTest, PLearn::InstanceSnippetTest, PLearn::InterfunctionXchgTest, PLearn::MemoryStressTest, PLearn::VariablesTest, PLearn::VarUtilsTest, PLearn::AutoVMatrixTest, PLearn::FileVMatrixTest, PLearn::IndexedVMatrixTest, PLearn::RowBufferedVMatrixTest, and PLearn::MaxSubsamplingTest.
| OptionMap & PLearn::PTest::getOptionMap | ( | ) | const [virtual] |
Reimplemented from PLearn::Object.
Reimplemented in PLearn::ObjectGraphIteratorTest, PLearn::PLCheckTest, PLearn::PLStringutilsTest, PLearn::PPTest, PLearn::PLLogTest, PLearn::PPathTest, PLearn::PStreamBufTest, PLearn::TupleTest, PLearn::PentaTest, PLearn::PLMathTest, PLearn::TMatTest, PLearn::RemoveObservationTest, PLearn::HeapTest, PLearn::ConjRosenbrock, PLearn::BasicIdentityCallsTest, PLearn::InjectionTest, PLearn::InstanceSnippetTest, PLearn::InterfunctionXchgTest, PLearn::MemoryStressTest, PLearn::VariablesTest, PLearn::VarUtilsTest, PLearn::AutoVMatrixTest, PLearn::FileVMatrixTest, PLearn::IndexedVMatrixTest, PLearn::RowBufferedVMatrixTest, and PLearn::MaxSubsamplingTest.
| RemoteMethodMap & PLearn::PTest::getRemoteMethodMap | ( | ) | const [virtual] |
Reimplemented from PLearn::Object.
Reimplemented in PLearn::ObjectGraphIteratorTest, PLearn::PLCheckTest, PLearn::PLStringutilsTest, PLearn::PPTest, PLearn::PLLogTest, PLearn::PPathTest, PLearn::PStreamBufTest, PLearn::TupleTest, PLearn::PentaTest, PLearn::PLMathTest, PLearn::TMatTest, PLearn::RemoveObservationTest, PLearn::HeapTest, PLearn::ConjRosenbrock, PLearn::BasicIdentityCallsTest, PLearn::InjectionTest, PLearn::InstanceSnippetTest, PLearn::InterfunctionXchgTest, PLearn::MemoryStressTest, PLearn::VariablesTest, PLearn::VarUtilsTest, PLearn::AutoVMatrixTest, PLearn::FileVMatrixTest, PLearn::IndexedVMatrixTest, PLearn::RowBufferedVMatrixTest, and PLearn::MaxSubsamplingTest.
| void PLearn::PTest::makeDeepCopyFromShallowCopy | ( | CopiesMap & | copies | ) | [virtual] |
Transforms a shallow copy into a deep copy.
Reimplemented from PLearn::Object.
Reimplemented in PLearn::ObjectGraphIteratorTest, PLearn::PLCheckTest, PLearn::PLStringutilsTest, PLearn::PPTest, PLearn::PLLogTest, PLearn::PPathTest, PLearn::PStreamBufTest, PLearn::TupleTest, PLearn::PentaTest, PLearn::PLMathTest, PLearn::TMatTest, PLearn::RemoveObservationTest, PLearn::HeapTest, PLearn::ConjRosenbrock, PLearn::BasicIdentityCallsTest, PLearn::InjectionTest, PLearn::InstanceSnippetTest, PLearn::InterfunctionXchgTest, PLearn::MemoryStressTest, PLearn::VariablesTest, PLearn::VarUtilsTest, PLearn::AutoVMatrixTest, PLearn::FileVMatrixTest, PLearn::IndexedVMatrixTest, PLearn::RowBufferedVMatrixTest, and PLearn::MaxSubsamplingTest.
Definition at line 77 of file PTest.cc.
References PLearn::Object::makeDeepCopyFromShallowCopy(), and PLERROR.
Referenced by PLearn::TMatTest::makeDeepCopyFromShallowCopy(), PLearn::MemoryStressTest::makeDeepCopyFromShallowCopy(), PLearn::HeapTest::makeDeepCopyFromShallowCopy(), and PLearn::ConjRosenbrock::makeDeepCopyFromShallowCopy().
{
inherited::makeDeepCopyFromShallowCopy(copies);
// ### Call deepCopyField on all "pointer-like" fields
// ### that you wish to be deepCopied rather than
// ### shallow-copied.
// ### ex:
// deepCopyField(trainvec, copies);
// ### Remove this line when you have fully implemented this method.
PLERROR("PTest::makeDeepCopyFromShallowCopy not fully (correctly) implemented yet!");
}


| virtual void PLearn::PTest::perform | ( | ) | [inline, virtual] |
The test must be performed in this (virtual) method.
Usually, a test consists in some output (to pout and / or perr), and updates of this object's options (the default PTest::perform() method does nothing).
Reimplemented in PLearn::ObjectGraphIteratorTest, PLearn::PLCheckTest, PLearn::PLStringutilsTest, PLearn::PPTest, PLearn::PLLogTest, PLearn::PPathTest, PLearn::PStreamBufTest, PLearn::TupleTest, PLearn::PentaTest, PLearn::PLMathTest, PLearn::TMatTest, PLearn::RemoveObservationTest, PLearn::HeapTest, PLearn::ConjRosenbrock, PLearn::BasicIdentityCallsTest, PLearn::InjectionTest, PLearn::InstanceSnippetTest, PLearn::InterfunctionXchgTest, PLearn::MemoryStressTest, PLearn::VariablesTest, PLearn::VarUtilsTest, PLearn::AutoVMatrixTest, PLearn::FileVMatrixTest, PLearn::IndexedVMatrixTest, PLearn::RowBufferedVMatrixTest, and PLearn::MaxSubsamplingTest.
Definition at line 95 of file PTest.h.
Referenced by run().
{};

| void PLearn::PTest::run | ( | ) | [virtual] |
Launch the test, by: 1.
Calling the perform() method 2. Saving this object (whose options should contains the test results)
Reimplemented from PLearn::Object.
Definition at line 128 of file PTest.cc.
References PLearn::PPath::errorDisplay(), PLearn::PPath::isEmpty(), name, PLearn::pathexists(), perform(), PLERROR, save, and save_path.
{
this->perform();
if (save) {
PPath file = save_path.isEmpty() ? PPath(name + ".psave") : save_path;
if (pathexists(file))
PLERROR("In PTest::run - File '%s' already exists",
file.errorDisplay().c_str());
PP<PTest> test_to_save = this;
PLearn::save(file, test_to_save);
}
}

Reimplemented from PLearn::Object.
Reimplemented in PLearn::ObjectGraphIteratorTest, PLearn::PLCheckTest, PLearn::PLStringutilsTest, PLearn::PPTest, PLearn::PLLogTest, PLearn::PPathTest, PLearn::PStreamBufTest, PLearn::TupleTest, PLearn::PentaTest, PLearn::PLMathTest, PLearn::TMatTest, PLearn::RemoveObservationTest, PLearn::HeapTest, PLearn::ConjRosenbrock, PLearn::BasicIdentityCallsTest, PLearn::InjectionTest, PLearn::InstanceSnippetTest, PLearn::InterfunctionXchgTest, PLearn::MemoryStressTest, PLearn::VariablesTest, PLearn::VarUtilsTest, PLearn::AutoVMatrixTest, PLearn::FileVMatrixTest, PLearn::IndexedVMatrixTest, PLearn::RowBufferedVMatrixTest, and PLearn::MaxSubsamplingTest.
| string PLearn::PTest::name |
Definition at line 61 of file PTest.h.
Referenced by build_(), declareOptions(), and run().
Definition at line 62 of file PTest.h.
Referenced by declareOptions(), and run().
Definition at line 63 of file PTest.h.
Referenced by declareOptions(), and run().
1.7.4