trackImplicitPolynomialSurfaceToOFF.cpp File Reference

#include <iostream>
#include "DGtal/helpers/StdDefs.h"
#include "DGtal/topology/helpers/Surfaces.h"
#include "DGtal/topology/DigitalSurface.h"
#include "DGtal/topology/SetOfSurfels.h"
#include "DGtal/math/MPolynomial.h"
#include "DGtal/shapes/GaussDigitizer.h"
#include "DGtal/shapes/implicit/ImplicitPolynomial3Shape.h"
#include "DGtal/shapes/implicit/ImplicitFunctionDiff1LinearCellEmbedder.h"
#include "DGtal/io/readers/MPolynomialReader.h"

Go to the source code of this file.

Functions
void	usage (int, char **argv)
int	main (int argc, char **argv)

Detailed Description

This program is free software: you can redistribute it and/or modify it under the terms of the GNU Lesser General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This program 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 this program. If not, see http://www.gnu.org/licenses/.

Author

Jacques-Olivier Lachaud (jacqu.nosp@m.es-o.nosp@m.livie.nosp@m.r.la.nosp@m.chaud.nosp@m.@uni.nosp@m.v-sav.nosp@m.oie..nosp@m.fr ) Laboratory of Mathematics (CNRS, UMR 5127), University of Savoie, France

Date

2012/02/06

A simple marching cube algorithm based on digital surfaces.

This file is part of the DGtal library.

Definition in file trackImplicitPolynomialSurfaceToOFF.cpp.

Function Documentation

main()

int main	(	int	argc,
		char **	argv
	)

[trackImplicitPolynomialSurfaceToOFF-makeSurface]

[trackImplicitPolynomialSurfaceToOFF-makeSurface]

[trackImplicitPolynomialSurfaceToOFF-KSpace]

[trackImplicitPolynomialSurfaceToOFF-KSpace]

[trackImplicitPolynomialSurfaceToOFF-SurfelAdjacency]

[trackImplicitPolynomialSurfaceToOFF-SurfelAdjacency]

[trackImplicitPolynomialSurfaceToOFF-ExtractingSurface]

[trackImplicitPolynomialSurfaceToOFF-ExtractingSurface]

[trackImplicitPolynomialSurfaceToOFF-makingOFF]

[trackImplicitPolynomialSurfaceToOFF-makingOFF]

Definition at line 88 of file trackImplicitPolynomialSurfaceToOFF.cpp.

{
  if ( argc < 9 )
    {
      usage( argc, argv );
      return 1;
    }
  double p1[ 3 ];
  double p2[ 3 ];
  for ( unsigned int i = 0; i < 3; ++i )
    {
      p1[ i ] = atof( argv[ 2+i ] );
      p2[ i ] = atof( argv[ 5+i ] );
    }
  double step = atof( argv[ 8 ] );
 
  trace.beginBlock( "Making polynomial surface." );
  typedef Space::RealPoint RealPoint;
  typedef RealPoint::Coordinate Ring;
  typedef MPolynomial<3, Ring> Polynomial3;
  typedef MPolynomialReader<3, Ring> Polynomial3Reader;
  typedef ImplicitPolynomial3Shape<Space> ImplicitShape;
  typedef GaussDigitizer<Space,ImplicitShape> DigitalShape; 
  typedef DigitalShape::PointEmbedder DigitalEmbedder;
 
  // See http://www.freigeist.cc/gallery.html
  Polynomial3 P;
  Polynomial3Reader reader;
  std::string poly_str = argv[ 1 ];
  std::string::const_iterator iter 
    = reader.read( P, poly_str.begin(), poly_str.end() );
  if ( iter != poly_str.end() )
    {
      std::cerr << "ERROR: I read only <" 
                << poly_str.substr( 0, iter - poly_str.begin() )
                << ">, and I built P=" << P << std::endl;
      return 1;
    }
  // Durchblick x3y+xz3+y3z+z3+5z = 0
 
    //   MPolynomial<3, double> P = mmonomial<double>( 3, 1, 0 )
    // + mmonomial<double>( 1, 0, 3 )
    // + mmonomial<double>( 0, 3, 1 )
    // + mmonomial<double>( 0, 0, 3 )
    // + 5 * mmonomial<double>( 0, 0, 1 );
  // Crixxi (y2+z2-1)2 +(x2+y2-1)3 = 0
  // developed = y4 +2y2z2+z4-2z2 -y2 + x6+3x4y2+3x2y4+y6-3x4-6x2y2-3y4+3x2
  // MPolynomial<3, double> P = mmonomial<double>(0,4,0)
  //   + 2 * mmonomial<double>(0,2,2)
  //   + mmonomial<double>(0,2,0)
  //   + mmonomial<double>(0,0,4)
  //   - 2 * mmonomial<double>(0,0,2)
  //   + mmonomial<double>(6,0,0)
  //   + 3 * mmonomial<double>(4,2,0)
  //   + 3 * mmonomial<double>(2,4,0)
  //   + mmonomial<double>(0,6,0)
  //   - 3 * mmonomial<double>(4,0,0)
  //   - 6 * mmonomial<double>(2,2,0)
  //   - 3 * mmonomial<double>(0,4,0)
  //   + 3 * mmonomial<double>(2,0,0);
  
  trace.info() << "P( X_0, X_1, X_2 ) = " << P << std::endl;
  ImplicitShape ishape( P );
  DigitalShape dshape;
  dshape.attach( ishape );
  dshape.init( RealPoint( p1 ), RealPoint( p2 ), step );
  Domain domain = dshape.getDomain();
  trace.endBlock();
 
  // Construct the Khalimsky space from the image domain
  KSpace K;
  // NB: it is \b necessary to work with a \b closed cellular space
  // since umbrellas use separators and pivots, which must exist for
  // arbitrary surfels.
  bool space_ok = K.init( domain.lowerBound(), 
                          domain.upperBound(), true // necessary
                          );
  if (!space_ok)
    {
      trace.error() << "Error in the Khamisky space construction."<<std::endl;
      return 2;
    }
 
  typedef SurfelAdjacency<KSpace::dimension> MySurfelAdjacency;
  MySurfelAdjacency surfAdj( true ); // interior in all directions.
 
  trace.beginBlock( "Extracting boundary by tracking the space. " );
  typedef KSpace::Surfel Surfel;
  typedef KSpace::SurfelSet SurfelSet;
  typedef SetOfSurfels< KSpace, SurfelSet > MySetOfSurfels;
  typedef DigitalSurface< MySetOfSurfels > MyDigitalSurface;
 
  // The surfels are tracked from an initial surfel, which is found by
  // try/error.
  MySetOfSurfels theSetOfSurfels( K, surfAdj );
  Surfel bel = Surfaces<KSpace>::findABel( K, dshape, 100000 );
  Surfaces<KSpace>::trackBoundary( theSetOfSurfels.surfelSet(),
                                   K, surfAdj, 
                                   dshape, bel );
  trace.endBlock();
 
  trace.beginBlock( "Making OFF surface <marching-cube.off>. " );
  MyDigitalSurface digSurf( theSetOfSurfels );
  trace.info() << "Digital surface has " << digSurf.size() << " surfels."
               << std::endl;
  // The cell embedder is used to place vertices closer to the set
  // P(x,y,z)=0
  typedef 
    ImplicitFunctionDiff1LinearCellEmbedder< KSpace, 
                                             ImplicitShape, 
                                             DigitalEmbedder >
    CellEmbedder;
  CellEmbedder cellEmbedder;
  cellEmbedder.init( K, ishape, dshape.pointEmbedder() );
  ofstream out( "marching-cube.off" );
  if ( out.good() )
    digSurf.exportEmbeddedSurfaceAs3DOFF( out, cellEmbedder );
  out.close();
  trace.endBlock();
  trace.beginBlock( "Making NOFF surface <marching-cube.noff>. " );
  ofstream out2( "marching-cube.noff" );
  if ( out2.good() )
    digSurf.exportEmbeddedSurfaceAs3DNOFF( out2, cellEmbedder );
  out2.close();
  trace.endBlock();
 
  return 0;
}

References DGtal::GaussDigitizer< TSpace, TEuclideanShape >::attach(), DGtal::Trace::beginBlock(), domain, DGtal::Trace::endBlock(), DGtal::Trace::error(), DGtal::DigitalSurface< TDigitalSurfaceContainer >::exportEmbeddedSurfaceAs3DNOFF(), DGtal::DigitalSurface< TDigitalSurfaceContainer >::exportEmbeddedSurfaceAs3DOFF(), DGtal::Surfaces< TKSpace >::findABel(), DGtal::GaussDigitizer< TSpace, TEuclideanShape >::getDomain(), DGtal::Trace::info(), DGtal::KhalimskySpaceND< dim, TInteger >::init(), DGtal::GaussDigitizer< TSpace, TEuclideanShape >::init(), DGtal::RegularPointEmbedder< TSpace >::init(), K, DGtal::HyperRectDomain< TSpace >::lowerBound(), DGtal::GaussDigitizer< TSpace, TEuclideanShape >::pointEmbedder(), DGtal::MPolynomialReader< n, TRing, TAlloc, TIterator >::read(), DGtal::DigitalSurface< TDigitalSurfaceContainer >::size(), DGtal::trace, DGtal::Surfaces< TKSpace >::trackBoundary(), and DGtal::HyperRectDomain< TSpace >::upperBound().

usage()

void usage	(	int	,
		char **	argv
	)

Definition at line 78 of file trackImplicitPolynomialSurfaceToOFF.cpp.

{
  std::cerr << "Usage: " << argv[ 0 ] << " <Polynomial> <Px> <Py> <Pz> <Qx> <Qy> <Qz> <step>" << std::endl;
  std::cerr << "\t - displays the boundary of a shape defined implicitly by a 3-polynomial <Polynomial>." << std::endl;
  std::cerr << "\t - P and Q defines the bounding box." << std::endl;
  std::cerr << "\t - step is the grid step." << std::endl;
  std::cerr << "\t - You may try x^3y+xz^3+y^3z+z^3+5z or (y^2+z^2-1)^2 +(x^2+y^2-1)^3 " << std::endl;
  std::cerr << "\t - See http://www.freigeist.cc/gallery.html" << std::endl;
}