User:Sharan.nyn/GSoC18/Report

Project Report : Check Command and Overlaps Tool

• The work done for the project can be split into the following parts:

libanalyze function -- analyze_overlaps and libged command -- check_overlaps

 NOTE: This was later replaced with better code, check it out here

• The main goal behind adding a check_overlaps command was that libged's rtcheck command acted as a wrapper for the rtcheck program, and ran the rtcheck program with execvp command -- this was not desired as the execution was done in a different process.
• I added the check_overlaps command which had the same options as rtcheck command and the logic behind shooting of rays was done in libanalyze.
• The overlaps were processed on libged side with callback functions.
• The submitted patches were committed by Daniel --
  • r70995 r71008 r71402
  • r71050 -- this was later reverted by me (r71059)
• I was given commit access to the repo :) and I did the following commits:
  • r71063 r71065 r71066 r71067 r71103 r71108
• Documentation work related to check_overlaps -- #497

rtcheck based on libanalyze's analyze_overlaps function

 NOTE: This was later replaced with better code, check it out here

• Since the logic for shooting the rays was in libanalyze function analyze_overlaps.
• My next task was to refactor rtcheck program to use analyze_overlaps.
• #495 was submitted.

libanalyze function for grid generation

• Function that sets the ray starting point and ray directions in a grid form was added.
• This helped reduce the parameters passed to analyze_overlaps -- all grid related functions and data was passed in two variables.
• The following commits were done -
  • r71117 r71118 r71160
• Later triple grid support and refining was added -
  • r71200 r71201 r71204

overlaps tool based on check.sh

• One of the main goals of the project was to remove the need of the check.sh because it was a bash script it meant it didn’t work for windows system.
• The same functionality was added with help of a .tcl file.
• The following commits were done -
  • r71106 r71107 r71149 r71150
• How it looked: overlaps_tool.gif

• I started to work on better object selection to make it like the prototype image I created during the application period (image)
• The following commits were done -
  • r71151 r71152 r71153 r71154 r71155
• Better object selection: better_object_sel.gif
• Final image:

• 

• Documentation was done -- r71498

new libanalyze API and check command that uses this API

• The goal behind this task was to combine the geometry analysis tools -- rtcheck, gqa and glint into one command.
• A libanalyze API was discussed that contained the backend logic of these commands in one place.
• The check command has sub-commands for - overlaps, mass, volume, surface area, gaps, adjacent air, exposed air and unconfined air.
• This task involved many commits. For list of commits please refer to week 10 - week 12 in my daily log available here -Log

• Since I added a better command for checking overlaps (check overlaps [options]). I removed the old check_overlaps and analyze_overlaps function.
• And adapted the code for the new check overlaps command. For commits refer to week 13's log - Week-13

• I also wrote some bash scripts to compare the outputs of check vs rtcheck/gqa -- r71355
• Documentation and man page for check command was added - r71374 r71393

rtcheck and gqa based on the libanalyze API

• Since the backend logic of gqa and rtcheck lives in libanalyze/api.c. The duplicated code in gqa and rtcheck can be removed.
• rtcheck and gqa were changed to use the libanalyze functions.
• work related to rtcheck and gqa can be found in the public Google Drive Folder linked below

Files

This public Google Drive folder contains all the files which I worked on almost exclusively during the coding period -

• saran_narayan-gsoc18-brlcad

Logs

• Daily Logs
• The log also contains links to all my commits and patches.