ceres_demo注释版本

#include <opencv2/core/core.hpp>
#include <ceres/ceres.h>
#include <chrono>

using namespace std;

// 代价函数的计算模型
struct CURVE_FITTING_COST
{
    CURVE_FITTING_COST ( double x, double y ) : _x ( x ), _y ( y ) {}
    // 残差的计算
    template <typename T>
    bool operator() (
        const T* const abc,     // 模型参数，有3维 当没有必要分类的时候 就用一个数组来存储未知的系数,方便管理，而不是设3个变量，之后在()重载函数的形式参数个数变为3个
        T* residual ) const     // 残差
    {
        residual[0] = T ( _y ) - ceres::exp ( abc[0]*T ( _x ) *T ( _x ) + abc[1]*T ( _x ) + abc[2] ); // y-exp(ax^2+bx+c)
        return true;
    }
    const double _x, _y;    // x,y数据
};

int main ( int argc, char** argv )
{
    double a=1.0, b=2.0, c=1.0;         // 真实参数值
    int N=100;                          // 数据点
    double w_sigma=1.0;                 // 噪声Sigma值(根号下方差)
    cv::RNG rng;                        // OpenCV随机数产生器
    double abc[3] = {0.8,2.1,0.9};      // abc参数的估计值 (修改初始值 下面求解迭代过程会不同)

    vector<double> x_data, y_data;      // 数据

    /*生成符合曲线的样本*/
    cout<<"generating data: "<<endl;   //下面是从真实的曲线中取得样本数据
    for ( int i=0; i<N; i++ )
    {
        double x = i/100.0;
        x_data.push_back ( x );
        y_data.push_back (
            exp ( a*x*x + b*x + c ) + rng.gaussian ( w_sigma )
        );
        //cout<<x_data[i]<<" "<<y_data[i]<<endl;//输出生成数据
    }

    // 构建最小二乘问题
    ceres::Problem problem;
    for ( int i=0; i<N; i++ )
    {
        /* 第一个参数 CostFunction* : 描述最小二乘的基本形式即代价函数 例如书上的116页fi(.)的形式
         * 第二个参数 LossFunction* : 描述核函数的形式 例如书上的ρi（.）
         * 第三个参数 double* :       待估计参数（用数组存储）
         * 这里仅仅重载了三个参数的函数，如果上面的double abc[3]改为三个double a=0 ,b=0,c = 0;
         * 此时AddResidualBlock函数的参数除了前面的CostFunction LossFunction 外后面就必须加上三个参数 分别输入&a,&b,&c
         * 那么此时下面的 ceres::AutoDiffCostFunction<>模板参数就变为了 <CURVE_FITTING_COST,1,1,1,1>后面三个1代表有几类未知参数
         * 我们修改为了a b c三个变量，所以这里代表了3类，之后需要在自己写的CURVE_FITTING_COST类中的operator()函数中，
         * 把形式参数变为了const T* const a, const T* const b, const T* const c ,T* residual
         * 上面修改的方法与本例程实际上一样，只不过修改的这种方式显得乱，实际上我们在用的时候，一般都是残差种类有几个，那么后面的分类 就分几类
         * 比如后面讲的重投影误差，此事就分两类 一类是相机9维变量，一类是点的3维变量，然而残差项变为了2维
         *
         * （1）: 修改后的写法（当然自己定义的代价函数要对应修改重载函数的形式参数，对应修改内部的残差的计算）：
         *      ceres::CostFunction* cost_function
         *              = new ceres::AutoDiffCostFunction<CURVE_FITTING_COST, 1, 1 ,1 ,1>(
         *                  new CURVE_FITTING_COST ( x_data[i], y_data[i] ) );
         *      problem.AddResidualBlock(cost_function,nullptr,&a,&b,&c);
         * 修改后的代价函数的计算模型:
         *   struct CURVE_FITTING_COST
         *   {
         *       CURVE_FITTING_COST ( double x, double y ) : _x ( x ), _y ( y ) {}
         *       // 残差的计算
         *       template <typename T>
         *       bool operator() (
         *          const T* const a,
         *          const T* const b,
         *          const T* const c,
         *          T* residual   ) const     // 残差
         *       {
         *           residual[0] = T ( _y ) - ceres::exp ( a[0]*T ( _x ) *T ( _x ) + b[0]*T ( _x ) + c[0] ); // y-exp(ax^2+bx+c)
         *           return true;
         *       }
         *       const double _x, _y;    // x,y数据
         *   };//代价类结束
         *
         *
         * （2）: 本例程下面的语句通常拆开来写(看起来方便些):
         * ceres::CostFunction* cost_function
         *              = new ceres::AutoDiffCostFunction<CURVE_FITTING_COST, 1, 3>(
         *                  new CURVE_FITTING_COST ( x_data[i], y_data[i] ) );
         * problem.AddResidualBlock(cost_function,nullptr,abc)
         * */
        problem.AddResidualBlock (     // 向问题中添加误差项
        // 使用自动求导，模板参数：误差类型，Dimension of residual(输出维度 表示有几类残差，本例程中就一类残差项目，所以为1)，输入维度，维数要与前面struct中一致
                /*这里1 代表*/
            new ceres::AutoDiffCostFunction<CURVE_FITTING_COST, 1, 3> ( 
                new CURVE_FITTING_COST ( x_data[i], y_data[i] )// x_data[i], y_data[i] 代表输入的获得的试验数据
            ),
            nullptr,            // 核函数，这里不使用，为空  这里是LossFunction的位置
            abc                 // 待估计参数3维
        );
    }

    // 配置求解器ceres::Solver (是一个非线性最小二乘的求解器)
    ceres::Solver::Options options;     // 这里有很多配置项可以填Options类嵌入在Solver类中 ，在Options类中可以设置关于求解器的参数
    options.linear_solver_type = ceres::DENSE_QR;  // 增量方程如何求解 这里的linear_solver_type 是一个Linear_solver_type的枚举类型的变量
    options.minimizer_progress_to_stdout = true;   // 为真时 内部错误输出到cout，我们可以看到错误的地方，默认情况下，会输出到日志文件中保存

    ceres::Solver::Summary summary;                // 优化信息
    chrono::steady_clock::time_point t1 = chrono::steady_clock::now();//记录求解时间间隔
    //cout<<endl<<"求解前....."<<endl;
    /*下面函数需要3个参数：
     * 1、 const Solver::Options& options <----> optione
     * 2、 Problem* problem               <----> &problem
     * 3、 Solver::Summary* summary       <----> &summart (即使默认的参数也需要定义该变量 )
     * 这个函数会输出一些迭代的信息。
     * */
    ceres::Solve ( options, &problem, &summary );  // 开始优化
    //cout<<endl<<"求解后....."<<endl;
    chrono::steady_clock::time_point t2 = chrono::steady_clock::now();
    chrono::duration<double> time_used = chrono::duration_cast<chrono::duration<double>>( t2-t1 );
    cout<<"solve time cost = "<<time_used.count()<<" seconds. "<<endl;

    // 输出结果
    // BriefReport() : A brief one line description of the state of the solver after termination.
    cout<<summary.BriefReport() <<endl;
    cout<<"estimated a,b,c = ";
    /*auto a:abc  或者下面的方式都可以*/
    for ( auto &a:abc ) cout<<a<<" ";
    cout<<endl;

    return 0;
}