File:Set02 de table.png

2016-06-29T16:35:42Z

Francesco: Francesco uploaded a new version of File:Set02 de table.png

NEEMP:Reports

2016-06-29T13:32:26Z

Francesco: /* Example 7 - Coverage validation */

__NOTOC__

This section shows several use case examples. All of them use only data from ''examples'' directory.

'''NB:''' '''NEEMP is case-sensitive'''. Please follow carefully this section for insight on the correct syntax. Additional information can be found [[NEEMP:Options | here]].

=Example 1 - Training set information=

;./neemp -m info --atom-types-by ElemBond --sdf-file examples/set01.sdf

:Prints information about training set ''set01.sdf'', provided as argument of the <code>--sdf-file</code> option, grouping atoms according to chemical element and bond order. To override this behaviour and group atoms only by element, call '''NEEMP''' with <code>--atom-types-by Element</code> option.
 

[[File:info_mode.png | thumb | 400px | center | '''''Figure 10:''''' Information about structures set ''examples/set01.sdf''.]]

=Example 2 - Calculation mode=

;./neemp -m charges --sdf-file examples/set01.sdf --par-file examples/ElemBond.par --chg-out-file eem_charges --max-threads 8

:Compute EEM charges and store them into the file ''eem_charges''. Use up to 8 threads for computation.

For more information on this mode and its output, refer to [[NEEMP:Modes#Calculation mode | Calculation mode]] section.

For details on ''eem_charges'' output file, see [[NEEMP:files#CHG file | CHG file]] paragraph, as the format is the same. The only different regards the third column, since in this case the '''EEM charges''' are listed in place of the '''ab-initio charges'''.

=Example 3 - Parametrization mode=

;./neemp -m params -p lr-full --sdf-file examples/set01.sdf --chg-file examples/set01.chg --par-out-file new_parameters.par --chg-stats-out-file stats

:Perform EEM parametrization using '''LR''' approach, save parameters into the file ''new_parameters.par'', output charge statistics for each molecule into the file ''stats''. No discarding is used.

'''NB:''' the parameters set file ''new_parameters.par'' presents the same identical format and layout as described [[NEEMP:files#PAR file | here]].

For additional information click [[NEEMP:Modes#Linear Regression (LR) | here]].

=Example 4 - Parametrization mode k search=

;./neemp -m params -p lr-full --sdf-file examples/set01.sdf --chg-file examples/set01.chg --kappa-max 1.0 --fs-precision 0.02 --sort-by RMSD -vv

:Similar to previous example, use custom range for k. Select best parameters according to ''RMSD''. Print k search progress.

Reference to [[NEEMP:Modes#Linear Regression (LR) | parametrization paragraph]] and [[NEEMP:Options | options list]] if necessary.

{| class="wikitable" border="1" style="margin-left: auto; margin-right: auto;" width="650px"
|-
| [[File:ksearch1.png| 550px]]
| [[File:ksearch2.png| 700px]]
|-
| '''''Figure 11:''''' Detailed view of the parametrization settings from the execution of the above command. In particular note the usage of a different evaluating statistics (''RMSD'') and the custom range for the k search.
| '''''Figure 12:''''' Abridged output for the k search progress. For each k value a set of parameters is generated and evaluated. In this particular instance, the parameters set with the lowest ''RMSD'' value is chosen.
|}

=Example 5 - Parametrization mode simple discard=

;./neemp -m params -p lr-full --sdf-file examples/set01.sdf --chg-file examples/set01.chg --discard simple -v --check-charges --limit-iters 600 --limit-time <nowiki>00:30:00</nowiki>

:Perform simple discarding with '''LR''' approach and print its progress. Issue warning about molecules with abnormal values of statistical descriptors. The duration of the discarding procedure can be at most 600 iterations or 30 minutes (time format HH:MM:SS), whichever is reached first.
 

[[File:simple_discard.png | thumb | 800px | center | '''''Figure 13:''''' Abridged output for the simple discard progress. The simple discarding requires as many iterations as the number of molecules in the set, unless the iterations or time limits are reached first. In this case the training set contains only 500 structures so the iteration limit doesn't affect the discarding. The time limit still holds on the other hand. Refer to the [[NEEMP:Modes#Linear Regression (LR) | parametrization paragraph]] for details.]]

=Example 6 - Parametrization mode DE-MIN=

;./neemp -m params -p de --sdf-file examples/set01.sdf --chg-file examples/set01.chg --om-pop-size 50 --om-iters 500 --random-seed 1234 -vv

:Compute parameters for the given molecules (''set01.sdf'') and ab-initio charges (''charges.chg''). The chosen optimization method: differential evolution + minimization will act on a parameter vector population consisting of 50 units. The optimization procedure will be carried out for at most 500 iterations. A user-defined seed is used, as well as an high level of verbosity.

For additional information click [[NEEMP:Modes#Differential Evolution + Minimization (DE-MIN) | here]].

=Example 7 - Coverage validation=

;./neemp -m cover -sdf-file examples/set02.sdf --par-file examples/ElemBond.par

:Calculate coverage of supplied molecules set given a specific parameter set.
 

[[File:cover_mode2.png | thumb | 400px | center | '''''Figure 14:''''' Close up from the output for ''Cover mode'' summarizing information about the input files, molecules set composition and coverage. In this case the parameter set ''ElemBond.par'' lacks the parameters for all the marked atomic types in ''set02.sdf'', leading to the discard of 1690 molecules. Note the similarities with ''Calculation mode'' output in the case of low coverage circumstance. For more information on this mode refer to [[NEEMP:Modes#Coverage validation | Cover validation]] section.]]

=Example 8 - Quality validation=

;./neemp -m cross --sdf-file examples/set02.sdf --chg-file examples/charges.chg --par-file examples/Element.par --chg-stats-out stats --atom-types-by Element 2> warns > log

:Perform cross-validation of EEM parameters for atoms grouped by element only. Save standard output into the file ''log'' and warnings into the file ''warns''. Moreover outputs charge statistics for each molecule into the file ''stats''.

For more information on this mode click [[NEEMP:Modes#Quality validation | here]].
 

[[File:chg_stats.png | thumb | 900px | center | '''''Figure 12:''''' Close-up from ''stats'' file. Along with statistics for each molecule, ''ab-initio'' charges (3rd column), ''EEM'' charges (4th column) and their difference (5th column) are also printed out.]]

File:Cover mode2.png

2016-06-29T13:24:43Z

Francesco: Francesco uploaded a new version of File:Cover mode2.png

NEEMP:Examples

2016-06-29T13:18:44Z

Francesco: /* Example 7 - Coverage validation */

__NOTOC__

This section shows several use case examples. All of them use only data from ''examples'' directory.

'''NB:''' '''NEEMP is case-sensitive'''. Please follow carefully this section for insight on the correct syntax. Additional information can be found [[NEEMP:Options | here]].

=Example 1 - Training set information=

;./neemp -m info --atom-types-by ElemBond --sdf-file examples/set01.sdf

:Prints information about training set ''set01.sdf'', provided as argument of the <code>--sdf-file</code> option, grouping atoms according to chemical element and bond order. To override this behaviour and group atoms only by element, call '''NEEMP''' with <code>--atom-types-by Element</code> option.
 

[[File:info_mode.png | thumb | 400px | center | '''''Figure 10:''''' Information about structures set ''examples/set01.sdf''.]]

=Example 2 - Calculation mode=

;./neemp -m charges --sdf-file examples/set01.sdf --par-file examples/ElemBond.par --chg-out-file eem_charges --max-threads 8

:Compute EEM charges and store them into the file ''eem_charges''. Use up to 8 threads for computation.

For more information on this mode and its output, refer to [[NEEMP:Modes#Calculation mode | Calculation mode]] section.

For details on ''eem_charges'' output file, see [[NEEMP:files#CHG file | CHG file]] paragraph, as the format is the same. The only different regards the third column, since in this case the '''EEM charges''' are listed in place of the '''ab-initio charges'''.

=Example 3 - Parametrization mode=

;./neemp -m params -p lr-full --sdf-file examples/set01.sdf --chg-file examples/set01.chg --par-out-file new_parameters.par --chg-stats-out-file stats

:Perform EEM parametrization using '''LR''' approach, save parameters into the file ''new_parameters.par'', output charge statistics for each molecule into the file ''stats''. No discarding is used.

'''NB:''' the parameters set file ''new_parameters.par'' presents the same identical format and layout as described [[NEEMP:files#PAR file | here]].

For additional information click [[NEEMP:Modes#Linear Regression (LR) | here]].

=Example 4 - Parametrization mode k search=

;./neemp -m params -p lr-full --sdf-file examples/set01.sdf --chg-file examples/set01.chg --kappa-max 1.0 --fs-precision 0.02 --sort-by RMSD -vv

:Similar to previous example, use custom range for k. Select best parameters according to ''RMSD''. Print k search progress.

Reference to [[NEEMP:Modes#Linear Regression (LR) | parametrization paragraph]] and [[NEEMP:Options | options list]] if necessary.

{| class="wikitable" border="1" style="margin-left: auto; margin-right: auto;" width="650px"
|-
| [[File:ksearch1.png| 550px]]
| [[File:ksearch2.png| 700px]]
|-
| '''''Figure 11:''''' Detailed view of the parametrization settings from the execution of the above command. In particular note the usage of a different evaluating statistics (''RMSD'') and the custom range for the k search.
| '''''Figure 12:''''' Abridged output for the k search progress. For each k value a set of parameters is generated and evaluated. In this particular instance, the parameters set with the lowest ''RMSD'' value is chosen.
|}

=Example 5 - Parametrization mode simple discard=

;./neemp -m params -p lr-full --sdf-file examples/set01.sdf --chg-file examples/set01.chg --discard simple -v --check-charges --limit-iters 600 --limit-time <nowiki>00:30:00</nowiki>

:Perform simple discarding with '''LR''' approach and print its progress. Issue warning about molecules with abnormal values of statistical descriptors. The duration of the discarding procedure can be at most 600 iterations or 30 minutes (time format HH:MM:SS), whichever is reached first.
 

[[File:simple_discard.png | thumb | 800px | center | '''''Figure 13:''''' Abridged output for the simple discard progress. The simple discarding requires as many iterations as the number of molecules in the set, unless the iterations or time limits are reached first. In this case the training set contains only 500 structures so the iteration limit doesn't affect the discarding. The time limit still holds on the other hand. Refer to the [[NEEMP:Modes#Linear Regression (LR) | parametrization paragraph]] for details.]]

=Example 6 - Parametrization mode DE-MIN=

;./neemp -m params -p de --sdf-file examples/set01.sdf --chg-file examples/set01.chg --om-pop-size 50 --om-iters 500 --random-seed 1234 -vv

:Compute parameters for the given molecules (''set01.sdf'') and ab-initio charges (''charges.chg''). The chosen optimization method: differential evolution + minimization will act on a parameter vector population consisting of 50 units. The optimization procedure will be carried out for at most 500 iterations. A user-defined seed is used, as well as an high level of verbosity.

For additional information click [[NEEMP:Modes#Differential Evolution + Minimization (DE-MIN) | here]].

=Example 7 - Coverage validation=

;./neemp -m cover -sdf-file examples/set02.sdf --par-file examples/ElemBond.par

:Calculate coverage of supplied molecules set given a specific parameter set.
 

[[File:cover_mode2.png | thumb | 400px | center | '''''Figure 14:''''' Complete output for the ''Cover mode'' summarizing information about the input files, molecules set composition and coverage. For more information on this mode refer to [[NEEMP:Modes#Coverage validation | Cover validation]] section.]]

=Example 8 - Quality validation=

;./neemp -m cross --sdf-file examples/set02.sdf --chg-file examples/charges.chg --par-file examples/Element.par --chg-stats-out stats --atom-types-by Element 2> warns > log

:Perform cross-validation of EEM parameters for atoms grouped by element only. Save standard output into the file ''log'' and warnings into the file ''warns''. Moreover outputs charge statistics for each molecule into the file ''stats''.

For more information on this mode click [[NEEMP:Modes#Quality validation | here]].
 

[[File:chg_stats.png | thumb | 900px | center | '''''Figure 12:''''' Close-up from ''stats'' file. Along with statistics for each molecule, ''ab-initio'' charges (3rd column), ''EEM'' charges (4th column) and their difference (5th column) are also printed out.]]

NEEMP:Examples

2016-06-29T13:08:17Z

Francesco: /* Example 7 - Coverage validation */

__NOTOC__

This section shows several use case examples. All of them use only data from ''examples'' directory.

'''NB:''' '''NEEMP is case-sensitive'''. Please follow carefully this section for insight on the correct syntax. Additional information can be found [[NEEMP:Options | here]].

=Example 1 - Training set information=

;./neemp -m info --atom-types-by ElemBond --sdf-file examples/set01.sdf

:Prints information about training set ''set01.sdf'', provided as argument of the <code>--sdf-file</code> option, grouping atoms according to chemical element and bond order. To override this behaviour and group atoms only by element, call '''NEEMP''' with <code>--atom-types-by Element</code> option.
 

[[File:info_mode.png | thumb | 400px | center | '''''Figure 10:''''' Information about structures set ''examples/set01.sdf''.]]

=Example 2 - Calculation mode=

;./neemp -m charges --sdf-file examples/set01.sdf --par-file examples/ElemBond.par --chg-out-file eem_charges --max-threads 8

:Compute EEM charges and store them into the file ''eem_charges''. Use up to 8 threads for computation.

For more information on this mode and its output, refer to [[NEEMP:Modes#Calculation mode | Calculation mode]] section.

For details on ''eem_charges'' output file, see [[NEEMP:files#CHG file | CHG file]] paragraph, as the format is the same. The only different regards the third column, since in this case the '''EEM charges''' are listed in place of the '''ab-initio charges'''.

=Example 3 - Parametrization mode=

;./neemp -m params -p lr-full --sdf-file examples/set01.sdf --chg-file examples/set01.chg --par-out-file new_parameters.par --chg-stats-out-file stats

:Perform EEM parametrization using '''LR''' approach, save parameters into the file ''new_parameters.par'', output charge statistics for each molecule into the file ''stats''. No discarding is used.

'''NB:''' the parameters set file ''new_parameters.par'' presents the same identical format and layout as described [[NEEMP:files#PAR file | here]].

For additional information click [[NEEMP:Modes#Linear Regression (LR) | here]].

=Example 4 - Parametrization mode k search=

;./neemp -m params -p lr-full --sdf-file examples/set01.sdf --chg-file examples/set01.chg --kappa-max 1.0 --fs-precision 0.02 --sort-by RMSD -vv

:Similar to previous example, use custom range for k. Select best parameters according to ''RMSD''. Print k search progress.

Reference to [[NEEMP:Modes#Linear Regression (LR) | parametrization paragraph]] and [[NEEMP:Options | options list]] if necessary.

{| class="wikitable" border="1" style="margin-left: auto; margin-right: auto;" width="650px"
|-
| [[File:ksearch1.png| 550px]]
| [[File:ksearch2.png| 700px]]
|-
| '''''Figure 11:''''' Detailed view of the parametrization settings from the execution of the above command. In particular note the usage of a different evaluating statistics (''RMSD'') and the custom range for the k search.
| '''''Figure 12:''''' Abridged output for the k search progress. For each k value a set of parameters is generated and evaluated. In this particular instance, the parameters set with the lowest ''RMSD'' value is chosen.
|}

=Example 5 - Parametrization mode simple discard=

;./neemp -m params -p lr-full --sdf-file examples/set01.sdf --chg-file examples/set01.chg --discard simple -v --check-charges --limit-iters 600 --limit-time <nowiki>00:30:00</nowiki>

:Perform simple discarding with '''LR''' approach and print its progress. Issue warning about molecules with abnormal values of statistical descriptors. The duration of the discarding procedure can be at most 600 iterations or 30 minutes (time format HH:MM:SS), whichever is reached first.
 

[[File:simple_discard.png | thumb | 800px | center | '''''Figure 13:''''' Abridged output for the simple discard progress. The simple discarding requires as many iterations as the number of molecules in the set, unless the iterations or time limits are reached first. In this case the training set contains only 500 structures so the iteration limit doesn't affect the discarding. The time limit still holds on the other hand. Refer to the [[NEEMP:Modes#Linear Regression (LR) | parametrization paragraph]] for details.]]

=Example 6 - Parametrization mode DE-MIN=

;./neemp -m params -p de --sdf-file examples/set01.sdf --chg-file examples/set01.chg --om-pop-size 50 --om-iters 500 --random-seed 1234 -vv

:Compute parameters for the given molecules (''set01.sdf'') and ab-initio charges (''charges.chg''). The chosen optimization method: differential evolution + minimization will act on a parameter vector population consisting of 50 units. The optimization procedure will be carried out for at most 500 iterations. A user-defined seed is used, as well as an high level of verbosity.

For additional information click [[NEEMP:Modes#Differential Evolution + Minimization (DE-MIN) | here]].

=Example 7 - Coverage validation=

;./neemp -m cover -sdf-file examples/set02.sdf --par-file examples/Element.par --atom-types-by Element

:Calculate coverage of supplied EEM parameters and molecules set.
 

[[File:cover_mode2.png | thumb | 400px | center | '''''Figure 14:''''' Complete output for the ''Cover mode'' summarizing information about the input files, molecules set composition and coverage. For more information on this mode refer to [[NEEMP:Modes#Coverage validation | Cover validation]] section.]]

=Example 8 - Quality validation=

;./neemp -m cross --sdf-file examples/set02.sdf --chg-file examples/charges.chg --par-file examples/Element.par --chg-stats-out stats --atom-types-by Element 2> warns > log

:Perform cross-validation of EEM parameters for atoms grouped by element only. Save standard output into the file ''log'' and warnings into the file ''warns''. Moreover outputs charge statistics for each molecule into the file ''stats''.

For more information on this mode click [[NEEMP:Modes#Quality validation | here]].
 

[[File:chg_stats.png | thumb | 900px | center | '''''Figure 12:''''' Close-up from ''stats'' file. Along with statistics for each molecule, ''ab-initio'' charges (3rd column), ''EEM'' charges (4th column) and their difference (5th column) are also printed out.]]

NEEMP:Examples

2016-06-29T13:08:01Z

Francesco: /* Example 6 - Parametrization mode DE-MIN */

__NOTOC__

This section shows several use case examples. All of them use only data from ''examples'' directory.

'''NB:''' '''NEEMP is case-sensitive'''. Please follow carefully this section for insight on the correct syntax. Additional information can be found [[NEEMP:Options | here]].

=Example 1 - Training set information=

;./neemp -m info --atom-types-by ElemBond --sdf-file examples/set01.sdf

:Prints information about training set ''set01.sdf'', provided as argument of the <code>--sdf-file</code> option, grouping atoms according to chemical element and bond order. To override this behaviour and group atoms only by element, call '''NEEMP''' with <code>--atom-types-by Element</code> option.
 

[[File:info_mode.png | thumb | 400px | center | '''''Figure 10:''''' Information about structures set ''examples/set01.sdf''.]]

=Example 2 - Calculation mode=

;./neemp -m charges --sdf-file examples/set01.sdf --par-file examples/ElemBond.par --chg-out-file eem_charges --max-threads 8

:Compute EEM charges and store them into the file ''eem_charges''. Use up to 8 threads for computation.

For more information on this mode and its output, refer to [[NEEMP:Modes#Calculation mode | Calculation mode]] section.

For details on ''eem_charges'' output file, see [[NEEMP:files#CHG file | CHG file]] paragraph, as the format is the same. The only different regards the third column, since in this case the '''EEM charges''' are listed in place of the '''ab-initio charges'''.

=Example 3 - Parametrization mode=

;./neemp -m params -p lr-full --sdf-file examples/set01.sdf --chg-file examples/set01.chg --par-out-file new_parameters.par --chg-stats-out-file stats

:Perform EEM parametrization using '''LR''' approach, save parameters into the file ''new_parameters.par'', output charge statistics for each molecule into the file ''stats''. No discarding is used.

'''NB:''' the parameters set file ''new_parameters.par'' presents the same identical format and layout as described [[NEEMP:files#PAR file | here]].

For additional information click [[NEEMP:Modes#Linear Regression (LR) | here]].

=Example 4 - Parametrization mode k search=

;./neemp -m params -p lr-full --sdf-file examples/set01.sdf --chg-file examples/set01.chg --kappa-max 1.0 --fs-precision 0.02 --sort-by RMSD -vv

:Similar to previous example, use custom range for k. Select best parameters according to ''RMSD''. Print k search progress.

Reference to [[NEEMP:Modes#Linear Regression (LR) | parametrization paragraph]] and [[NEEMP:Options | options list]] if necessary.

{| class="wikitable" border="1" style="margin-left: auto; margin-right: auto;" width="650px"
|-
| [[File:ksearch1.png| 550px]]
| [[File:ksearch2.png| 700px]]
|-
| '''''Figure 11:''''' Detailed view of the parametrization settings from the execution of the above command. In particular note the usage of a different evaluating statistics (''RMSD'') and the custom range for the k search.
| '''''Figure 12:''''' Abridged output for the k search progress. For each k value a set of parameters is generated and evaluated. In this particular instance, the parameters set with the lowest ''RMSD'' value is chosen.
|}

=Example 5 - Parametrization mode simple discard=

;./neemp -m params -p lr-full --sdf-file examples/set01.sdf --chg-file examples/set01.chg --discard simple -v --check-charges --limit-iters 600 --limit-time <nowiki>00:30:00</nowiki>

:Perform simple discarding with '''LR''' approach and print its progress. Issue warning about molecules with abnormal values of statistical descriptors. The duration of the discarding procedure can be at most 600 iterations or 30 minutes (time format HH:MM:SS), whichever is reached first.
 

[[File:simple_discard.png | thumb | 800px | center | '''''Figure 13:''''' Abridged output for the simple discard progress. The simple discarding requires as many iterations as the number of molecules in the set, unless the iterations or time limits are reached first. In this case the training set contains only 500 structures so the iteration limit doesn't affect the discarding. The time limit still holds on the other hand. Refer to the [[NEEMP:Modes#Linear Regression (LR) | parametrization paragraph]] for details.]]

=Example 6 - Parametrization mode DE-MIN=

;./neemp -m params -p de --sdf-file examples/set01.sdf --chg-file examples/set01.chg --om-pop-size 50 --om-iters 500 --random-seed 1234 -vv

:Compute parameters for the given molecules (''set01.sdf'') and ab-initio charges (''charges.chg''). The chosen optimization method: differential evolution + minimization will act on a parameter vector population consisting of 50 units. The optimization procedure will be carried out for at most 500 iterations. A user-defined seed is used, as well as an high level of verbosity.

For additional information click [[NEEMP:Modes#Differential Evolution + Minimization (DE-MIN) | here]].

=Example 7 - Coverage validation=

;./neemp -m cover -sdf-file examples/set02.sdf --par-file examples/Element.par --atom-types-by Element

:Calculate coverage of supplied EEM parameters and molecules set.
 

[[File:cover_mode2.png | thumb | 400px | center | '''''Figure 11:''''' Complete output for the ''Cover mode'' summarizing information about the input files, molecules set composition and coverage. For more information on this mode refer to [[NEEMP:Modes#Coverage validation | Cover validation]] section.]]

=Example 8 - Quality validation=

;./neemp -m cross --sdf-file examples/set02.sdf --chg-file examples/charges.chg --par-file examples/Element.par --chg-stats-out stats --atom-types-by Element 2> warns > log

:Perform cross-validation of EEM parameters for atoms grouped by element only. Save standard output into the file ''log'' and warnings into the file ''warns''. Moreover outputs charge statistics for each molecule into the file ''stats''.

For more information on this mode click [[NEEMP:Modes#Quality validation | here]].
 

[[File:chg_stats.png | thumb | 900px | center | '''''Figure 12:''''' Close-up from ''stats'' file. Along with statistics for each molecule, ''ab-initio'' charges (3rd column), ''EEM'' charges (4th column) and their difference (5th column) are also printed out.]]

File:Simple discard.png

2016-06-29T13:03:51Z

Francesco: Francesco uploaded a new version of File:Simple discard.png

NEEMP:Examples

2016-06-29T12:51:09Z

Francesco: /* Example 5 - Parametrization mode simple discard */

__NOTOC__

This section shows several use case examples. All of them use only data from ''examples'' directory.

'''NB:''' '''NEEMP is case-sensitive'''. Please follow carefully this section for insight on the correct syntax. Additional information can be found [[NEEMP:Options | here]].

=Example 1 - Training set information=

;./neemp -m info --atom-types-by ElemBond --sdf-file examples/set01.sdf

:Prints information about training set ''set01.sdf'', provided as argument of the <code>--sdf-file</code> option, grouping atoms according to chemical element and bond order. To override this behaviour and group atoms only by element, call '''NEEMP''' with <code>--atom-types-by Element</code> option.
 

[[File:info_mode.png | thumb | 400px | center | '''''Figure 10:''''' Information about structures set ''examples/set01.sdf''.]]

=Example 2 - Calculation mode=

;./neemp -m charges --sdf-file examples/set01.sdf --par-file examples/ElemBond.par --chg-out-file eem_charges --max-threads 8

:Compute EEM charges and store them into the file ''eem_charges''. Use up to 8 threads for computation.

For more information on this mode and its output, refer to [[NEEMP:Modes#Calculation mode | Calculation mode]] section.

For details on ''eem_charges'' output file, see [[NEEMP:files#CHG file | CHG file]] paragraph, as the format is the same. The only different regards the third column, since in this case the '''EEM charges''' are listed in place of the '''ab-initio charges'''.

=Example 3 - Parametrization mode=

;./neemp -m params -p lr-full --sdf-file examples/set01.sdf --chg-file examples/set01.chg --par-out-file new_parameters.par --chg-stats-out-file stats

:Perform EEM parametrization using '''LR''' approach, save parameters into the file ''new_parameters.par'', output charge statistics for each molecule into the file ''stats''. No discarding is used.

'''NB:''' the parameters set file ''new_parameters.par'' presents the same identical format and layout as described [[NEEMP:files#PAR file | here]].

For additional information click [[NEEMP:Modes#Linear Regression (LR) | here]].

=Example 4 - Parametrization mode k search=

;./neemp -m params -p lr-full --sdf-file examples/set01.sdf --chg-file examples/set01.chg --kappa-max 1.0 --fs-precision 0.02 --sort-by RMSD -vv

:Similar to previous example, use custom range for k. Select best parameters according to ''RMSD''. Print k search progress.

Reference to [[NEEMP:Modes#Linear Regression (LR) | parametrization paragraph]] and [[NEEMP:Options | options list]] if necessary.

{| class="wikitable" border="1" style="margin-left: auto; margin-right: auto;" width="650px"
|-
| [[File:ksearch1.png| 550px]]
| [[File:ksearch2.png| 700px]]
|-
| '''''Figure 11:''''' Detailed view of the parametrization settings from the execution of the above command. In particular note the usage of a different evaluating statistics (''RMSD'') and the custom range for the k search.
| '''''Figure 12:''''' Abridged output for the k search progress. For each k value a set of parameters is generated and evaluated. In this particular instance, the parameters set with the lowest ''RMSD'' value is chosen.
|}

=Example 5 - Parametrization mode simple discard=

;./neemp -m params -p lr-full --sdf-file examples/set01.sdf --chg-file examples/set01.chg --discard simple -v --check-charges --limit-iters 600 --limit-time <nowiki>00:30:00</nowiki>

:Perform simple discarding with '''LR''' approach and print its progress. Issue warning about molecules with abnormal values of statistical descriptors. The duration of the discarding procedure can be at most 600 iterations or 30 minutes (time format HH:MM:SS), whichever is reached first.
 

[[File:simple_discard.png | thumb | 800px | center | '''''Figure 13:''''' Abridged output for the simple discard progress. The simple discarding requires as many iterations as the number of molecules in the set, unless the iterations or time limits are reached first. In this case the training set contains only 500 structures so the iteration limit doesn't affect the discarding. The time limit still holds on the other hand. Refer to the [[NEEMP:Modes#Linear Regression (LR) | parametrization paragraph]] for details.]]

=Example 6 - Parametrization mode DE-MIN=

;./neemp -m params -p de --sdf-file examples/set01.sdf --chg-file examples/charges.chg --om-pop-size 50 --om-iters 500 --random-seed 1234 -vv

:Compute parameters for the given molecules in file set01.sdf and ab-initio charges in charges.chg. The chosen optimization method: differential evolution + minimization will act on a parameter vector population consisting of 50 units. The optimization procedure will be carried out for at most 500 iterations. A user-defined seed is used, as well as an high level of verbosity.

For additional information click [[NEEMP:Modes#Differential Evolution + Minimization (DE-MIN) | here]].

=Example 7 - Coverage validation=

;./neemp -m cover -sdf-file examples/set02.sdf --par-file examples/Element.par --atom-types-by Element

:Calculate coverage of supplied EEM parameters and molecules set.
 

[[File:cover_mode2.png | thumb | 400px | center | '''''Figure 11:''''' Complete output for the ''Cover mode'' summarizing information about the input files, molecules set composition and coverage. For more information on this mode refer to [[NEEMP:Modes#Coverage validation | Cover validation]] section.]]

=Example 8 - Quality validation=

;./neemp -m cross --sdf-file examples/set02.sdf --chg-file examples/charges.chg --par-file examples/Element.par --chg-stats-out stats --atom-types-by Element 2> warns > log

:Perform cross-validation of EEM parameters for atoms grouped by element only. Save standard output into the file ''log'' and warnings into the file ''warns''. Moreover outputs charge statistics for each molecule into the file ''stats''.

For more information on this mode click [[NEEMP:Modes#Quality validation | here]].
 

[[File:chg_stats.png | thumb | 900px | center | '''''Figure 12:''''' Close-up from ''stats'' file. Along with statistics for each molecule, ''ab-initio'' charges (3rd column), ''EEM'' charges (4th column) and their difference (5th column) are also printed out.]]

NEEMP:Examples

2016-06-29T12:50:44Z

Francesco: /* Example 5 - Parametrization mode simple discard */

__NOTOC__

This section shows several use case examples. All of them use only data from ''examples'' directory.

'''NB:''' '''NEEMP is case-sensitive'''. Please follow carefully this section for insight on the correct syntax. Additional information can be found [[NEEMP:Options | here]].

=Example 1 - Training set information=

;./neemp -m info --atom-types-by ElemBond --sdf-file examples/set01.sdf

:Prints information about training set ''set01.sdf'', provided as argument of the <code>--sdf-file</code> option, grouping atoms according to chemical element and bond order. To override this behaviour and group atoms only by element, call '''NEEMP''' with <code>--atom-types-by Element</code> option.
 

[[File:info_mode.png | thumb | 400px | center | '''''Figure 10:''''' Information about structures set ''examples/set01.sdf''.]]

=Example 2 - Calculation mode=

;./neemp -m charges --sdf-file examples/set01.sdf --par-file examples/ElemBond.par --chg-out-file eem_charges --max-threads 8

:Compute EEM charges and store them into the file ''eem_charges''. Use up to 8 threads for computation.

For more information on this mode and its output, refer to [[NEEMP:Modes#Calculation mode | Calculation mode]] section.

For details on ''eem_charges'' output file, see [[NEEMP:files#CHG file | CHG file]] paragraph, as the format is the same. The only different regards the third column, since in this case the '''EEM charges''' are listed in place of the '''ab-initio charges'''.

=Example 3 - Parametrization mode=

;./neemp -m params -p lr-full --sdf-file examples/set01.sdf --chg-file examples/set01.chg --par-out-file new_parameters.par --chg-stats-out-file stats

:Perform EEM parametrization using '''LR''' approach, save parameters into the file ''new_parameters.par'', output charge statistics for each molecule into the file ''stats''. No discarding is used.

'''NB:''' the parameters set file ''new_parameters.par'' presents the same identical format and layout as described [[NEEMP:files#PAR file | here]].

For additional information click [[NEEMP:Modes#Linear Regression (LR) | here]].

=Example 4 - Parametrization mode k search=

;./neemp -m params -p lr-full --sdf-file examples/set01.sdf --chg-file examples/set01.chg --kappa-max 1.0 --fs-precision 0.02 --sort-by RMSD -vv

:Similar to previous example, use custom range for k. Select best parameters according to ''RMSD''. Print k search progress.

Reference to [[NEEMP:Modes#Linear Regression (LR) | parametrization paragraph]] and [[NEEMP:Options | options list]] if necessary.

{| class="wikitable" border="1" style="margin-left: auto; margin-right: auto;" width="650px"
|-
| [[File:ksearch1.png| 550px]]
| [[File:ksearch2.png| 700px]]
|-
| '''''Figure 11:''''' Detailed view of the parametrization settings from the execution of the above command. In particular note the usage of a different evaluating statistics (''RMSD'') and the custom range for the k search.
| '''''Figure 12:''''' Abridged output for the k search progress. For each k value a set of parameters is generated and evaluated. In this particular instance, the parameters set with the lowest ''RMSD'' value is chosen.
|}

=Example 5 - Parametrization mode simple discard=

;./neemp -m params -p lr-full --sdf-file examples/set01.sdf --chg-file examples/set01.chg --discard simple -v --check-charges --limit-iters 600 --limit-time <nowiki>00:30:00</nowiki>

:Perform simple discarding and print its progress. Issue warning about molecules with abnormal values of statistical descriptors. The duration of the discarding procedure can be at most 600 iterations or 30 minutes (time format HH:MM:SS), whichever is reached first.
 

[[File:simple_discard.png | thumb | 800px | center | '''''Figure 13:''''' Abridged output for the simple discard progress. The simple discarding requires as many iterations as the number of molecules in the set, unless the iterations or time limits are reached first. In this case the training set contains only 500 structures so the iteration limit doesn't affect the discarding. The time limit still holds on the other hand. Refer to the [[NEEMP:Modes#Linear Regression (LR) | parametrization paragraph]] for details.]]

=Example 6 - Parametrization mode DE-MIN=

;./neemp -m params -p de --sdf-file examples/set01.sdf --chg-file examples/charges.chg --om-pop-size 50 --om-iters 500 --random-seed 1234 -vv

:Compute parameters for the given molecules in file set01.sdf and ab-initio charges in charges.chg. The chosen optimization method: differential evolution + minimization will act on a parameter vector population consisting of 50 units. The optimization procedure will be carried out for at most 500 iterations. A user-defined seed is used, as well as an high level of verbosity.

For additional information click [[NEEMP:Modes#Differential Evolution + Minimization (DE-MIN) | here]].

=Example 7 - Coverage validation=

;./neemp -m cover -sdf-file examples/set02.sdf --par-file examples/Element.par --atom-types-by Element

:Calculate coverage of supplied EEM parameters and molecules set.
 

[[File:cover_mode2.png | thumb | 400px | center | '''''Figure 11:''''' Complete output for the ''Cover mode'' summarizing information about the input files, molecules set composition and coverage. For more information on this mode refer to [[NEEMP:Modes#Coverage validation | Cover validation]] section.]]

=Example 8 - Quality validation=

;./neemp -m cross --sdf-file examples/set02.sdf --chg-file examples/charges.chg --par-file examples/Element.par --chg-stats-out stats --atom-types-by Element 2> warns > log

:Perform cross-validation of EEM parameters for atoms grouped by element only. Save standard output into the file ''log'' and warnings into the file ''warns''. Moreover outputs charge statistics for each molecule into the file ''stats''.

For more information on this mode click [[NEEMP:Modes#Quality validation | here]].
 

[[File:chg_stats.png | thumb | 900px | center | '''''Figure 12:''''' Close-up from ''stats'' file. Along with statistics for each molecule, ''ab-initio'' charges (3rd column), ''EEM'' charges (4th column) and their difference (5th column) are also printed out.]]

NEEMP:Examples

2016-06-29T12:47:35Z

Francesco: /* Example 5 - Parametrization mode simple discard */

__NOTOC__

This section shows several use case examples. All of them use only data from ''examples'' directory.

'''NB:''' '''NEEMP is case-sensitive'''. Please follow carefully this section for insight on the correct syntax. Additional information can be found [[NEEMP:Options | here]].

=Example 1 - Training set information=

;./neemp -m info --atom-types-by ElemBond --sdf-file examples/set01.sdf

:Prints information about training set ''set01.sdf'', provided as argument of the <code>--sdf-file</code> option, grouping atoms according to chemical element and bond order. To override this behaviour and group atoms only by element, call '''NEEMP''' with <code>--atom-types-by Element</code> option.
 

[[File:info_mode.png | thumb | 400px | center | '''''Figure 10:''''' Information about structures set ''examples/set01.sdf''.]]

=Example 2 - Calculation mode=

;./neemp -m charges --sdf-file examples/set01.sdf --par-file examples/ElemBond.par --chg-out-file eem_charges --max-threads 8

:Compute EEM charges and store them into the file ''eem_charges''. Use up to 8 threads for computation.

For more information on this mode and its output, refer to [[NEEMP:Modes#Calculation mode | Calculation mode]] section.

For details on ''eem_charges'' output file, see [[NEEMP:files#CHG file | CHG file]] paragraph, as the format is the same. The only different regards the third column, since in this case the '''EEM charges''' are listed in place of the '''ab-initio charges'''.

=Example 3 - Parametrization mode=

;./neemp -m params -p lr-full --sdf-file examples/set01.sdf --chg-file examples/set01.chg --par-out-file new_parameters.par --chg-stats-out-file stats

:Perform EEM parametrization using '''LR''' approach, save parameters into the file ''new_parameters.par'', output charge statistics for each molecule into the file ''stats''. No discarding is used.

'''NB:''' the parameters set file ''new_parameters.par'' presents the same identical format and layout as described [[NEEMP:files#PAR file | here]].

For additional information click [[NEEMP:Modes#Linear Regression (LR) | here]].

=Example 4 - Parametrization mode k search=

;./neemp -m params -p lr-full --sdf-file examples/set01.sdf --chg-file examples/set01.chg --kappa-max 1.0 --fs-precision 0.02 --sort-by RMSD -vv

:Similar to previous example, use custom range for k. Select best parameters according to ''RMSD''. Print k search progress.

Reference to [[NEEMP:Modes#Linear Regression (LR) | parametrization paragraph]] and [[NEEMP:Options | options list]] if necessary.

{| class="wikitable" border="1" style="margin-left: auto; margin-right: auto;" width="650px"
|-
| [[File:ksearch1.png| 550px]]
| [[File:ksearch2.png| 700px]]
|-
| '''''Figure 11:''''' Detailed view of the parametrization settings from the execution of the above command. In particular note the usage of a different evaluating statistics (''RMSD'') and the custom range for the k search.
| '''''Figure 12:''''' Abridged output for the k search progress. For each k value a set of parameters is generated and evaluated. In this particular instance, the parameters set with the lowest ''RMSD'' value is chosen.
|}

=Example 5 - Parametrization mode simple discard=

;./neemp -m params --sdf-file examples/set01.sdf --chg-file examples/set01.chg --discard simple -v --check-charges --limit-iters 600 --limit-time <nowiki>00:30:00</nowiki>

:Perform simple discarding and print its progress. Issue warning about molecules with abnormal values of statistical descriptors. The duration of the discarding procedure can be at most 600 iterations or 30 minutes (time format HH:MM:SS), whichever is reached first.
 

[[File:simple_discard.png | thumb | 800px | center | '''''Figure 13:''''' Abridged output for the simple discard progress. The simple discarding requires as many iterations as the number of molecules in the set, unless the iterations or time limits are reached first. In this case the training set contains only 500 structures so the iteration limit doesn't affect the discarding. The time limit still holds on the other hand. Refer to the [[NEEMP:Modes#Linear Regression (LR) | parametrization paragraph]] for details.]]

=Example 6 - Parametrization mode DE-MIN=

;./neemp -m params -p de --sdf-file examples/set01.sdf --chg-file examples/charges.chg --om-pop-size 50 --om-iters 500 --random-seed 1234 -vv

:Compute parameters for the given molecules in file set01.sdf and ab-initio charges in charges.chg. The chosen optimization method: differential evolution + minimization will act on a parameter vector population consisting of 50 units. The optimization procedure will be carried out for at most 500 iterations. A user-defined seed is used, as well as an high level of verbosity.

For additional information click [[NEEMP:Modes#Differential Evolution + Minimization (DE-MIN) | here]].

=Example 7 - Coverage validation=

;./neemp -m cover -sdf-file examples/set02.sdf --par-file examples/Element.par --atom-types-by Element

:Calculate coverage of supplied EEM parameters and molecules set.
 

[[File:cover_mode2.png | thumb | 400px | center | '''''Figure 11:''''' Complete output for the ''Cover mode'' summarizing information about the input files, molecules set composition and coverage. For more information on this mode refer to [[NEEMP:Modes#Coverage validation | Cover validation]] section.]]

=Example 8 - Quality validation=

;./neemp -m cross --sdf-file examples/set02.sdf --chg-file examples/charges.chg --par-file examples/Element.par --chg-stats-out stats --atom-types-by Element 2> warns > log

:Perform cross-validation of EEM parameters for atoms grouped by element only. Save standard output into the file ''log'' and warnings into the file ''warns''. Moreover outputs charge statistics for each molecule into the file ''stats''.

For more information on this mode click [[NEEMP:Modes#Quality validation | here]].
 

[[File:chg_stats.png | thumb | 900px | center | '''''Figure 12:''''' Close-up from ''stats'' file. Along with statistics for each molecule, ''ab-initio'' charges (3rd column), ''EEM'' charges (4th column) and their difference (5th column) are also printed out.]]

NEEMP:Examples

2016-06-29T12:47:00Z

Francesco: /* Example 5 - Parametrization mode simple discard */

__NOTOC__

This section shows several use case examples. All of them use only data from ''examples'' directory.

'''NB:''' '''NEEMP is case-sensitive'''. Please follow carefully this section for insight on the correct syntax. Additional information can be found [[NEEMP:Options | here]].

=Example 1 - Training set information=

;./neemp -m info --atom-types-by ElemBond --sdf-file examples/set01.sdf

:Prints information about training set ''set01.sdf'', provided as argument of the <code>--sdf-file</code> option, grouping atoms according to chemical element and bond order. To override this behaviour and group atoms only by element, call '''NEEMP''' with <code>--atom-types-by Element</code> option.
 

[[File:info_mode.png | thumb | 400px | center | '''''Figure 10:''''' Information about structures set ''examples/set01.sdf''.]]

=Example 2 - Calculation mode=

;./neemp -m charges --sdf-file examples/set01.sdf --par-file examples/ElemBond.par --chg-out-file eem_charges --max-threads 8

:Compute EEM charges and store them into the file ''eem_charges''. Use up to 8 threads for computation.

For more information on this mode and its output, refer to [[NEEMP:Modes#Calculation mode | Calculation mode]] section.

For details on ''eem_charges'' output file, see [[NEEMP:files#CHG file | CHG file]] paragraph, as the format is the same. The only different regards the third column, since in this case the '''EEM charges''' are listed in place of the '''ab-initio charges'''.

=Example 3 - Parametrization mode=

;./neemp -m params -p lr-full --sdf-file examples/set01.sdf --chg-file examples/set01.chg --par-out-file new_parameters.par --chg-stats-out-file stats

:Perform EEM parametrization using '''LR''' approach, save parameters into the file ''new_parameters.par'', output charge statistics for each molecule into the file ''stats''. No discarding is used.

'''NB:''' the parameters set file ''new_parameters.par'' presents the same identical format and layout as described [[NEEMP:files#PAR file | here]].

For additional information click [[NEEMP:Modes#Linear Regression (LR) | here]].

=Example 4 - Parametrization mode k search=

;./neemp -m params -p lr-full --sdf-file examples/set01.sdf --chg-file examples/set01.chg --kappa-max 1.0 --fs-precision 0.02 --sort-by RMSD -vv

:Similar to previous example, use custom range for k. Select best parameters according to ''RMSD''. Print k search progress.

Reference to [[NEEMP:Modes#Linear Regression (LR) | parametrization paragraph]] and [[NEEMP:Options | options list]] if necessary.

{| class="wikitable" border="1" style="margin-left: auto; margin-right: auto;" width="650px"
|-
| [[File:ksearch1.png| 550px]]
| [[File:ksearch2.png| 700px]]
|-
| '''''Figure 11:''''' Detailed view of the parametrization settings from the execution of the above command. In particular note the usage of a different evaluating statistics (''RMSD'') and the custom range for the k search.
| '''''Figure 12:''''' Abridged output for the k search progress. For each k value a set of parameters is generated and evaluated. In this particular instance, the parameters set with the lowest ''RMSD'' value is chosen.
|}

=Example 5 - Parametrization mode simple discard=

;./neemp -m params --sdf-file examples/set01.sdf --chg-file examples/charges.chg --discard simple -v --check-charges --limit-iters 600 --limit-time <nowiki>00:30:00</nowiki>

:Perform simple discarding and print its progress. Issue warning about molecules with abnormal values of statistical descriptors. The duration of the discarding procedure can be at most 600 iterations or 30 minutes (time format HH:MM:SS), whichever is reached first.
 

[[File:simple_discard.png | thumb | 800px | center | '''''Figure 13:''''' Abridged output for the simple discard progress. The simple discarding requires as many iterations as the number of molecules in the set, unless the iterations or time limits are reached first. In this case the training set contains only 500 structures so the iteration limit doesn't affect the discarding. The time limit still holds on the other hand. Refer to the [[NEEMP:Modes#Linear Regression (LR) | parametrization paragraph]] for details.]]

=Example 6 - Parametrization mode DE-MIN=

;./neemp -m params -p de --sdf-file examples/set01.sdf --chg-file examples/charges.chg --om-pop-size 50 --om-iters 500 --random-seed 1234 -vv

:Compute parameters for the given molecules in file set01.sdf and ab-initio charges in charges.chg. The chosen optimization method: differential evolution + minimization will act on a parameter vector population consisting of 50 units. The optimization procedure will be carried out for at most 500 iterations. A user-defined seed is used, as well as an high level of verbosity.

For additional information click [[NEEMP:Modes#Differential Evolution + Minimization (DE-MIN) | here]].

=Example 7 - Coverage validation=

;./neemp -m cover -sdf-file examples/set02.sdf --par-file examples/Element.par --atom-types-by Element

:Calculate coverage of supplied EEM parameters and molecules set.
 

[[File:cover_mode2.png | thumb | 400px | center | '''''Figure 11:''''' Complete output for the ''Cover mode'' summarizing information about the input files, molecules set composition and coverage. For more information on this mode refer to [[NEEMP:Modes#Coverage validation | Cover validation]] section.]]

=Example 8 - Quality validation=

;./neemp -m cross --sdf-file examples/set02.sdf --chg-file examples/charges.chg --par-file examples/Element.par --chg-stats-out stats --atom-types-by Element 2> warns > log

:Perform cross-validation of EEM parameters for atoms grouped by element only. Save standard output into the file ''log'' and warnings into the file ''warns''. Moreover outputs charge statistics for each molecule into the file ''stats''.

For more information on this mode click [[NEEMP:Modes#Quality validation | here]].
 

[[File:chg_stats.png | thumb | 900px | center | '''''Figure 12:''''' Close-up from ''stats'' file. Along with statistics for each molecule, ''ab-initio'' charges (3rd column), ''EEM'' charges (4th column) and their difference (5th column) are also printed out.]]

NEEMP:Examples

2016-06-29T12:46:43Z

Francesco: /* Example 4 - Parametrization mode k search */

__NOTOC__

This section shows several use case examples. All of them use only data from ''examples'' directory.

'''NB:''' '''NEEMP is case-sensitive'''. Please follow carefully this section for insight on the correct syntax. Additional information can be found [[NEEMP:Options | here]].

=Example 1 - Training set information=

;./neemp -m info --atom-types-by ElemBond --sdf-file examples/set01.sdf

:Prints information about training set ''set01.sdf'', provided as argument of the <code>--sdf-file</code> option, grouping atoms according to chemical element and bond order. To override this behaviour and group atoms only by element, call '''NEEMP''' with <code>--atom-types-by Element</code> option.
 

[[File:info_mode.png | thumb | 400px | center | '''''Figure 10:''''' Information about structures set ''examples/set01.sdf''.]]

=Example 2 - Calculation mode=

;./neemp -m charges --sdf-file examples/set01.sdf --par-file examples/ElemBond.par --chg-out-file eem_charges --max-threads 8

:Compute EEM charges and store them into the file ''eem_charges''. Use up to 8 threads for computation.

For more information on this mode and its output, refer to [[NEEMP:Modes#Calculation mode | Calculation mode]] section.

For details on ''eem_charges'' output file, see [[NEEMP:files#CHG file | CHG file]] paragraph, as the format is the same. The only different regards the third column, since in this case the '''EEM charges''' are listed in place of the '''ab-initio charges'''.

=Example 3 - Parametrization mode=

;./neemp -m params -p lr-full --sdf-file examples/set01.sdf --chg-file examples/set01.chg --par-out-file new_parameters.par --chg-stats-out-file stats

:Perform EEM parametrization using '''LR''' approach, save parameters into the file ''new_parameters.par'', output charge statistics for each molecule into the file ''stats''. No discarding is used.

'''NB:''' the parameters set file ''new_parameters.par'' presents the same identical format and layout as described [[NEEMP:files#PAR file | here]].

For additional information click [[NEEMP:Modes#Linear Regression (LR) | here]].

=Example 4 - Parametrization mode k search=

;./neemp -m params -p lr-full --sdf-file examples/set01.sdf --chg-file examples/set01.chg --kappa-max 1.0 --fs-precision 0.02 --sort-by RMSD -vv

:Similar to previous example, use custom range for k. Select best parameters according to ''RMSD''. Print k search progress.

Reference to [[NEEMP:Modes#Linear Regression (LR) | parametrization paragraph]] and [[NEEMP:Options | options list]] if necessary.

{| class="wikitable" border="1" style="margin-left: auto; margin-right: auto;" width="650px"
|-
| [[File:ksearch1.png| 550px]]
| [[File:ksearch2.png| 700px]]
|-
| '''''Figure 11:''''' Detailed view of the parametrization settings from the execution of the above command. In particular note the usage of a different evaluating statistics (''RMSD'') and the custom range for the k search.
| '''''Figure 12:''''' Abridged output for the k search progress. For each k value a set of parameters is generated and evaluated. In this particular instance, the parameters set with the lowest ''RMSD'' value is chosen.
|}

=Example 5 - Parametrization mode simple discard=

;./neemp -m params --sdf-file examples/set01.sdf --chg-file examples/charges.chg --discard simple -v --check-charges --limit-iters 600 --limit-time <nowiki>00:30:00</nowiki>

:Perform simple discarding and print its progress. Issue warning about molecules with abnormal values of statistical descriptors. The duration of the discarding procedure can be at most 600 iterations or 30 minutes (time format HH:MM:SS), whichever is reached first.
 

[[File:simple_discard.png | thumb | 800px | center | '''''Figure 15:''''' Abridged output for the simple discard progress. The simple discarding requires as many iterations as the number of molecules in the set, unless the iterations or time limits are reached first. In this case the training set contains only 500 structures so the iteration limit doesn't affect the discarding. The time limit still holds on the other hand. Refer to the [[NEEMP:Modes#Linear Regression (LR) | parametrization paragraph]] for details.]]

=Example 6 - Parametrization mode DE-MIN=

;./neemp -m params -p de --sdf-file examples/set01.sdf --chg-file examples/charges.chg --om-pop-size 50 --om-iters 500 --random-seed 1234 -vv

:Compute parameters for the given molecules in file set01.sdf and ab-initio charges in charges.chg. The chosen optimization method: differential evolution + minimization will act on a parameter vector population consisting of 50 units. The optimization procedure will be carried out for at most 500 iterations. A user-defined seed is used, as well as an high level of verbosity.

For additional information click [[NEEMP:Modes#Differential Evolution + Minimization (DE-MIN) | here]].

=Example 7 - Coverage validation=

;./neemp -m cover -sdf-file examples/set02.sdf --par-file examples/Element.par --atom-types-by Element

:Calculate coverage of supplied EEM parameters and molecules set.
 

[[File:cover_mode2.png | thumb | 400px | center | '''''Figure 11:''''' Complete output for the ''Cover mode'' summarizing information about the input files, molecules set composition and coverage. For more information on this mode refer to [[NEEMP:Modes#Coverage validation | Cover validation]] section.]]

=Example 8 - Quality validation=

;./neemp -m cross --sdf-file examples/set02.sdf --chg-file examples/charges.chg --par-file examples/Element.par --chg-stats-out stats --atom-types-by Element 2> warns > log

:Perform cross-validation of EEM parameters for atoms grouped by element only. Save standard output into the file ''log'' and warnings into the file ''warns''. Moreover outputs charge statistics for each molecule into the file ''stats''.

For more information on this mode click [[NEEMP:Modes#Quality validation | here]].
 

[[File:chg_stats.png | thumb | 900px | center | '''''Figure 12:''''' Close-up from ''stats'' file. Along with statistics for each molecule, ''ab-initio'' charges (3rd column), ''EEM'' charges (4th column) and their difference (5th column) are also printed out.]]