sgsellan/solid-geometry-processing-on-deconstructed-domains

Public code release for the paper "Solid Geometry Processing on Deconstructed Domains" presented at SGP 2019 and authored by Silvia Sellán, Herng Yi Cheng, Yuming Ma, Mitchell Dembowski and Alec Jacobson.

Solid Geometry Processing on Deconstructed Domains

Public code release for the paper "Solid Geometry Processing on Deconstructed Domains", presented at SGP 2019 and authored by Silvia Sellán, Herng Yi Cheng, Yuming Ma, Mitchell Dembowski and Alec Jacobson. Released under MIT licence.

Installation

To install this library in MacOS, please start by cloning the repository recursively

git clone --recursive https://github.com/sgsellan/solid-geometry-processing-on-deconstructed-domains.git

After this, we will build the mex functions in the gptoolbox directory:

cd solid-geometry-processing-on-deconstructed-domains/gptoolbox/mex
mkdir build
cd build
cmake ..
make

Some functions also depend on triangle, which you can dowload and install.

Use

To replicate the results in the paper, start by adding include-matlab and gptoolbox to your Matlab path, for example using addpath(genpath('include-matlab'));addpath(genpath('gptoolbox''));. Once this is done, you can replicate each result in our paper by running each of the scripts in the scripts directory. The first commented line in each of them specifies by number which figure of the paper it corresponds to. The convergence tests in Figures 8 and 10 can be replicated by running the scripts in scripts/convergence-tests.

If you want to use our method on your own example meshes and equations for comparisons or applications, you can take a look at our example.m file and substitute with your own code.

Known Issues

Please do not hesitate to contact [email protected] if you find any issues or bugs in this code, or you struggle to run it in any way.

Graphics Replicability Stamp Initiative

We, the authors, hereby give permission to the reproducibility committee and reviewers to review the code and advertise the review publicly after the stamp is approved.

solid-geometry-processing-on-deconstructed-domains's Issues

Error from annulus.m when running example.m

Hello, while trying to run example.m, I get the following error, and providing a valid flag with [VA,FA] = annulus(200,1.2,'R',2,'Flags',{'-q30'}); doesn't seem to fix it. Much appreciated if there is a fix!

Error using triangle (line 223)
flag provided but not defined: -p

     ▲ TRIANGLE

     Version:

  -bg string
    	Background color (specified as hex value)
  -blur int
    	Blur radius (default 4)
  -c int
    	Number of files to process concurrently (default 12)
  -gray
    	Output in grayscale mode
  -in string
    	Source image (default "-")
  -noise int
    	Noise factor
  -out string
    	Destination image (default "-")
  -pts int
    	Maximum number of points (default 2500)
  -sobel int
    	Sobel filter threshold (default 10)
  -solid
    	Use solid stroke color (yes/no)
  -stroke float
    	Stroke width (default 1)
  -th int
    	Points threshold (default 20)
  -web
    	Open the SVG file in the web browser
  -wf int
    	Wireframe mode (0: without stroke, 1: with stroke, 2: stroke only)


Error in annulus (line 49)
  [V,F] = triangle([Vr;VR],[Er;size(Vr,1)+ER],[0 0],'Flags',flags);

Error in example (line 18)
[VA,FA] = annulus(200,1.2,'R',2);