/**
 *  \file OptimizerState.h   \brief Shared optimizer state.
 *
 *  Copyright 2007-2010 IMP Inventors. All rights reserved.
 *
 */

#ifndef IMP_OPTIMIZER_STATE_H
#define IMP_OPTIMIZER_STATE_H

#include "kernel_config.h"
#include "VersionInfo.h"
#include "RefCounted.h"
#include "Pointer.h"
#include "VectorOfRefCounted.h"

#include <iostream>

IMP_BEGIN_NAMESPACE

class Optimizer;

//! Shared optimizer state.
/** The OptimizerState update method is called each time the Optimizer commits
    to a new set of coordinates. Optimizer states may change the values of
    particle attributes. However, changes to whether an attribute is optimized
    or not may not be picked up by the Optimizer until the next call to
    optimize.

    \note When logging is VERBOSE, state should print enough information
    in evaluate to reproduce the the entire flow of data in update. When
    logging is TERSE the restraint should print out only a constant number
    of lines per update call.

    Implementors should see IMP_OPTIMIZER_STATE().
 */
class IMPEXPORT OptimizerState : public Object
{
  friend class Optimizer;
  void set_optimizer(Optimizer* optimizer);

public:
  OptimizerState(std::string name="OptimizerState %1%");

  //! Called when the Optimizer accepts a new conformation
  virtual void update() = 0;

  Optimizer *get_optimizer() const {
    IMP_INTERNAL_CHECK(optimizer_,
               "Must call set_optimizer before get_optimizer on state");
    return optimizer_.get();
  }
  IMP_REF_COUNTED_DESTRUCTOR(OptimizerState);
protected:
  WeakPointer<Optimizer> optimizer_;
};

IMP_OBJECTS(OptimizerState);
/** \objects{OptimizerState}
*/
/** \objectstemp{OptimizerState}
*/
IMP_END_NAMESPACE

#endif  /* IMP_OPTIMIZER_STATE_H */