Provide interface to access evaluate_planner_objective.m

As noted in #564 (comment 9765), ramsey_policy only allows for order=1. The solution is to replace it by

ramsey_model;
stoch_simul(order=2)

But the downside of this approach is that we do not compute the welfare function in this case and one cannot add it to the model-block. For that reason, we need to provide the user with an interface to call evaluate_planner_objective

changed milestone to %4.6

added enhancement label

For now, we need a command evaluate_planner_objective(options) that translates into

oo_.planner_objective_value = evaluate_planner_objective(M_,options_,oo_);

As is, there are no options passed to the command, but that might change in the future.

assigned to @houtanb

mentioned in issue #564 (closed)

added preprocessor label

@JohannesPfeifer should a warning also be issued if ramsey_policy is present saying that it's obsolete?

That is a tricky issue. The evaluation of the planner objective at higher order it not done yet and I don't think it will be for 4.6. But it's probably a good idea to nevertheless phase out ramsey_policy with a warning. That way, people can still simulate their model at higher order. We can then add a warning to evaluate_planner_objective that we are currently not computing the objective at higher order.

mentioned in issue #1680 (closed)

@JohannesPfeifer thanks. Is this OK or would you prefer something else for the warning text: "Warning: the ramsey_policy statement is deprecated. Please use ramsey_model, stoch_simul and evaluate_planner_objective instead."

@houtanb Sounds good to me.

mentioned in commit preprocessor@8dfa79a0

mentioned in commit preprocessor@7958f76f

@JohannesPfeifer can you document this and add the warning to evaluate_planner_objective? Also, it would be good to add it to https://git.dynare.org/Dynare/dynare/wikis/NewFeatures, perhaps using the icon to say that ramsey_policy has been deprecated

assigned to @JohannesPfeifer and unassigned @houtanb

added documentation label

Yes, will do.

To-Do

• Document command in the manual
• Add it to https://git.dynare.org/Dynare/dynare/wikis/NewFeatures
• Provide transition information at https://git.dynare.org/Dynare/dynare/wikis/BreakingFeaturesIn4.6
• Add warning to evaluate_planner_objective
• Adjust testsuite mod-files to new syntax

mentioned in commit 7f1fcaa3

mentioned in commit JohannesPfeifer/dynare@a4030c36