/*
-----------------------------------------------------------------------
Copyright: 2010-2015, iMinds-Vision Lab, University of Antwerp
2014-2015, CWI, Amsterdam
Contact: astra@uantwerpen.be
Website: http://sf.net/projects/astra-toolbox
This file is part of the ASTRA Toolbox.
The ASTRA Toolbox is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.
The ASTRA Toolbox is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.
You should have received a copy of the GNU General Public License
along with the ASTRA Toolbox. If not, see .
-----------------------------------------------------------------------
$Id$
*/
/** \file mexHelpFunctions.cpp
*
* \brief Contains some functions for interfacing matlab with c data structures
*/
#include "mexHelpFunctions.h"
#include "astra/SparseMatrixProjectionGeometry2D.h"
#include "astra/FanFlatVecProjectionGeometry2D.h"
#include "astra/AstraObjectManager.h"
using namespace std;
using namespace astra;
//-----------------------------------------------------------------------------------------
// get string from matlab
std::string mex_util_get_string(const mxArray* pInput)
{
if (!mxIsChar(pInput)) {
return "";
}
mwSize iLength = mxGetNumberOfElements(pInput) + 1;
char* buf = new char[iLength];
mxGetString(pInput, buf, iLength);
std::string res = std::string(buf);
delete[] buf;
return res;
}
//-----------------------------------------------------------------------------------------
// is option
bool isOption(std::list lOptions, std::string sOption)
{
return std::find(lOptions.begin(), lOptions.end(), sOption) != lOptions.end();
}
//-----------------------------------------------------------------------------------------
// turn a matlab struct into a c++ map
std::map parseStruct(const mxArray* pInput)
{
std::map res;
// check type
if (!mxIsStruct(pInput)) {
mexErrMsgTxt("Input must be a struct.");
return res;
}
// get field names
int nfields = mxGetNumberOfFields(pInput);
for (int i = 0; i < nfields; i++) {
std::string sFieldName = std::string(mxGetFieldNameByNumber(pInput, i));
res[sFieldName] = mxGetFieldByNumber(pInput,0,i);
}
return res;
}
//-----------------------------------------------------------------------------------------
// turn a c++ map into a matlab struct
mxArray* buildStruct(std::map mInput)
{
mwSize dims[2] = {1, 1};
mxArray* res = mxCreateStructArray(2,dims,0,0);
for (std::map::iterator it = mInput.begin(); it != mInput.end(); it++) {
mxAddField(res, (*it).first.c_str());
mxSetField(res, 0, (*it).first.c_str(), (*it).second);
}
return res;
}
//-----------------------------------------------------------------------------------------
// parse projection geometry data
astra::CProjectionGeometry2D* parseProjectionGeometryStruct(const mxArray* prhs)
{
// parse struct
std::map mStruct = parseStruct(prhs);
// create projection geometry object
string type = mex_util_get_string(mStruct["type"]);
if (type == "parallel") {
// detector_width
float32 fDetWidth = 1.0f;
mxArray* tmp = mStruct["detector_width"];
if (tmp != NULL) {
fDetWidth = (float32)(mxGetScalar(tmp));
}
// detector_count
int iDetCount = 100;
tmp = mStruct["detector_count"];
if (tmp != NULL) {
iDetCount = (int)(mxGetScalar(tmp));
}
// angles
float32* pfAngles;
int iAngleCount;
tmp = mStruct["projection_angles"];
if (tmp != NULL) {
double* angleValues = mxGetPr(tmp);
iAngleCount = mxGetN(tmp) * mxGetM(tmp);
pfAngles = new float32[iAngleCount];
for (int i = 0; i < iAngleCount; i++) {
pfAngles[i] = angleValues[i];
}
} else {
mexErrMsgTxt("'angles' not specified, error.");
return NULL;
}
// create projection geometry
return new astra::CParallelProjectionGeometry2D(iAngleCount, // number of projections
iDetCount, // number of detectors
fDetWidth, // width of the detectors
pfAngles); // angles array
}
else if (type == "fanflat") {
// detector_width
float32 fDetWidth = 1.0f;
mxArray* tmp = mStruct["detector_width"];
if (tmp != NULL) {
fDetWidth = (float32)(mxGetScalar(tmp));
}
// detector_count
int iDetCount = 100;
tmp = mStruct["detector_count"];
if (tmp != NULL) {
iDetCount = (int)(mxGetScalar(tmp));
}
// angles
float32* pfAngles;
int iAngleCount;
tmp = mStruct["projection_angles"];
if (tmp != NULL) {
double* angleValues = mxGetPr(tmp);
iAngleCount = mxGetN(tmp) * mxGetM(tmp);
pfAngles = new float32[iAngleCount];
for (int i = 0; i < iAngleCount; i++) {
pfAngles[i] = angleValues[i];
}
} else {
mexErrMsgTxt("'angles' not specified, error.");
return NULL;
}
// origin_source_dist
int iDistOriginSource = 100;
tmp = mStruct["origin_source_dist"];
if (tmp != NULL) {
iDistOriginSource = (int)(mxGetScalar(tmp));
}
// origin_det_dist
int iDistOriginDet = 100;
tmp = mStruct["origin_det_dist"];
if (tmp != NULL) {
iDistOriginDet = (int)(mxGetScalar(tmp));
}
// create projection geometry
return new astra::CFanFlatProjectionGeometry2D(iAngleCount, // number of projections
iDetCount, // number of detectors
fDetWidth, // width of the detectors
pfAngles, // angles array
iDistOriginSource, // distance origin source
iDistOriginDet); // distance origin detector
}
else {
mexPrintf("Only parallel and fanflat projection geometry implemented.");
return NULL;
}
}
//-----------------------------------------------------------------------------------------
// create projection geometry data
mxArray* createProjectionGeometryStruct(astra::CProjectionGeometry2D* _pProjGeom)
{
// temporary map to store the data for the MATLAB struct
std::map mGeometryInfo;
// detectorCount
mGeometryInfo["DetectorCount"] = mxCreateDoubleScalar(_pProjGeom->getDetectorCount());
if (!_pProjGeom->isOfType("fanflat_vec")) {
// detectorWidth
mGeometryInfo["DetectorWidth"] = mxCreateDoubleScalar(_pProjGeom->getDetectorWidth());
// pfProjectionAngles
mxArray* pAngles = mxCreateDoubleMatrix(1, _pProjGeom->getProjectionAngleCount(), mxREAL);
double* out = mxGetPr(pAngles);
for (int i = 0; i < _pProjGeom->getProjectionAngleCount(); i++) {
out[i] = _pProjGeom->getProjectionAngle(i);
}
mGeometryInfo["ProjectionAngles"] = pAngles;
}
else {
astra::CFanFlatVecProjectionGeometry2D* pVecGeom = dynamic_cast(_pProjGeom);
mxArray* pVectors = mxCreateDoubleMatrix(1, pVecGeom->getProjectionAngleCount()*6, mxREAL);
double* out = mxGetPr(pVectors);
int iDetCount = pVecGeom->getDetectorCount();
for (int i = 0; i < pVecGeom->getProjectionAngleCount(); i++) {
const SFanProjection* p = &pVecGeom->getProjectionVectors()[i];
out[6*i + 0] = p->fSrcX;
out[6*i + 1] = p->fSrcY;
out[6*i + 2] = p->fDetSX + 0.5f*iDetCount*p->fDetUX;
out[6*i + 3] = p->fDetSY + 0.5f*iDetCount*p->fDetUY;
out[6*i + 4] = p->fDetUX;
out[6*i + 5] = p->fDetUY;
}
mGeometryInfo["Vectors"] = pVectors;
}
// parallel specific options
if (_pProjGeom->isOfType("parallel")) {
// type
mGeometryInfo["type"] = mxCreateString("parallel");
}
// fanflat specific options
else if (_pProjGeom->isOfType("fanflat")) {
astra::CFanFlatProjectionGeometry2D* pFanFlatGeom = dynamic_cast(_pProjGeom);
// detectorCount
mGeometryInfo["DistanceOriginSource"] = mxCreateDoubleScalar(pFanFlatGeom->getOriginSourceDistance());
// detectorWidth
mGeometryInfo["DistanceOriginDetector"] = mxCreateDoubleScalar(pFanFlatGeom->getOriginDetectorDistance());
// type
mGeometryInfo["type"] = mxCreateString("fanflat");
}
else if (_pProjGeom->isOfType("sparse_matrix")) {
astra::CSparseMatrixProjectionGeometry2D* pSparseMatrixGeom = dynamic_cast(_pProjGeom);
mGeometryInfo["type"] = mxCreateString("sparse_matrix");
mGeometryInfo["MatrixID"] = mxCreateDoubleScalar(CMatrixManager::getSingleton().getIndex(pSparseMatrixGeom->getMatrix()));
}
else if(_pProjGeom->isOfType("fanflat_vec")) {
mGeometryInfo["type"] = mxCreateString("fanflat_vec");
}
// build and return the MATLAB struct
return buildStruct(mGeometryInfo);
}
//-----------------------------------------------------------------------------------------
// parse reconstruction geometry data
astra::CVolumeGeometry2D* parseVolumeGeometryStruct(const mxArray* prhs)
{
// parse struct
std::map mStruct = parseStruct(prhs);
std::map mOptions = parseStruct(mStruct["option"]);
// GridColCount
int iWindowColCount = 128;
mxArray* tmp = mStruct["GridColCount"];
if (tmp != NULL) {
iWindowColCount = (int)(mxGetScalar(tmp));
}
// GridRowCount
int iWindowRowCount = 128;
tmp = mStruct["GridRowCount"];
if (tmp != NULL) {
iWindowRowCount = (int)(mxGetScalar(tmp));
}
// WindowMinX
float32 fWindowMinX = - iWindowColCount / 2;
tmp = mOptions["WindowMinX"];
if (tmp != NULL) {
fWindowMinX = (float32)(mxGetScalar(tmp));
}
// WindowMaxX
float32 fWindowMaxX = iWindowColCount / 2;
tmp = mOptions["WindowMaxX"];
if (tmp != NULL) {
fWindowMaxX = (float32)(mxGetScalar(tmp));
}
// WindowMinY
float32 fWindowMinY = - iWindowRowCount / 2;
tmp = mOptions["WindowMinY"];
if (tmp != NULL) {
fWindowMinY = (float32)(mxGetScalar(tmp));
}
// WindowMaxX
float32 fWindowMaxY = iWindowRowCount / 2;
tmp = mOptions["WindowMaxY"];
if (tmp != NULL) {
fWindowMaxY = (float32)(mxGetScalar(tmp));
}
// create and return reconstruction geometry
return new astra::CVolumeGeometry2D(iWindowColCount, iWindowRowCount,
fWindowMinX, fWindowMinY,
fWindowMaxX, fWindowMaxY);
}
//-----------------------------------------------------------------------------------------
// create 2D volume geometry struct
mxArray* createVolumeGeometryStruct(astra::CVolumeGeometry2D* _pVolGeom)
{
std::map mGeometryInfo;
mGeometryInfo["GridColCount"] = mxCreateDoubleScalar(_pVolGeom->getGridColCount());
mGeometryInfo["GridRowCount"] = mxCreateDoubleScalar(_pVolGeom->getGridRowCount());
std::map mGeometryOptions;
mGeometryOptions["WindowMinX"] = mxCreateDoubleScalar(_pVolGeom->getWindowMinX());
mGeometryOptions["WindowMaxX"] = mxCreateDoubleScalar(_pVolGeom->getWindowMaxX());
mGeometryOptions["WindowMinY"] = mxCreateDoubleScalar(_pVolGeom->getWindowMinY());
mGeometryOptions["WindowMaxY"] = mxCreateDoubleScalar(_pVolGeom->getWindowMaxY());
mGeometryInfo["option"] = buildStruct(mGeometryOptions);
return buildStruct(mGeometryInfo);
}
//-----------------------------------------------------------------------------------------
// create 3D volume geometry struct
mxArray* createVolumeGeometryStruct(astra::CVolumeGeometry3D* _pVolGeom)
{
std::map mGeometryInfo;
mGeometryInfo["GridColCount"] = mxCreateDoubleScalar(_pVolGeom->getGridColCount());
mGeometryInfo["GridRowCount"] = mxCreateDoubleScalar(_pVolGeom->getGridRowCount());
mGeometryInfo["GridSliceCount"] = mxCreateDoubleScalar(_pVolGeom->getGridRowCount());
std::map mGeometryOptions;
mGeometryOptions["WindowMinX"] = mxCreateDoubleScalar(_pVolGeom->getWindowMinX());
mGeometryOptions["WindowMaxX"] = mxCreateDoubleScalar(_pVolGeom->getWindowMaxX());
mGeometryOptions["WindowMinY"] = mxCreateDoubleScalar(_pVolGeom->getWindowMinY());
mGeometryOptions["WindowMaxY"] = mxCreateDoubleScalar(_pVolGeom->getWindowMaxY());
mGeometryOptions["WindowMinZ"] = mxCreateDoubleScalar(_pVolGeom->getWindowMinZ());
mGeometryOptions["WindowMaxZ"] = mxCreateDoubleScalar(_pVolGeom->getWindowMaxZ());
mGeometryInfo["option"] = buildStruct(mGeometryOptions);
return buildStruct(mGeometryInfo);
}
//-----------------------------------------------------------------------------------------
string matlab2string(const mxArray* pField)
{
// is string?
if (mxIsChar(pField)) {
return mex_util_get_string(pField);
}
// is scalar?
if (mxIsNumeric(pField) && mxGetM(pField)*mxGetN(pField) == 1) {
return boost::lexical_cast(mxGetScalar(pField));
}
return "";
}
//-----------------------------------------------------------------------------------------
// Options struct to xml node
bool readOptions(XMLNode* node, const mxArray* pOptionStruct)
{
// loop all fields
int nfields = mxGetNumberOfFields(pOptionStruct);
for (int i = 0; i < nfields; i++) {
std::string sFieldName = std::string(mxGetFieldNameByNumber(pOptionStruct, i));
const mxArray* pField = mxGetFieldByNumber(pOptionStruct, 0, i);
if (node->hasOption(sFieldName)) {
mexErrMsgTxt("Duplicate option");
return false;
}
// string or scalar
if (mxIsChar(pField) || mex_is_scalar(pField)) {
string sValue = matlab2string(pField);
node->addOption(sFieldName, sValue);
} else
// numerical array
if (mxIsNumeric(pField) && mxGetM(pField)*mxGetN(pField) > 1) {
if (!mxIsDouble(pField)) {
mexErrMsgTxt("Numeric input must be double.");
return false;
}
XMLNode* listbase = node->addChildNode("Option");
listbase->addAttribute("key", sFieldName);
listbase->addAttribute("listsize", mxGetM(pField)*mxGetN(pField));
double* pdValues = mxGetPr(pField);
int index = 0;
for (unsigned int row = 0; row < mxGetM(pField); row++) {
for (unsigned int col = 0; col < mxGetN(pField); col++) {
XMLNode* item = listbase->addChildNode("ListItem");
item->addAttribute("index", index);
item->addAttribute("value", pdValues[col*mxGetM(pField)+row]);
index++;
delete item;
}
}
delete listbase;
} else {
mexErrMsgTxt("Unsupported option type");
return false;
}
}
return true;
}
//-----------------------------------------------------------------------------------------
// struct to xml node
bool readStruct(XMLNode* root, const mxArray* pStruct)
{
// loop all fields
int nfields = mxGetNumberOfFields(pStruct);
for (int i = 0; i < nfields; i++) {
// field and fieldname
std::string sFieldName = std::string(mxGetFieldNameByNumber(pStruct, i));
const mxArray* pField = mxGetFieldByNumber(pStruct, 0, i);
// string
if (mxIsChar(pField)) {
string sValue = matlab2string(pField);
if (sFieldName == "type") {
root->addAttribute("type", sValue);
} else {
delete root->addChildNode(sFieldName, sValue);
}
}
// scalar
if (mex_is_scalar(pField)) {
string sValue = matlab2string(pField);
delete root->addChildNode(sFieldName, sValue);
}
// numerical array
if (mxIsNumeric(pField) && mxGetM(pField)*mxGetN(pField) > 1) {
if (!mxIsDouble(pField)) {
mexErrMsgTxt("Numeric input must be double.");
return false;
}
XMLNode* listbase = root->addChildNode(sFieldName);
listbase->addAttribute("listsize", mxGetM(pField)*mxGetN(pField));
double* pdValues = mxGetPr(pField);
int index = 0;
for (unsigned int row = 0; row < mxGetM(pField); row++) {
for (unsigned int col = 0; col < mxGetN(pField); col++) {
XMLNode* item = listbase->addChildNode("ListItem");
item->addAttribute("index", index);
item->addAttribute("value", pdValues[col*mxGetM(pField)+row]);
index++;
delete item;
}
}
delete listbase;
}
// not castable to a single string
if (mxIsStruct(pField)) {
if (sFieldName == "options" || sFieldName == "option" || sFieldName == "Options" || sFieldName == "Option") {
bool ret = readOptions(root, pField);
if (!ret)
return false;
} else {
XMLNode* newNode = root->addChildNode(sFieldName);
bool ret = readStruct(newNode, pField);
delete newNode;
if (!ret)
return false;
}
}
}
return true;
}
//-----------------------------------------------------------------------------------------
// turn a MATLAB struct into an XML Document
XMLDocument* struct2XML(string rootname, const mxArray* pStruct)
{
if (!mxIsStruct(pStruct)) {
mexErrMsgTxt("Input must be a struct.");
return NULL;
}
// create the document
XMLDocument* doc = XMLDocument::createDocument(rootname);
XMLNode* rootnode = doc->getRootNode();
// read the struct
bool ret = readStruct(rootnode, pStruct);
//doc->getRootNode()->print();
delete rootnode;
if (!ret) {
delete doc;
doc = 0;
}
return doc;
}
//-----------------------------------------------------------------------------------------
// turn an std vector object to an mxArray
mxArray* vectorToMxArray(std::vector mInput)
{
mxArray* res = mxCreateDoubleMatrix(1, mInput.size(), mxREAL);
double* pdData = mxGetPr(res);
for (unsigned int i = 0; i < mInput.size(); i++) {
pdData[i] = mInput[i];
}
return res;
}
//-----------------------------------------------------------------------------------------
// turn a vector> object to an mxArray
mxArray* vector2DToMxArray(std::vector > mInput)
{
unsigned int sizex = mInput.size();
if (sizex == 0) return mxCreateString("empty");
unsigned int sizey = mInput[0].size();
mxArray* res = mxCreateDoubleMatrix(sizex, sizey, mxREAL);
double* pdData = mxGetPr(res);
for (unsigned int i = 0; i < sizex; i++) {
for (unsigned int j = 0; j < sizey && j < mInput[i].size(); j++) {
pdData[j*sizex+i] = mInput[i][j];
}
}
return res;
}
//-----------------------------------------------------------------------------------------
// turn a boost::any object to an mxArray
mxArray* anyToMxArray(boost::any _any)
{
if (_any.type() == typeid(std::string)) {
std::string str = boost::any_cast(_any);
return mxCreateString(str.c_str());
}
if (_any.type() == typeid(int)) {
return mxCreateDoubleScalar(boost::any_cast(_any));
}
if (_any.type() == typeid(float32)) {
return mxCreateDoubleScalar(boost::any_cast(_any));
}
if (_any.type() == typeid(std::vector)) {
return vectorToMxArray(boost::any_cast >(_any));
}
if (_any.type() == typeid(std::vector >)) {
return vector2DToMxArray(boost::any_cast > >(_any));
}
return NULL;
}
//-----------------------------------------------------------------------------------------
// return true ig the argument is a scalar
bool mex_is_scalar(const mxArray* pInput)
{
return (mxIsNumeric(pInput) && mxGetM(pInput)*mxGetN(pInput) == 1);
}
//-----------------------------------------------------------------------------------------
mxArray* XML2struct(astra::XMLDocument* xml)
{
XMLNode* node = xml->getRootNode();
mxArray* str = XMLNode2struct(xml->getRootNode());
delete node;
return str;
}
//-----------------------------------------------------------------------------------------
mxArray* XMLNode2struct(astra::XMLNode* node)
{
std::map mList;
// type_attribute
if (node->hasAttribute("type")) {
mList["type"] = mxCreateString(node->getAttribute("type").c_str());
}
list nodes = node->getNodes();
for (list::iterator it = nodes.begin(); it != nodes.end(); it++) {
XMLNode* subnode = (*it);
// list
if (subnode->hasAttribute("listsize")) {
cout << "lkmdsqldqsjkl" << endl;
cout << " " << node->getContentNumericalArray().size() << endl;
mList[subnode->getName()] = vectorToMxArray(node->getContentNumericalArray());
}
// string
else {
mList[subnode->getName()] = mxCreateString(subnode->getContent().c_str());
}
delete subnode;
}
return buildStruct(mList);
}
void get3DMatrixDims(const mxArray* x, mwSize *dims)
{
const mwSize* mdims = mxGetDimensions(x);
mwSize dimCount = mxGetNumberOfDimensions(x);
if (dimCount == 1) {
dims[0] = mdims[0];
dims[1] = 1;
dims[2] = 1;
} else if (dimCount == 2) {
dims[0] = mdims[0];
dims[1] = mdims[1];
dims[2] = 1;
} else if (dimCount == 3) {
dims[0] = mdims[0];
dims[1] = mdims[1];
dims[2] = mdims[2];
} else {
dims[0] = 0;
dims[1] = 0;
dims[2] = 0;
}
}