Difference between revisions of "Deuces"

From BRL-CAD
(71 intermediate revisions by 16 users not shown)
Line 1: Line 1:
This is a list of succinct tasks that are expected to take most people less than two hours to complete.  It's a great starting point for anyone interested in contributing to BRL-CAD.
+
This is a list of succinct tasks that are expected to take most people familiar with the prerequisites less than two hours to complete.  It's a great starting point for anyone interested in contributing to BRL-CAD.
  
 
The tasks are all roughly the same complexity with '''''no prior BRL-CAD experience expected'''''.  A description is provided along with a list of references and files you'll probably need to edit.  Can we make it any easier?
 
The tasks are all roughly the same complexity with '''''no prior BRL-CAD experience expected'''''.  A description is provided along with a list of references and files you'll probably need to edit.  Can we make it any easier?
Line 5: Line 5:
 
= Getting Started =
 
= Getting Started =
  
Please do contact us (via [[IRC]] or [[Mailing_Lists|brlcad-devel mailing list]]) if you have any questions, corrections, comments, or ideas of your own that you'd like to suggest.
+
Contact us (via [[IRC]] or [[Mailing_Lists|brlcad-devel mailing list]]) if you have questions, comments, or ideas of your own you'd like to suggest.
  
We've made a really awesome virtual disk image that has everything you need included, preconfigured, and ready to be edited.  Here's what you do:
+
We've made an awesome virtual disk image that has everything you need preconfigured and ready to go:
# [https://sourceforge.net/projects/brlcad/files/BRL-CAD%20for%20Virtual%20Machines/ Download our image]
+
 
# [https://www.virtualbox.org/wiki/Downloads Download and run VirtualBox]
+
# [https://sourceforge.net/projects/brlcad/files/BRL-CAD%20for%20Virtual%20Machines/ Download our BRL-CAD Virtual Machine (VM) disk image.]
# Run "'''svn up brlcad.svn'''" and get started [[Compiling|compiling]]!
+
# [https://www.virtualbox.org/wiki/Downloads Install VirtualBox.]
 +
# Import and start the VM, log in (the password is "Brlcad!" without the quotes).
 +
# Run "svn up brlcad-svn-trunk" and get started!
 +
 
 +
=Pick a Task=
 +
 
 +
We break down all tasks into one of five categories.  Don't be worried if the tasks all sound confusing to you.  Just pick one and start reading the references we've provided.  Join IRC or our mailing list and ask questions.
 +
 
 +
# Code (programming)
 +
# Documentation and Training (writing)
 +
# Outreach and Research (graphics)
 +
# Quality Assurance (testing)
 +
# User Interface (designing)
  
 
__TOC__
 
__TOC__
Line 16: Line 28:
 
----
 
----
  
= Code =
+
== Code ==
 
----
 
----
 
''Tasks related to writing or refactoring code''
 
''Tasks related to writing or refactoring code''
  
All of the code tasks require making changes to BRL-CAD's source code.  You will be expected to [[Patches|provide a patch file]] of all changes.  Make sure you ''read'' your patch file before submitting it.  Make sure your patch file will apply cleanly to an unmodified checkout of BRL-CAD:
+
See the When You're Done section above for details on submitting your changes.
 
 
svn co https://brlcad.svn.sourceforge.net/svnroot/brlcad/brlcad/trunk brlcad.edit
 
cd brlcad.edit
 
# make changes
 
svn diff > ~/my.patch
 
# read ~/my.patch file with text editor
 
cd ..
 
svn co https://brlcad.svn.sourceforge.net/svnroot/brlcad/brlcad/trunk brlcad.fresh
 
cd brlcad.fresh
 
patch -p0 < ~/my.patch
 
# submit your patch file to our patches tracker
 
&nbsp;
 
 
 
{| style="background-color:#666666;" cellpadding="20" cellspacing="0" border="2" width="100%"
 
|
 
== Move comments from source to header files ==
 
BRL-CAD uses Doxygen source code comments to document the API.  The comments need to be '''''moved''''' from .c source code files to the corresponding .h API header file.  Note that this is a REALLY easy task, it is just cut-and-paste after all, so it just might take you more than a couple hours if you're inefficient with a text editor.  Regardless, you ''must'' make sure you compile before and after to make sure you didn't introduce a typo because you're changing so many files.
 
 
 
This is a collection of tasks.  Each task involves editing source code to move comments and verifying compilation wasn't broken in the process.  See each entry below for details.
 
 
 
{| style="background-color:#222222;" cellpadding="20" cellspacing="0" border="2" width="100%"
 
|
 
=== ... move LIBBN comments ===
 
There are less than 150 API comments across 17 files in LIBBN that need to be moved.  This will find most of them:
 
grep -n -r -E '^/\*\*$' src/libbn | grep -v svn | grep -v '\*\*\*' | grep -v '@'
 
 
 
ONLY move comments on functions that have a corresponding BN_EXPORT declaration in the include/bn.h header.  It should take less than 30 seconds to review each one.
 
 
 
Code:
 
* include/bn.h
 
* src/libbn/*.c
 
 
 
|}
 
&nbsp;
 
{| style="background-color:#222222;" cellpadding="20" cellspacing="0" border="2" width="100%"
 
|
 
=== ... move LIBRT comments for files beginning with the letter 'd' ===
 
 
 
There are approximately 143 public API comments in LIBRT files starting with a 'd' (e.g., src/librt/db_tree.c) that need to be moved.  This will find most of them:
 
grep -n -r -E '^/\*\*' src/librt | grep -v svn | grep -v '\*\*\*' | grep -v '@' |grep 'librt/d'
 
 
 
ONLY move comments on functions that have a corresponding RT_EXPORT declaration in the include/raytrace.h header.  It should take less than 30 seconds to review each one.
 
 
 
Code:
 
* include/raytrace.h
 
* include/db.h
 
* include/db5.h
 
* src/librt/d*.c
 
 
 
|}
 
&nbsp;
 
{| style="background-color:#222222;" cellpadding="20" cellspacing="0" border="2" width="100%"
 
|
 
=== ... move LIBRT comments for files beginning with a-c and e-o ===
 
 
 
There are approximately 150 public API comments in LIBRT files starting with 'a', 'b', 'c', (notice we skip 'd' files) 'e', 'f', ... 'n', and 'o'.  This will find most of them:
 
grep -n -r -E '^/\*\*' src/librt | grep -v svn | grep -v '\*\*\*' | grep -v '@' |grep 'librt/[abcefghijklmno]'
 
 
 
ONLY move comments on functions that have a corresponding RT_EXPORT declaration in the include/raytrace.h header.  It should take less than 30 seconds to review each one.
 
 
 
Code:
 
* include/raytrace.h
 
* include/db.h
 
* include/db5.h
 
* src/librt/[abcefghijklmno]*.c
 
* src/librt/comb/*.c
 
* src/librt/binunif/*.c
 
 
 
|}
 
&nbsp;
 
{| style="background-color:#222222;" cellpadding="20" cellspacing="0" border="2" width="100%"
 
|
 
=== ... move LIBRT comments for files beginning with 'q' through 'z' ===
 
 
 
There are approximately 106 public API comments in LIBRT files starting with 'q' through the letter 'z'  This will find most of them:
 
grep -n -r -E '^/\*\*' src/librt | grep -v svn | grep -v '\*\*\*' | grep -v '@' |grep 'librt/[q-z]'
 
 
 
ONLY move comments on functions that have a corresponding RT_EXPORT declaration in the include/raytrace.h header.  It should take less than 30 seconds to review each one.
 
 
 
Code:
 
* include/raytrace.h
 
* include/db.h
 
* include/db5.h
 
* src/librt/[q-z]*.c
 
 
 
|}
 
&nbsp;
 
{| style="background-color:#222222;" cellpadding="20" cellspacing="0" border="2" width="100%"
 
|
 
=== ... move LIBWDB comments ===
 
 
 
There are approximately 60 public API comments in LIBWDB files.  This will find most of them:
 
grep -n -r -E '^/\*\*' src/libwdb | grep -v svn | grep -v '\*\*\*' | grep -v '@'
 
 
 
ONLY move comments that have a corresponding WDB_EXPORT declaration in the include/wdb.h header AND stub in placeholder /** */ comments for any declarations in the header still lacking a comment block.  ALSO, remove any 'F U N C T I O N' names that are spaced out from the comments.
 
 
 
Code:
 
* include/wdb.h
 
* src/libwdb/*.c
 
|}
 
  
|}
 
 
&nbsp;
 
&nbsp;
{| style="background-color:#666666;" cellpadding="20" cellspacing="0" border="2" width="100%"
+
{| style="background-color:#ffffff;" cellpadding="20" cellspacing="0" border="2" width="100%"
 
|
 
|
== Implement runtime detection of SSE ==
+
=== Fix bounding box function for our polygonal mesh (BoT) primitive ===
 
 
BRL-CAD will optionally leverage SSE instructions for some operations but SSE-support is set at compile-time.  If you attempt to perform SSE instructions on non-SSE hardware, it'll basically halt the application with an illegal instruction exception.  That's a fancy way of saying it crashes.
 
 
 
This task involves implementing a function (that will go into our LIBBU utility library) to reports whether SSE support is available at runtime.  The most prevalent method for doing this is demonstrated by the Mesa folks where you set up an exception handler for SIGILL and attempt an SSE instruction.  That's obviously a non-solution for Windows platforms, but is better than nothing and more useful than a Windows-only solution.  Even better if you can handle both or implement a cross-platform solution.  You'll implement a bu_sse_init() function that returns an error if SSE is not available at runtime.
 
 
 
Code:
 
* include/bu.h
 
* src/libbu/sse.c
 
|}
 
 
 
&nbsp;
 
{| style="background-color:#666666;" cellpadding="20" cellspacing="0" border="2" width="100%"
 
|
 
== Fix bounding box function for our polygonal mesh (BoT) primitive ==
 
  
 
BRL-CAD provides functions for its geometric primitives that define a bounding box - a box that completely encloses the volume described by the primitive.  Ideally, these boxes are as small as possible while still enclosing the primitive.  Currently the routine for BoTs is incorrect.  You can use stl-g, obj-g, or any of our other *-g converters to import BoT geometry for testing.  
 
BRL-CAD provides functions for its geometric primitives that define a bounding box - a box that completely encloses the volume described by the primitive.  Ideally, these boxes are as small as possible while still enclosing the primitive.  Currently the routine for BoTs is incorrect.  You can use stl-g, obj-g, or any of our other *-g converters to import BoT geometry for testing.  
Line 151: Line 48:
 
|}
 
|}
 
&nbsp;
 
&nbsp;
{| style="background-color:#666666;" cellpadding="20" cellspacing="0" border="2" width="100%"
 
|
 
== Make mged 'tables' command not call system() ==
 
 
BRL-CAD's geometry editor (MGED) provides hundreds of functions that users can call on the command line.  One of our oldest commands writes data out to text files and calls the unix "sort" command to sort a list of items..  That's really bad.
 
 
This task involves replacing the three calls to system() with a call to quicksort() or any other simple in-memory sorting mechanism.
 
 
Code:
 
* src/libged/tables.c
 
 
|}
 
&nbsp;
 
{| style="background-color:#666666;" cellpadding="20" cellspacing="0" border="2" width="100%"
 
|
 
== Separate LIBNURBS files into one class per file ==
 
 
BRL-CAD has a recently implemented a new library that isn't very well organized.  The files for that library are a haphazard collection of classes and functions.  It's a bit of a mess.
 
 
This task involves making sure there is no more than one struct or class per source file.  Class/struct declarations should be in header files.  Class/struct method and functions should be in source files.  Headers should be fully self-sufficient and include proper #ifdef wrappers (see include/*.h for examples).  Make sure new files are named to match their enclosing class/struct.  Be sure to update the CMakeLists.txt build file too and test compilation.
 
 
Code:
 
* src/libnurbs/*
 
 
|}
 
&nbsp;
 
{| style="background-color:#666666;" cellpadding="20" cellspacing="0" border="2" width="100%"
 
|
 
 
== Implement mutex locking for Windows ==
 
 
BRL-CAD implements support for running in parallel on computers with multiple CPUs or cores.  However, there are lots of ways to run in parallel.  BRL-CAD runs on Windows, but presently only in a single-threaded mode.  To make it work in parallel, we need to define how threads acquire a mutex lock.
 
 
This task involves implementing the necessary logic to acquire and release a mutex or semaphore on Windows.  You can use either, but probably want to call CreateMutex().  This requires a ''very'' minor source code modification to just one file, but make sure it works with a simple test program.  Make your test program call bu_semaphore_init()+bu_semaphore_acquire()+bu_semahpore_release(), see include/bu.h for API docs.
 
 
References:
 
* http://msdn.microsoft.com/en-us/library/windows/desktop/ms686927(v=vs.85).aspx
 
* http://msdn.microsoft.com/en-us/library/windows/desktop/ms686946(v=vs.85).aspx
 
* Mark Walmsley: "Multi-Threaded Programming in C++", Springer, 2000 (although it has C++ in its title the basic functionality there is pure C)
 
* include/bu.h
 
 
Code:
 
* src/libbu/semaphore.c
 
 
|}
 
&nbsp;
 
{| style="background-color:#666666;" cellpadding="20" cellspacing="0" border="2" width="100%"
 
|
 
== Implement thread creation for Windows ==
 
 
BRL-CAD implements support for running in parallel on computers with multiple CPUs or cores.  However, there are lots of ways to run in parallel.  BRL-CAD runs on Windows, but presently only in a single-threaded mode.  To make it work in parallel, we need to define how threads are created.
 
 
This task involves implementing the necessary logic to create a new thread in bu_parallel().  This requires a ''very''  minor source code modification to just one file, but make sure it works with a simple test program.  Make your program call bu_parallel(), see include/bu.h for API docs.
 
 
References:
 
* http://msdn.microsoft.com/en-us/library/windows/desktop/ms682453(v=vs.85).aspx
 
* Mark Walmsley: "Multi-Threaded Programming in C++", Springer, 2000 (although it has C++ in its title the basic functionality there is pure C)
 
* include/bu.h
 
 
Code:
 
* src/libbu/parallel.c
 
 
|}
 
&nbsp;
 
{| style="background-color:#666666;" cellpadding="20" cellspacing="0" border="2" width="100%"
 
|
 
== Decouple LIBDM from LIBGED ==
 
 
BRL-CAD has a 3D display manager library (LIBDM) and a geometry editor command library (LIBGED).  For clean encapsulation and library management, it's desirable to keep library dependencies to a minimum.  LIBGED presently makes direct calls to LIBDM for a "screengrab" command.  Properly fixed, it should be possible to remove the LIBDM linkage from LIBGED's build file and the command still work as expected.
 
 
This task involves breaking the dependency of LIBGED on LIBDM by making LIBGED not directly call any LIBDM functions.  To do this, LIBGED will need to introduce a callback mechanism in the "ged" struct so that the screengrab command can capture an image without directly calling a LIBDM function.  This task is a little tricky, so you'll need to be somewhat proficient with C if you want any chance of completing this within a couple hours.
 
 
Code:
 
* include/ged.h
 
* include/dm.h
 
* src/libged/screengrab.h
 
* src/libged/CMakeLists.txt
 
 
|}
 
&nbsp;
 
{| style="background-color:#666666;" cellpadding="20" cellspacing="0" border="2" width="100%"
 
|
 
== Implement a function to convert triangle meshes to solid polygon mesh ==
 
 
BRL-CAD implements numerous "primitive" 3D entity types.  The Bag of Triangle (BoT) primitive implements simple triangle mesh geometry.  Our N-manifold geometry (NMG) primitive implements solid polygonal mesh geometry.  While we have a routine that converts an NMG to a BoT (mk_bot_from_nmg()), we do not have the reverse (mk_nmg_from_bot()).
 
 
This task implements the missing mk_nmg_from_bot() function so that the input triangle mesh is converted into the NMG data structures and stitched together appropriately.
 
 
References:
 
* src/librt/primitives/nmg
 
* src/librt/primitives/bot
 
 
Code:
 
* src/libwdb/nmg.c
 
 
|}
 
 
&nbsp;
 
&nbsp;
{| style="background-color:#666666;" cellpadding="20" cellspacing="0" border="2" width="100%"
+
{| style="background-color:#ffffff;" cellpadding="20" cellspacing="0" border="2" width="100%"
 
|
 
|
== Close MGED when both windows are closed ==
+
=== Close MGED when both windows are closed ===
  
 
BRL-CAD has an interactive geometry editor called MGED.  It's often the starting point for beginners and allows creation and manipulation of models using commands.  When ''mged'' is run, it creates 2 windows:  a text-console command window and an interactive graphics window.  When the user closes one of those windows, there is a bug.  Closing the graphics window closes the command window.
 
BRL-CAD has an interactive geometry editor called MGED.  It's often the starting point for beginners and allows creation and manipulation of models using commands.  When ''mged'' is run, it creates 2 windows:  a text-console command window and an interactive graphics window.  When the user closes one of those windows, there is a bug.  Closing the graphics window closes the command window.
Line 262: Line 63:
 
|}
 
|}
 
&nbsp;
 
&nbsp;
{| style="background-color:#666666;" cellpadding="20" cellspacing="0" border="2" width="100%"
 
|
 
== Add MGED key-binding to reopen the command window ==
 
 
BRL-CAD has an interactive geometry editor called MGED. It's often the starting point for beginners and allows creation and manipulation of models using commands. When MGED is invoked, it creates 2 windows:  a text-console command window and an interactive graphics window.  If the user closes the text-console command window, they are left with the interactive graphics window.  There is presently no way (correct us if we're wrong) to get the text-console back without restarting mged.  A good way to test this is to run in classic mode and run the 'gui' command:
 
 
sushi:~ morrison$ mged -c test.g
 
BRL-CAD Release 7.22.0  Geometry Editor (MGED)
 
    Fri, 24 Aug 2012 00:02:42 -0400, Compilation 6
 
    morrison@sushi.local:/usr/brlcad/rel-7.22.0
 
 
attach (nu|X|ogl)[nu]? 
 
mged> gui
 
 
This task involves adding some mechanism, perhaps a simple key binding, to the graphics window so that you can get the command window back on-demand.
 
 
Code:
 
* src/mged/mged.c
 
* src/tclscripts/mged/openw.c
 
  
|}
 
  
&nbsp;
+
{| style="background-color:#ffffff;" cellpadding="20" cellspacing="0" border="2" width="100%"
{| style="background-color:#666666;" cellpadding="20" cellspacing="0" border="2" width="100%"
 
 
|
 
|
  
== Implement a primitive surface area function ==
+
=== Implement a primitive centroid function ===
  
 
BRL-CAD provides more than two dozen types of geometry "primitives" such as ellipsoids, boxes, and cones.  Every primitive is described by a collection of callback functions, for example rt_ell_bbox() returns the bounding box dimensions for an ellipsoid.  Wikipedia, Wolfram Mathworld, and various other math sites (and research papers) around the web include the equations for most of our basic primitives while others are a little more tricky to compute.
 
BRL-CAD provides more than two dozen types of geometry "primitives" such as ellipsoids, boxes, and cones.  Every primitive is described by a collection of callback functions, for example rt_ell_bbox() returns the bounding box dimensions for an ellipsoid.  Wikipedia, Wolfram Mathworld, and various other math sites (and research papers) around the web include the equations for most of our basic primitives while others are a little more tricky to compute.
  
This task involves writing a new callback function that takes an rt_db_internal object and calculates the surface area (units are mm^2).  There are numerous examples in our code where we compute surface area for other primitives.  The primitives that do not already have a centroid callback are itemized in following.
+
This task involves writing a new callback function that takes an rt_db_internal object and calculates its centroid (as a point_t 3D point).  There are numerous examples in our code where we compute centroids for other primtiives.  The primitives that do not already have a centroid callback are itemized in following.
  
 
References:
 
References:
* http://en.wikipedia.org/wiki/Surface_area
+
* http://en.wikipedia.org/wiki/Centroid
 
* http://mathworld.wolfram.com/
 
* http://mathworld.wolfram.com/
* http://www.dtic.mil/cgi-bin/GetTRDoc?AD=AD0274936
+
* include/raytrace.h: See ft_centroid callback defined in the rt_functab structure
* include/raytrace.h: See ft_surf_area callback defined in the rt_functab structure
 
 
 
&nbsp;
 
{| style="background-color:#222222;" cellpadding="20" cellspacing="0" border="2" width="100%"
 
|
 
=== ... surface area function for elliptical hyperboloids (EHY) ===
 
  
 
Code:
 
Code:
* src/librt/primitives/ehy/ehy.c
+
* src/librt/primitives/table.c
 
+
* src/librt/primitives/[PRIMITIVE]/[PRIMITIVE].c
|}
 
&nbsp;
 
{| style="background-color:#222222;" cellpadding="20" cellspacing="0" border="2" width="100%"
 
|
 
=== ... surface area function for right hyperbolic cylinders (RHC) ===
 
 
 
Code:
 
* src/librt/primitives/rhc/rhc.c
 
 
 
|}
 
&nbsp;
 
{| style="background-color:#222222;" cellpadding="20" cellspacing="0" border="2" width="100%"
 
|
 
=== ... surface area function for hyperboloids of one sheet (HYP) ===
 
 
 
Code:
 
* src/librt/primitives/hyp/hyp.c
 
 
 
|}
 
&nbsp;
 
{| style="background-color:#222222;" cellpadding="20" cellspacing="0" border="2" width="100%"
 
|
 
=== ... surface area function for polyhedron with 4 to 8 sides (ARB8) ===
 
 
 
Code:
 
* src/librt/primitives/arb8/arb8.c
 
 
 
|}
 
&nbsp;
 
{| style="background-color:#222222;" cellpadding="20" cellspacing="0" border="2" width="100%"
 
|
 
=== ... surface area function for N-faced polysolid (ARBN) ===
 
 
 
Code:
 
* src/librt/primitives/arbn/arbn.c
 
 
 
|}
 
&nbsp;
 
{| style="background-color:#222222;" cellpadding="20" cellspacing="0" border="2" width="100%"
 
|
 
=== ... surface area function for extruded bitmaps (EBM) ===
 
 
 
Code:
 
* src/librt/primitives/ebm/ebm.c
 
 
 
|}
 
&nbsp;
 
{| style="background-color:#222222;" cellpadding="20" cellspacing="0" border="2" width="100%"
 
|
 
=== ... surface area function for gridded volumes (VOL) ===
 
 
 
Code:
 
* src/librt/primitives/vol/vol.c
 
 
 
|}
 
&nbsp;
 
{| style="background-color:#222222;" cellpadding="20" cellspacing="0" border="2" width="100%"
 
|
 
=== ... surface area function for super ellipsoids (SUPERELL) ===
 
 
 
Code:
 
* src/librt/primitives/superell/superell.c
 
 
 
|}
 
&nbsp;
 
{| style="background-color:#222222;" cellpadding="20" cellspacing="0" border="2" width="100%"
 
|
 
=== ... surface area function for polygonal meshes (NMG) ===
 
 
 
Code:
 
* src/librt/primitives/nmg/nmg.c
 
 
 
|}
 
&nbsp;
 
{| style="background-color:#222222;" cellpadding="20" cellspacing="0" border="2" width="100%"
 
|
 
=== ... surface area function for triangle meshes (BOT) ===
 
 
 
Code:
 
* src/librt/primitives/bot/bot.c
 
 
 
|}
 
&nbsp;
 
{| style="background-color:#222222;" cellpadding="20" cellspacing="0" border="2" width="100%"
 
|
 
=== ... surface area function for NURBS objects (BREP) ===
 
 
 
Code:
 
* src/librt/primitives/brep/brep.cpp
 
 
 
|}
 
|}
 
 
 
&nbsp;
 
{| style="background-color:#666666;" cellpadding="20" cellspacing="0" border="2" width="100%"
 
|
 
 
 
== Implement a primitive volume function ==
 
 
 
BRL-CAD provides more than two dozen types of geometry "primitives" such as ellipsoids, boxes, and cones.  Every primitive is described by a collection of callback functions, for example rt_ell_bbox() returns the bounding box dimensions for an ellipsoid.  Wikipedia, Wolfram Mathworld, and various other math sites (and research papers) around the web include the equations for most of our basic primitives while others are a little more difficult to compute.
 
 
 
This task involves writing a new callback function that takes an rt_db_internal object and calculates the volume (units are mm^3).  There are numerous examples in our code where we compute volume for other primitives.  The primitives that do not already have a volume callback are itemized in following.
 
 
 
References:
 
* http://en.wikipedia.org/wiki/Volume
 
* http://mathworld.wolfram.com/
 
* http://www.dtic.mil/cgi-bin/GetTRDoc?AD=AD0274936
 
* include/raytrace.h: See ft_volume callback defined in rt_functab structure
 
 
 
{| style="background-color:#222222;" cellpadding="20" cellspacing="0" border="2" width="100%"
 
|
 
=== ... volume function for right hyperbolic cylinders (RHC) ===
 
 
 
Code:
 
* src/librt/primitives/rhc/rhc.c
 
 
 
|}
 
&nbsp;
 
{| style="background-color:#222222;" cellpadding="20" cellspacing="0" border="2" width="100%"
 
|
 
=== ... volume function for elliptical hyperboloids (EHY) ===
 
 
 
Code:
 
* src/librt/primitives/ehy/ehy.c
 
 
 
|}
 
&nbsp;
 
{| style="background-color:#222222;" cellpadding="20" cellspacing="0" border="2" width="100%"
 
|
 
=== ... volume function for hyperboloids of one sheet (HYP) ===
 
 
 
Code:
 
* src/librt/primitives/hyp/hyp.c
 
 
 
|}
 
&nbsp;
 
{| style="background-color:#222222;" cellpadding="20" cellspacing="0" border="2" width="100%"
 
|
 
=== ... volume function for superellipsoids (SUPERELL) ===
 
 
 
Code:
 
* src/librt/primitives/superell/superell.c
 
 
 
|}
 
&nbsp;
 
{| style="background-color:#222222;" cellpadding="20" cellspacing="0" border="2" width="100%"
 
|
 
=== ... volume function for extruded bitmaps (EBM) ===
 
 
 
Code:
 
* src/librt/primitives/ebm/ebm.c
 
 
 
|}
 
&nbsp;
 
{| style="background-color:#222222;" cellpadding="20" cellspacing="0" border="2" width="100%"
 
|
 
=== ... volume function for gridded volumes (VOL) ===
 
 
 
Code:
 
* src/librt/primitives/vol/vol.c
 
 
 
|}
 
&nbsp;
 
{| style="background-color:#222222;" cellpadding="20" cellspacing="0" border="2" width="100%"
 
|
 
=== ... volume function for triangle meshes (BOT) ===
 
 
 
Code:
 
* src/librt/primitives/bot/bot.c
 
 
 
|}
 
&nbsp;
 
{| style="background-color:#222222;" cellpadding="20" cellspacing="0" border="2" width="100%"
 
|
 
=== ... volume function for solid polygonal meshes (NMG) ===
 
 
 
Code:
 
* src/librt/primitives/nmg/nmg.c
 
  
 
|}
 
|}
 
&nbsp;
 
&nbsp;
{| style="background-color:#222222;" cellpadding="20" cellspacing="0" border="2" width="100%"
 
|
 
=== ... volume function for extruded sketches (EXTRUDE) ===
 
 
Code:
 
* src/librt/primitives/extrude/extrude.c
 
  
|}
 
  
|}
+
{| style="background-color:#ffffff;" cellpadding="20" cellspacing="0" border="2" width="100%"
&nbsp;
 
{| style="background-color:#666666;" cellpadding="20" cellspacing="0" border="2" width="100%"
 
 
|
 
|
  
== Implement a primitive centroid function ==
+
=== Implement a primitive curvature function ===
  
BRL-CAD provides more than two dozen types of geometry "primitives" such as ellipsoids, boxes, and cones.  Every primitive is described by a collection of callback functions, for example rt_ell_bbox() returns the bounding box dimensions for an ellipsoid.  Wikipedia, Wolfram Mathworld, and various other math sites (and research papers) around the web include the equations for most of our basic primitives while others are a little more tricky to compute.
+
BRL-CAD provides more than two dozen types of geometry "primitives" such as ellipsoids, boxes, and cones each described by a collection of callback functions, for example rt_sph_bbox() returns the bounding box dimensions for a sphere.  Wikipedia, Wolfram Mathworld, and various other math sites (and research papers) around the web include the equations for most of our basic primitives while others are a little more tricky to compute.
  
This task involves writing a new callback function that takes an rt_db_internal object and calculates its centroid (as a point_t 3D point).  There are numerous examples in our code where we compute centroids for other primtiives.  The primitives that do not already have a centroid callback are itemized in following.
+
This task involves writing the callback function rt_xxx_curve() that computes the curvature at a given point on the surface of a primitive such as;
 +
* superell
 +
* cline
 +
* extrude
 +
* grip
 +
* metaball
 +
* hrt.   
 +
There are numerous examples in our code where we compute the curvature for other primtives like the ellipsoid, sphere, elliptical parabola, etc.
  
 
References:
 
References:
* http://en.wikipedia.org/wiki/Centroid
+
* http://en.wikipedia.org/wiki/Curvature
 +
* http://en.wikipedia.org/wiki/Radius_of_curvature_(mathematics)
 
* http://mathworld.wolfram.com/
 
* http://mathworld.wolfram.com/
* include/raytrace.h: See ft_centroid callback defined in the rt_functab structure
+
* include/raytrace.h: See the data structure that holds the curvature of a surface at a point (from Line 296) as well as the prototype for ft_curve() callback function defined in the rt_functab structure ( Line 2078).
  
 
Code:
 
Code:
Line 518: Line 113:
 
* src/librt/primitives/[PRIMITIVE]/[PRIMITIVE].c
 
* src/librt/primitives/[PRIMITIVE]/[PRIMITIVE].c
  
{| style="background-color:#222222;" cellpadding="20" cellspacing="0" border="2" width="100%"
 
|
 
=== ... centroid function for elliptical hyperboloids (EHY) ===
 
 
|}
 
|}
 
&nbsp;
 
&nbsp;
{| style="background-color:#222222;" cellpadding="20" cellspacing="0" border="2" width="100%"
 
|
 
=== ... centroid function for right hyperbolic cylinders (RHC) ===
 
|}
 
&nbsp;
 
{| style="background-color:#222222;" cellpadding="20" cellspacing="0" border="2" width="100%"
 
|
 
=== ... centroid function for hyperboloids of one sheet (HYP) ===
 
|}
 
&nbsp;
 
{| style="background-color:#222222;" cellpadding="20" cellspacing="0" border="2" width="100%"
 
|
 
=== ... centroid function for polyhedron with 4 to 8 sides (ARB8) ===
 
|}
 
&nbsp;
 
{| style="background-color:#222222;" cellpadding="20" cellspacing="0" border="2" width="100%"
 
|
 
=== ... centroid function for extruded bitmaps (EBM) ===
 
|}
 
&nbsp;
 
{| style="background-color:#222222;" cellpadding="20" cellspacing="0" border="2" width="100%"
 
|
 
=== ... centroid function for gridded volumes (VOL) ===
 
|}
 
&nbsp;
 
{| style="background-color:#222222;" cellpadding="20" cellspacing="0" border="2" width="100%"
 
|
 
=== ... centroid function for N-faced polysolids (ARBN) ===
 
|}
 
&nbsp;
 
{| style="background-color:#222222;" cellpadding="20" cellspacing="0" border="2" width="100%"
 
|
 
=== ... centroid function for extruded sketches (EXTRUDE) ===
 
|}
 
&nbsp;
 
{| style="background-color:#222222;" cellpadding="20" cellspacing="0" border="2" width="100%"
 
|
 
=== ... centroid function for superellipsoids (SUPERELL) ===
 
|}
 
&nbsp;
 
{| style="background-color:#222222;" cellpadding="20" cellspacing="0" border="2" width="100%"
 
|
 
=== ... centroid function for solid polygonal meshes (NMG) ===
 
|}
 
|}
 
  
&nbsp;
+
 
{| style="background-color:#666666;" cellpadding="20" cellspacing="0" border="2" width="100%"
+
{| style="background-color:#ffffff;" cellpadding="20" cellspacing="0" border="2" width="100%"
 
|
 
|
  
== Implement a primitive UV-mapping callback ==
+
=== Implement a primitive UV-mapping callback ===
  
 
BRL-CAD provides more than two dozen types of geometry "primitives" such as ellipsoids, boxes, and cones.  Every primitive is described by a collection of callback functions, for example rt_ell_bbox() returns the bounding box dimensions for an ellipsoid.  One of those functions describes a UV mapping of the object's surface, which is used for things like texture and bump mapping.  An example of this is rt_ell_uv() in the src/librt/primitives/ell/ell.c source file for an ellipsoid.  Several of our more complex primitive types (such as BoT, NMG, and BREP/NURBS) do not presently implement a UV-mapping function leading to unexpected runtime behavior.
 
BRL-CAD provides more than two dozen types of geometry "primitives" such as ellipsoids, boxes, and cones.  Every primitive is described by a collection of callback functions, for example rt_ell_bbox() returns the bounding box dimensions for an ellipsoid.  One of those functions describes a UV mapping of the object's surface, which is used for things like texture and bump mapping.  An example of this is rt_ell_uv() in the src/librt/primitives/ell/ell.c source file for an ellipsoid.  Several of our more complex primitive types (such as BoT, NMG, and BREP/NURBS) do not presently implement a UV-mapping function leading to unexpected runtime behavior.
Line 583: Line 130:
 
* src/librt/primitives/[PRIMITIVE]/[PRIMITIVE].c, read the rt_*_uv() function
 
* src/librt/primitives/[PRIMITIVE]/[PRIMITIVE].c, read the rt_*_uv() function
  
{| style="background-color:#222222;" cellpadding="20" cellspacing="0" border="2" width="100%"
+
{| cellpadding="20" cellspacing="0" border="2" width="100%"
 
|
 
|
=== ... UV-mapping for extruded bitmaps (EBM) ===
+
==== ... UV-mapping for extruded sketches (EXTRUDE) ====
  
 
Code:
 
Code:
* src/librt/primitives/ebm/ebm.c
+
* src/librt/primitives/extrude/extrude.c
 
* src/librt/primitives/table.c
 
* src/librt/primitives/table.c
 
* include/rtgeom.h
 
* include/rtgeom.h
Line 594: Line 141:
 
|}
 
|}
 
&nbsp;
 
&nbsp;
{| style="background-color:#222222;" cellpadding="20" cellspacing="0" border="2" width="100%"
 
|
 
=== ... UV-mapping for extruded sketches (EXTRUDE) ===
 
 
Code:
 
* src/librt/primitives/extrude/extrude.c
 
* src/librt/primitives/table.c
 
* include/rtgeom.h
 
  
 
|}
 
|}
 
&nbsp;
 
&nbsp;
{| style="background-color:#222222;" cellpadding="20" cellspacing="0" border="2" width="100%"
+
&nbsp;
 +
{| style="background-color:#ffffff;" cellpadding="20" cellspacing="0" border="2" width="100%"
 
|
 
|
 +
=== Implement a platform independent re-entrant sort function ===
  
=== ... UV-mapping for gridded volumes (VOL) ===
+
The classic C library qsort() does not support a context parameter. A work around is to store the context information in a static variable. However, this solution is not thread save and may result in unpredictable behavior.
 +
 
 +
There are platform specific sort functions qsort_r() in incompatible versions for BSD and GNU and qsort_s() for MSVC.  Your task is to implement a bu_sort() function for BRL-CAD which is platform independent.
  
 
Code:
 
Code:
* src/librt/primitives/vol/vol.c
+
* src/libbu/sort.c
* src/librt/primitives/table.c
 
* include/rtgeom.h
 
  
 +
The new sort function could look like this:
 +
void bu_sort(genptr_t array, size_t nummemb, size_t sizememb, int (*compare)(const_genptr_t, const_genptr_t, genptr_t), genptr_t context);
 
|}
 
|}
 
&nbsp;
 
&nbsp;
{| style="background-color:#222222;" cellpadding="20" cellspacing="0" border="2" width="100%"
 
|
 
=== ... UV-mapping for N-faced arbitrary polyhedrons (ARBN) ===
 
  
Code:
+
----
* src/librt/primitives/arbn/arbn.c
 
* src/librt/primitives/table.c
 
* include/rtgeom.h
 
  
 
|}
 
|}
 
&nbsp;
 
&nbsp;
{| style="background-color:#222222;" cellpadding="20" cellspacing="0" border="2" width="100%"
+
&nbsp;
 +
{| style="background-color:#ffffff;" cellpadding="20" cellspacing="0" border="2" width="100%"
 
|
 
|
=== ... UV-mapping for superellipsoids (SUPERELL) ===
+
=== Solve fonts related bug in new wiki theme ===
  
Code:
+
BRL-CAD has been working on a new incarnation of the website and has developed a new wiki theme and wordpress theme. Wiki theme uses a font called 'open-sans' from google fonts directory. It's linked via CSS but it does not get loaded (we still see default serif all over the place). So your task will be to debug the CSS code and get Open Sans loaded.
* src/librt/primitives/superell/superell.c
+
 
* src/librt/primitives/table.c
+
Links:
* include/rtgeom.h
+
*http://beta.brlcad.org/wiki/Main_Page
  
|}
 
 
&nbsp;
 
&nbsp;
{| style="background-color:#222222;" cellpadding="20" cellspacing="0" border="2" width="100%"
 
|
 
=== ... UV-mapping for triangle meshes (BOT) ===
 
  
Code:
+
----
* src/librt/primitives/bot/bot.c
 
* src/librt/primitives/table.c
 
* include/rtgeom.h
 
  
 
|}
 
|}
 
&nbsp;
 
&nbsp;
{| style="background-color:#222222;" cellpadding="20" cellspacing="0" border="2" width="100%"
+
&nbsp;
 +
{| style="background-color:#ffffff;" cellpadding="20" cellspacing="0" border="2" width="100%"
 
|
 
|
=== ... UV-mapping for solid polygonal meshes (NMG) ===
+
=== Better placement of icons in wiki theme ===
  
Code:
+
BRL-CAD has been working on a new incarnation of the website and has developed a new wiki theme and wordpress theme. Wiki theme is responsive but has a small styling problem. On smaller screens icons near the search bar gets misplaced and unaligned. Your task would be to fix that. Task would include diving into sass file that corresponds to styling of this part of theme (given below) and adjusting spacing between icons to keep them aligned even at smaller screens.
* src/librt/primitives/nmg/nmg.c
+
 
* src/librt/primitives/table.c
+
Links:
* include/rtgeom.h
+
*http://beta.brlcad.org/wiki/Main_Page
  
|}
+
&nbsp;
|}
 
  
 
----
 
----
 +
|}
  
= Documentation and Training =
+
== Documentation and Training ==
 
----
 
----
 
''Tasks related to creating/editing documents and helping others learn more about BRL-CAD''
 
''Tasks related to creating/editing documents and helping others learn more about BRL-CAD''
  
{| style="background-color:#666666;" cellpadding="20" cellspacing="0" border="2" width="100%"
+
{| style="background-color:#ffffff;" cellpadding="20" cellspacing="0" border="2" width="100%"
 
|
 
|
== Add missing documentation (for any ONE command) ==
+
=== Add missing documentation (for any ONE command) ===
  
 
BRL-CAD is an extensive system with more than 400 commands and more than a million pages of documentation, but there are approximately 120 commands that are entirely undocumented:
 
BRL-CAD is an extensive system with more than 400 commands and more than a million pages of documentation, but there are approximately 120 commands that are entirely undocumented:
Line 683: Line 215:
  
 
|}
 
|}
&nbsp;
 
{| style="background-color:#666666;" cellpadding="20" cellspacing="0" border="2" width="100%"
 
|
 
 
== Write a tutorial on compiling BRL-CAD with XCode on Mac OS X ==
 
 
BRL-CAD uses the CMake build system to generate outputs for a variety of platforms.  It will output Makefiles, Microsoft Visual Studio build files, XCode project files, Eclipse build files and more.
 
 
This task involves generating an XCode project with our build and verifying that it successfully compiles all of BRL-CAD.  Document the process on our wiki as a tutorial.  Include screen shot images when referring to visual actions within XCode.
 
 
References:
 
* http://www.cmake.org/
 
* http://brlcad.org/wiki/
 
 
|}
 
&nbsp;
 
{| style="background-color:#666666;" cellpadding="20" cellspacing="0" border="2" width="100%"
 
|
 
== Write a tutorial on compiling BRL-CAD with Eclipse on Linux ==
 
 
BRL-CAD uses the CMake build system to generate outputs for a variety of platforms.  It will output Makefiles, Microsoft Visual Studio build files, XCode project files, Eclipse build files and more.
 
 
This task involves generating an Eclipse project with our build and verifying that it successfully compiles all of BRL-CAD.  Document the process on our wiki as a tutorial.  Include images/screen shots when referring to visual actions within Eclipse.
 
 
References:
 
* http://www.eclipse.org/
 
* http://cmake.org
 
* http://www.cmake.org/Wiki/Eclipse_CDT4_Generator
 
* http://brlcad.org/wiki/
 
  
|}
 
 
&nbsp;
 
&nbsp;
{| style="background-color:#666666;" cellpadding="20" cellspacing="0" border="2" width="100%"
+
{| style="background-color:#ffffff;" cellpadding="20" cellspacing="0" border="2" width="100%"
 
|
 
|
== Document MGED's 'saveview' command options ==
+
=== Write an article "BRL-CAD for dummies" ===
 
 
BRL-CAD's primary geometry editor (MGED) provides hundreds of commands.  Two of those commands are the savewview and loadview commands that write current view settings out to a text file and read them back in.  The saveview command provides -e -i -l and -o options, but they are not documented.
 
 
 
This task involves writing documentation for those missing options.  Consult the source code to see what they do and add the corresponding sections into our Docbook XML doc just like we do in our other documentation files.  Test compilation to make sure your XML syntax is correct.
 
 
 
References:
 
* src/libged/saveview.c
 
* doc/docbook/system/mann/en/*.xml
 
  
Code:
+
Although BRL-CAD has extensive documentation, still it needs a short and simple document which is particularly built for dummies.
* doc/docbook/system/mann/en/saveview.xml
 
  
|}
+
This task involves writing a article named '''BRL-CAD for dummies'''. This article should start with the installation process, if there is any existing installation guide for dummies, provide a link to it. The main motive of this article to empower dummy to make his/her first model using BRL-CAD. One thing to be kept in mind while writing this article is that this article is mainly concentrated for dummies. So use simple language to an extent and if you need to mention some technical term, first explain that term.
&nbsp;
 
{| style="background-color:#666666;" cellpadding="20" cellspacing="0" border="2" width="100%"
 
|
 
== Write "MGED Interface" reference document==
 
  
BRL-CAD's primary geometry editor is called MGED.  MGED's documentation is extensive but incomplete without a concise 1 or 2 page document that details MGED's interface.  
+
The output of this task can be a pdf, html, doc, odt or any other document file that contains this article. Go through the link provided. Use screenshots and images to make it look attractive so that the reader is not bored.
  
This task involves writing an interface reference document that gives a brief descriptive overview of the key bindings, mouse bindings, and primary GUI elements.  The [http://brlcad.org/w/images/8/8c/Shift_Grips_Quick_Reference_Guide.pdf shift grips reference] should be incorporated, albeit much more concisely and organized.  It should minimally include the command window, the graphics window, the raytrace control panel, the combination editor, the geometry tree view, and overview graphics window key bindings.
+
Reference:
 
 
References:
 
 
* http://brlcad.org/wiki/Documentation
 
* http://brlcad.org/wiki/Documentation
* http://brlcad.org/w/images/c/cf/Introduction_to_MGED.pdf
 
* http://brlcad.org/w/images/8/8c/Shift_Grips_Quick_Reference_Guide.pdf
 
  
Examples:
 
* http://www.tuxmagazine.com/system/files/Touring_The_GIMP.pdf
 
* http://izatxamir.files.wordpress.com/2010/04/visio-2007-quick-reference-1.jpg
 
* http://www.thefloatingfrog.co.uk/wp-content/uploads/2010/03/ColorTheory_Screen_White.jpg
 
* http://wiki.blender.org/uploads/7/7c/BlenderHotkeysEditMode.png
 
* http://blogs.wandisco.com/wp-content/uploads/2012/08/refcard1.png
 
* http://www.thisiscarpentry.com/wp-content/uploads/2009/10/ref-card.jpg
 
* http://code.google.com/p/sketchyphysics2/downloads/detail?name=SketchyPhysics%20-%20Quick%20Reference%20Card%20v2B1.pdf
 
 
|}
 
|}
  
 
&nbsp;
 
&nbsp;
{| style="background-color:#666666;" cellpadding="20" cellspacing="0" border="2" width="100%"
 
|
 
== Convert 43 src/conv man pages to ''valid'' Docbook ==
 
 
BRL-CAD is in the process of converting its documentation in order to enable automatic generation of output in different formats (html, pdf, man) from a single source.  We need to convert our existing UNIX man pages to the Docbook XML format.  There is a [http://www.catb.org/~esr/doclifter/ doclifter conversion tool] available to help automatically convert files, then just a little bit of cleanup is needed.  This will find all of them:
 
 
find src/conv -name \*.1
 
 
The simplest way to confirm the files are successfully converted is to incorporate them into BRL-CAD's build logic (edit CMakeLists.txt) and view the output using brlman and an html viewer.  It is recommended to use the Emacs editor with the nxml mode in order to more easily identify and fix errors, but this is not a requirement.
 
 
This task involves using the doclifter tool to perform a rough conversion to Docbook of all man pages in the '''src/conv''' subdirectory of the BRL-CAD source tree (about 43 files), then performing whatever manual corrections are needed to the autogenerated XML files to make them valid Docbook (some conversions have already been done and can serve as guides).  Add new files to the doc/docbook/system/man1/en directory (via ''svn add''), edit the CMakeLists.txt file in that same directory, verify no errors by [[Compiling|compiling]], and make a [[Patches|patch]].
 
 
References:
 
* doc/docbook/system/
 
* Doclifter conversion tool: http://www.catb.org/~esr/doclifter/
 
* Docbook documentation: http://www.docbook.org/tdg/en/html/docbook.html
 
* Emacs editor: http://www.gnu.org/software/emacs/emacs.html
 
* nxml Emacs mode: http://www.thaiopensource.com/nxml-mode/
 
 
Code:
 
* src/conv/*.1
 
* doc/docbook/system/man1/en/CMakeLists.txt
 
* doc/docbook/system/man1/en/
 
  
|}
+
{| style="background-color:#ffffff;" cellpadding="20" cellspacing="0" border="2" width="100%"
&nbsp;
 
{| style="background-color:#666666;" cellpadding="20" cellspacing="0" border="2" width="100%"
 
 
|
 
|
== Convert 38 src/fb man pages to ''valid'' Docbook ==
+
=== Translate "Contributors Guide To BRL-CAD" To Any Language ===
  
BRL-CAD is in the process of converting its documentation in order to enable automatic generation of output in different formats (html, pdf, man) from a single source.  We need to convert our existing UNIX man pages to the Docbook XML format. There is a [http://www.catb.org/~esr/doclifter/ doclifter conversion tool] available to help automatically convert files, then just a little bit of cleanup is needed. This will find all of them:
+
People interested in improving BRL-CAD sometimes find themselves lost in a sea of information. In all, BRL-CAD has more than a million words of documentation across hundreds of manual pages, dozens of tutorials and examples, hundreds of wiki pages, dozens of technical papers, and other resources. There are literally thousands of features and this can sometimes pose problems.
  
find src/fb -name \*.1
+
In 2013, a team of contributors got to California and worked on an entire book titled "Contributors Guide To BRL-CAD" in just a few days. This great resource needs to be translated to other languages to attract developers from other lingual backgrounds (who don't read English ) to contribute to BRL-CAD.
  
The simplest way to confirm the files are successfully converted is to incorporate them into BRL-CAD's build logic (edit CMakeLists.txt) and view the output using brlman and an html viewer.  It is recommended to use the Emacs editor with the nxml mode in order to more easily identify and fix errors, but this is not a requirement.
+
This task involves translating the chapters/sections of the "Contributors Guide To BRL-CAD" into a language of your choice such as Mandarin, French, Chinese, Spanish, German, Hindi, Arabic, Russian, etc. Chapters/Sections include
  
This task involves using the doclifter tool to perform a rough conversion to Docbook of all man pages in the '''src/fb''' subdirectory of the BRL-CAD source tree (about 38 files), then performing whatever manual corrections are needed to the autogenerated XML files to make them valid Docbook (some conversions have already been done and can serve as guides).  Add new files to the doc/docbook/system/man1/en directory (via ''svn add''), edit the CMakeLists.txt file in that same directory, verify no errors by [[Compiling|compiling]], and make a [[Patches|patch]].
+
* Feature Overview
 +
* Working with our Code
 +
* What code to work on
 +
* How to contribute
 +
* .... (Just to name a few )
  
References:
+
The output of this task can be a pdf, html, doc, odt or any other document file that contains the translated article.Images in the original document (see link in Reference below) should not be changed ! only text should be.
* Current Docbook man pages: http://brlcad.svn.sourceforge.net/viewvc/brlcad/brlcad/trunk/doc/docbook/system/
 
* Docbook documentation: http://www.docbook.org/tdg/en/html/docbook.html
 
* Doclifter conversion tool: http://www.catb.org/~esr/doclifter/
 
* Emacs editor: http://www.gnu.org/software/emacs/emacs.html
 
* nxml Emacs mode: http://www.thaiopensource.com/nxml-mode/
 
  
Code:
+
Reference:
* src/fb/*.1
+
* http://en.flossmanuals.net/_booki/contributors-guide-to-brl-cad/contributors-guide-to-brl-cad.pdf
* doc/docbook/system/man1/en/CMakeLists.txt
 
* doc/docbook/system/man1/en/
 
  
 
|}
 
|}
  
 
&nbsp;
 
&nbsp;
{| style="background-color:#666666;" cellpadding="20" cellspacing="0" border="2" width="100%"
 
|
 
== Convert 24 other man pages to ''valid'' Docbook ==
 
  
BRL-CAD is in the process of converting its documentation in order to enable automatic generation of output in different formats (html, pdf, man) from a single source.  We need to convert our existing UNIX man pages to the Docbook XML format.  There is a [http://www.catb.org/~esr/doclifter/ doclifter conversion tool] available to help automatically convert files, then just a little bit of cleanup is needed.  This will find all of them:
 
  
find src/[glnrt]* -name \*.1
+
{| style="background-color:#ffffff;" cellpadding="20" cellspacing="0" border="2" width="100%"
 +
|
  
The simplest way to confirm the files are successfully converted is to incorporate them into BRL-CAD's build logic (edit CMakeLists.txt) and view the output using brlman and an html viewer.  It is recommended to use the Emacs editor with the nxml mode in order to more easily identify and fix errors, but this is not a requirement.
+
=== Write a "BRL-CAD Commands Quick Reference" document ===
 
 
This task involves using the doclifter tool to perform a rough conversion to Docbook of all man pages in the '''src/gtools''', '''src/lgt''', '''src/nirt''', '''src/remrt''', '''src/rt''', '''src/rttherm''', and '''src/tab''' subdirectories of the BRL-CAD source tree (about 24 files), then performing whatever manual corrections are needed to the autogenerated XML files to make them valid Docbook (some conversions have already been done and can serve as guides).  Add new files to the doc/docbook/system/man1/en directory (via ''svn add''), edit the CMakeLists.txt file in that same directory, verify no errors by [[Compiling|compiling]], and make a [[Patches|patch]].
 
 
 
References:
 
* Current Docbook man pages: http://brlcad.svn.sourceforge.net/viewvc/brlcad/brlcad/trunk/doc/docbook/system/
 
* Docbook documentation: http://www.docbook.org/tdg/en/html/docbook.html
 
* Doclifter conversion tool: http://www.catb.org/~esr/doclifter/
 
* Emacs editor: http://www.gnu.org/software/emacs/emacs.html
 
* nxml Emacs mode: http://www.thaiopensource.com/nxml-mode/
 
 
 
Code:
 
* src/fb/*.1
 
* doc/docbook/system/man1/en/CMakeLists.txt
 
* doc/docbook/system/man1/en/
 
 
 
|}
 
 
 
&nbsp;
 
{| style="background-color:#666666;" cellpadding="20" cellspacing="0" border="2" width="100%"
 
|
 
== Write a "BRL-CAD Commands Quick Reference" document ==
 
  
 
There is already a command quick reference for BRL-CAD's MGED geometry editing tool, but there is not a similar document for BRL-CAD's 400+ command-line commands.
 
There is already a command quick reference for BRL-CAD's MGED geometry editing tool, but there is not a similar document for BRL-CAD's 400+ command-line commands.
Line 849: Line 274:
 
* http://brlcad.org/wiki/Documentation
 
* http://brlcad.org/wiki/Documentation
 
* http://brlcad.org/w/images/5/52/MGED_Quick_Reference_Card.pdf
 
* http://brlcad.org/w/images/5/52/MGED_Quick_Reference_Card.pdf
* http://appletree.or.kr/quick_reference_cards/CVS-Subversion-Git/git-cheat-sheet-large.png
+
* [http://appletree.or.kr/quick_reference_cards/CVS-Subversion-Git/git-cheat-sheet-large.png git example]
* http://www.stdout.org/~winston/latex/latexsheet-0.png
+
* [http://www.stdout.org/~winston/latex/latexsheet-0.png latex example]
* http://img.docstoccdn.com/thumb/orig/524314.png
+
* [http://img.docstoccdn.com/thumb/orig/524314.png another example]
* http://www.inmensia.com/files/pictures/internal/CheatSheetDrupal4.7.png
+
* [http://www.inmensia.com/files/pictures/internal/CheatSheetDrupal4.7.png drupal example]
* http://www.phpmagicbook.com/wp-content/uploads/2010/06/php-reference-card.jpg
+
* [http://www.phpmagicbook.com/wp-content/uploads/2010/06/php-reference-card.jpg php example]
  
 
|}
 
|}
 
&nbsp;
 
&nbsp;
{| style="background-color:#666666;" cellpadding="20" cellspacing="0" border="2" width="100%"
+
{| style="background-color:#ffffff;" cellpadding="20" cellspacing="0" border="2" width="100%"
 
|
 
|
== Doxygen cleanup ==
+
 
 +
=== Doxygen cleanup ===
  
 
BRL-CAD uses Doxygen for most API documentation but the comment blocks are not optimally set up for Doxygen output.
 
BRL-CAD uses Doxygen for most API documentation but the comment blocks are not optimally set up for Doxygen output.
Line 870: Line 296:
 
* http://www.stack.nl/~dimitri/doxygen/
 
* http://www.stack.nl/~dimitri/doxygen/
  
{| style="background-color:#222222;" cellpadding="20" cellspacing="0" border="2" width="100%"
+
{| cellpadding="20" cellspacing="0" border="2" width="100%"
 
|
 
|
=== ... doxygen cleanup for LIBBU ===
+
==== ... doxygen cleanup for LIBBU ====
  
 
There are approximately 300 documented API function calls in LIBBU.
 
There are approximately 300 documented API function calls in LIBBU.
Line 882: Line 308:
  
 
|}
 
|}
&nbsp;
 
{| style="background-color:#222222;" cellpadding="20" cellspacing="0" border="2" width="100%"
 
|
 
=== ... doxygen cleanup for LIBBN ===
 
 
There are approximately 300 documented API function calls in LIBBN.
 
 
Code:
 
* include/bn.h
 
* include/plot3.h
 
* include/vmath.h
 
* src/libbn
 
* misc/Doxyfile
 
  
|}
 
 
&nbsp;
 
&nbsp;
{| style="background-color:#222222;" cellpadding="20" cellspacing="0" border="2" width="100%"
+
{| cellpadding="20" cellspacing="0" border="2" width="100%"
 
|
 
|
=== ... doxygen cleanup for LIBWDB ===
+
==== ... doxygen cleanup for LIBWDB ====
  
 
There are approximately 100 documented API function calls in LIBWDB.  
 
There are approximately 100 documented API function calls in LIBWDB.  
Line 912: Line 324:
 
|}
 
|}
 
&nbsp;
 
&nbsp;
{| style="background-color:#222222;" cellpadding="20" cellspacing="0" border="2" width="100%"
+
{| cellpadding="20" cellspacing="0" border="2" width="100%"
 
|
 
|
=== ... doxygen cleanup for LIBRT ===
+
==== ... doxygen cleanup for LIBRT ====
  
 
There are approximately 1000 documented API function calls in LIBRT.  
 
There are approximately 1000 documented API function calls in LIBRT.  
Line 929: Line 341:
  
 
&nbsp;
 
&nbsp;
{| style="background-color:#666666;" cellpadding="20" cellspacing="0" border="2" width="100%"
+
{| style="background-color:#ffffff;" cellpadding="20" cellspacing="0" border="2" width="100%"
 
|
 
|
== Write a "BRL-CAD Ray Tracing Shaders" tutorial ==
+
=== Write up Wiki page tutorial on our Volumetric Primitive ===
  
BRL-CAD includes numerous shaders that let you specify different optical effects during ray tracing.
+
BRL-CAD provides a couple dozen distinct primitives.  Each primitive is defined by a set of parameters.  Several of the more complex primitives have a wiki page describing them in more detail with an example on how to create them.
  
This task involves writing a brief tutorial that describes what shaders are and how one specifies them for geometryHow shaders are specified is already described in detail in the [http://brlcad.org/w/images/c/cf/Introduction_to_MGED.pdf Introduction to MGED] document.
+
This task involves writing up a page on the VOL primitiveFigure out how to use it (see the "in" command), create an example input data set, and write up a wiki page on exactly what steps are needed similar to our other wiki pages:
  
Code:
+
References:
* src/liboptical/sh_*.c (for available shader names and corresponding options)
+
* http://brlcad.org/wiki/DSP
 +
* http://brlcad.org/wiki/Sketch
 +
* http://brlcad.org/wiki/EBM <-- particularly useful as the data is similar for VOL
  
References:
+
Show how to create a VOL with at least two layers/slices. Include images like the other examples. Put the write-up at http://brlcad.org/wiki/VOL
* http://brlcad.org/w/images/2/2c/Optical_Shaders.pdf
 
* http://brlcad.org/w/images/c/cf/Introduction_to_MGED.pdf
 
  
 
|}
 
|}
 +
 
&nbsp;
 
&nbsp;
{| style="background-color:#666666;" cellpadding="20" cellspacing="0" border="2" width="100%"
+
{| style="background-color:#ffffff;" cellpadding="20" cellspacing="0" border="2" width="100%"
 
|
 
|
== NURBS BibTeX reference file ==
+
=== Write a wiki tutorial on how to create a polygonal mesh (NMG) manually ===
  
BRL-CAD maintains a bibliography file that keeps track of published articles and reports pertaining to BRL-CAD, but it would be useful to have similar files that keep track of other topicsThere are commonly two ways to create and maintain a .bib file.  One way is manually (using any text editor) and the other is using a GUI such as JabRefThe rule of thumb is generally to use the text editor approach when building a .bib file of references that are pre-packaged (such as those often provided by publishers of journal articles) and to use a tool like JabRef when you have to create the entire entry from scratch.
+
BRL-CAD provides a couple dozen distinct primitivesEach primitive is defined by a set of parametersSeveral of the more complex primitives have a wiki page describing them in more detail with an example on how to create them.
  
This task involves creating a NURBS.bib file that documents BRL-CAD's various paper references contained in the bibliographics of the following papers (include these papers and what they reference):
+
This task involves writing up a page on the NMG polygonal mesh primitive. Figure out how to use it (not a simple task, will require some trial and error), create an example input, and write up a wiki page on exactly what steps are needed similar to our other wiki pages:
  
Practical Ray Tracing of Trimmed NURBS Surfaces
+
References:
http://citeseerx.ist.psu.edu/viewdoc/summary?doi=10.1.1.35.7126
+
* http://brlcad.org/wiki/DSP
 +
* http://brlcad.org/wiki/EBM
 +
* http://brlcad.org/wiki/Sketch <-- particularly useful as neither NMG nor sketch are meant to be created manually
 +
 
 +
Note the "facetize" command in mged will convert an existing object into NMG format. The get/put commands should help from there like the sketch tutorial.
  
Direct and Fast Ray Tracing of NURBS Surfaces
+
Show how to create an NMG cube or wedge or similar simple shape.  Include images like the other examples.  Put the write-up at http://brlcad.org/wiki/NMG
http://citeseerx.ist.psu.edu/viewdoc/summary?doi=10.1.1.90.7500
 
  
Watertight Trimmed NURBS
+
|}
http://citeseerx.ist.psu.edu/viewdoc/summary?doi=10.1.1.146.3590
 
  
The best route is probably assembly of pre-existing .bib entries from either the citeseerx website or from the sites of the journal actually publishing the article.
+
&nbsp;
 +
{| style="background-color:#ffffff;" cellpadding="20" cellspacing="0" border="2" width="100%"
 +
|
 +
=== Fix Image Formatting in BRL-CAD's DocBook Documentation (any ONE large document or 4 smaller documents) ===
  
References:
+
The majority of BRL-CAD's documentation is defined as DocBook files, from which other formats (HTML, PDF, man page, etc.) can be generated. PDF files present a particular challenge, and have some very specific requirements to achieve "good" formatting.
* doc/BRL-CAD.bib
 
* http://jabref.sourceforge.net
 
* http://en.wikipedia.org/wiki/BibTeX
 
  
Code:
+
BRL-CAD's DocBook files need to uniformly use a style of image inclusion that is aware of what "role" the image is supposed to serve.  A "basic" image inclusion example looks like this:
* doc/NURBS.bib
 
  
|}
+
  <mediaobject>
 +
    <imageobject>
 +
      <imagedata align="center" fileref="../../lessons/en/images/img.png" format="PNG"/>
 +
    </imageobject>
 +
    <nowiki><caption></nowiki>
 +
      <para>
 +
        Caption goes here.
 +
      </para>
 +
    </caption>
 +
  </mediaobject>
  
----
+
This task involves switching image inclusions that use the above style to something like the following:
  
= Outreach and Research =
+
  <mediaobject>
----
+
    <imageobject role="html">
''Tasks related to community management, outreach/marketing, studying problems, and recommending solutions''
+
      <imagedata align="center" fileref="../../books/en/images/img.png" format="PNG"/>
 +
    </imageobject>
 +
    <imageobject role="fo">
 +
      <imagedata align="center" fileref="../../books/en/images/img.png" format="PNG"/>
 +
    </imageobject>
 +
    <nowiki><caption></nowiki>
 +
      <para>
 +
        Caption goes here.
 +
      </para>
 +
    </caption>
 +
</mediaobject>
 +
 +
The "role" flag to imageobject provides the opportunity to specify different image formatting options when the output is HTML (role="html") or PDF (role="fo").
  
{| style="background-color:#666666;" cellpadding="20" cellspacing="0" border="2" width="100%"
+
The captions should be preserved as above on mediaobjects that have them, but mediaobjects without a caption should also be converted and there is no need to add a caption in such cases.
|
 
== Write solicitation for new website designer ==
 
  
The BRL-CAD website is in need of a design overhaul.
+
Any patch that makes changes to the DocBook sources should result in a successful "make doc" build test.  This won't generate PDF documents, but it will validate the XML files and produce HTML - remember that introducing breakage means the patch won't be accepted.
  
This task involves writing up a brief article soliciting new contributor(s) to work on designing a new websiteThe article needs to be detailed and specific to our particular website requirements (Drupal+Mediawiki+CSS) to ensure the contributor can design the appropriate stylesheet(s), updated graphics, and new layoutProvide a title, an image, a short summary (<200 words), and the detailed write-up (>400 words).
+
Remember, the tasks are simply to do the above conversion for all images in the file or files, not to introduce PDF specific formattingFormatting fixes will be needed, but they are very much "case by case" and will take both additional time and a working Apache FOP installation, as well as knowledge of how to enable PDF generationIf all image inclusions have been converted successfully and a student is interested in actually fixing the formatting, please discuss it with us on IRC or the mailing list.
  
 
References:
 
References:
* http://brlcad.org
+
* doc/docbook/books/en/BRL-CAD_Tutorial_Series-VolumeIII.xml
 +
 
 +
Code:
 +
* doc/docbook
  
 
|}
 
|}
 +
 
&nbsp;
 
&nbsp;
{| style="background-color:#666666;" cellpadding="20" cellspacing="0" border="2" width="100%"
+
{| style="background-color:#ffffff;" cellpadding="20" cellspacing="0" border="2" width="100%"
 
|
 
|
== Model a "B" using BRL-CAD ==
+
=== Make a step by step tutorial for creating BRL-CAD model ===
  
Create an uppercase letter "B"  geometry model using BRL-CAD. You can use the mged or archer geometry editor tools or write a script. The model should be roughly 1000mm tall, about 500mm wide, and about 100mm deep. Create it using CSG or other methods, but it cannot be an imported model, polygonal mesh (BOT, NMG), or extruded bitmap (EBM).
+
BRL-CAD is said to have an expert friendly User Interface so new users mostly have a tough time getting around it's UI and making models. So anything link Django poll app tutorial https://docs.djangoproject.com/en/dev/intro/tutorial01/ would be very helpful.  
  
It should be free of modeling errors (no overlaps, run "rtcheck" to verify).  It should have interesting shader properties set (suggest stack+plastic+texture), default shader will not be accepted.  Provide the .g geometry file and a 1024x1024 rendering at a "ae 35 25" view to show what it looks like.
 
  
References:
 
* Introduction to MGED at http://brlcad.org/wiki/Documentation
 
 
|}
 
|}
  
 
&nbsp;
 
&nbsp;
{| style="background-color:#666666;" cellpadding="20" cellspacing="0" border="2" width="100%"
+
{| style="background-color:#ffffff;" cellpadding="20" cellspacing="0" border="2" width="100%"
 
|
 
|
== Model a "R" using BRL-CAD ==
+
=== Find 5 bugs in OGV ===
  
Create an uppercase letter "R"  geometry model using BRL-CAD. You can use the mged or archer geometry editor tools or write a script. The model should be roughly 1000mm tall, about 500mm wide, and about 100mm deep.  Create it using CSG or other methods, but it cannot be an imported model, polygonal mesh (BOT, NMG), or extruded bitmap (EBM).
+
Online Geometry Viewer is a web based application with which you can see 3D .g models in browser without the use of any plugins. Your task will be to deploy OGV locally and find 5 bugs or errors in it.  
  
It should be free of modeling errors (no overlaps, run "rtcheck" to verify).  It should have interesting shader properties set (suggest stack+plastic+texture), default shader will not be accepted.  Provide the .g geometry file and a 1024x1024 rendering at a "ae 35 25" view to show what it looks like.
+
Links:
 +
https://github.com/BRL-CAD/OGV-meteor/
  
References:
 
* Introduction to MGED at http://brlcad.org/wiki/Documentation
 
 
|}
 
|}
  
 
&nbsp;
 
&nbsp;
{| style="background-color:#666666;" cellpadding="20" cellspacing="0" border="2" width="100%"
+
{| style="background-color:#ffffff;" cellpadding="20" cellspacing="0" border="2" width="100%"
 
|
 
|
== Model a "L" using BRL-CAD ==
 
  
Create an uppercase letter "L"  geometry model using BRL-CAD.  You can use the mged or archer geometry editor tools or write a script.  The model should be roughly 1000mm tall, about 500mm wide, and about 100mm deep.  Create it using CSG or other methods, but it cannot be an imported model, polygonal mesh (BOT, NMG), or extruded bitmap (EBM).
+
=== Find 5 coding guidelines violations in OGV ===
  
It should be free of modeling errors (no overlaps, run "rtcheck" to verify). It should have interesting shader properties set (suggest stack+plastic+texture), default shader will not be accepted. Provide the .g geometry file and a 1024x1024 rendering at a "ae 35 25" view to show what it looks like.
+
Online Geometry Viewer is a web based application with which you can see 3D .g models in browser without the use of any plugins. Your task will be to deploy OGV locally, look into code and see if any coding guidelines are violated.  
 +
 
 +
Links:
 +
https://github.com/BRL-CAD/OGV-meteor/
  
References:
 
* Introduction to MGED at http://brlcad.org/wiki/Documentation
 
 
|}
 
|}
  
 
&nbsp;
 
&nbsp;
{| style="background-color:#666666;" cellpadding="20" cellspacing="0" border="2" width="100%"
+
{| style="background-color:#ffffff;" cellpadding="20" cellspacing="0" border="2" width="100%"
 
|
 
|
== Model a "C" using BRL-CAD ==
+
----
 +
 
 +
==Outreach and Research ==
 +
----
 +
''Tasks related to community management, outreach/marketing, studying problems, and recommending solutions''
  
Create an uppercase letter "C" geometry model using BRL-CAD.  You can use the mged or archer geometry editor tools or write a script.  The model should be roughly 1000mm tall, about 500mm wide, and about 100mm deep.  Create it using CSG or other methods, but it cannot be an imported model, polygonal mesh (BOT, NMG), or extruded bitmap (EBM).
+
&nbsp;
 +
{| style="background-color:#ffffff;" cellpadding="20" cellspacing="0" border="2" width="100%"
 +
|
 +
=== Profile NURBS prep performance ===
  
It should be free of modeling errors (no overlaps, run "rtcheck" to verify)It should have interesting shader properties set (suggest stack+plastic+texture), default shader will not be acceptedProvide the .g geometry file and a 1024x1024 rendering at a "ae 35 25" view to show what it looks like.
+
BRL-CAD implements support for rendering of NURBS representation geometryIf you import a solid 3DM or STEP format model into BRL-CAD, it will import as BREP/NURBS geometryOpening that geometry in BRL-CAD's MGED editor will tell you what objects are available and our 'rt' tool will raytrace it. When geometry is ray traced, it first goes through a "prep" phase and then it starts shooting rays.  Our prep phase is entirely unoptimized so we'd like to know where all the time is presently being spent during prep..
  
References:
+
This task involves importing some NURBS geometry into BRL-CAD and ray tracing that geometry with a profiler watching our prep performance.  Any profiler will do, including gprof, but a performance monitor like oprofile or the Mac "Instruments" application (or Shark) are preferred.
* Introduction to MGED at http://brlcad.org/wiki/Documentation
 
|}
 
  
&nbsp;
+
Learning how to use a profiler is beyond the scope of this task, so it make take you considerably longer to provide us with useful information if you've never run a profiler before.
{| style="background-color:#666666;" cellpadding="20" cellspacing="0" border="2" width="100%"
 
|
 
== Model a "A" using BRL-CAD ==
 
  
Create an uppercase letter "A"  geometry model using BRL-CAD.  You can use the mged or archer geometry editor tools or write a script.  The model should be roughly 1000mm tall, about 500mm wide, and about 100mm deep.  Create it using CSG or other methods, but it cannot be an imported model, polygonal mesh (BOT, NMG), or extruded bitmap (EBM).
+
To capture prep performance, you will need to import some fairly complex geometry.  You should be able to search google with "filetype:3dm" or "filetype:step" or find something on grabcad.com to import
  
It should be free of modeling errors (no overlaps, run "rtcheck" to verify).  It should have interesting shader properties set (suggest stack+plastic+texture), default shader will not be accepted.  Provide the .g geometry file and a 1024x1024 rendering at a "ae 35 25" view to show what it looks like.
+
Running "tops" within mged will tell you what geometry is available for rendering.
  
References:
+
Running "rt -o file.png -s32" on the system command line (not inside mged) should minimize the ray overhead or you can specifically isolate the prep phase we care about.  Prep is the time between when rt is run where it opens a window until the first pixels are fired and pixels start filling in.
* Introduction to MGED at http://brlcad.org/wiki/Documentation
 
 
|}
 
|}
  
 
&nbsp;
 
&nbsp;
{| style="background-color:#666666;" cellpadding="20" cellspacing="0" border="2" width="100%"
+
{| style="background-color:#ffffff;" cellpadding="20" cellspacing="0" border="2" width="100%"
 
|
 
|
== Model a "D" using BRL-CAD ==
+
=== Continue investigating GMP integration ===
  
Create an uppercase letter "D"  geometry model using BRL-CAD. You can use the mged or archer geometry editor tools or write a script. The model should be roughly 1000mm tall, about 500mm wide, and about 100mm deepCreate it using CSG or other methods, but it cannot be an imported model, polygonal mesh (BOT, NMG), or extruded bitmap (EBM).
+
BRL-CAD uses a fastf_t typedef for most all math operations that is usually a "double" floating point type. We would like to provide the option for resorting to exact arithmetic if possible by merely redefining fastf_t to a C++ type sufficiently overloaded to behave the same. You should be proficient with C++ operator overloading to take this work onThis task is a continuation of a prior GCI task (read it in full!):
  
It should be free of modeling errors (no overlaps, run "rtcheck" to verify).  It should have interesting shader properties set (suggest stack+plastic+texture), default shader will not be acceptedProvide the .g geometry file and a 1024x1024 rendering at a "ae 35 25" view to show what it looks like.
+
http://www.google-melange.com/gci/task/view/google/gci2012/7946218
 +
 
 +
This task involves testing compilation with a C++ class with overloaded operators such that vmath macro calls still work as well as a sampling of LIBBN API function calls without major changes to the original code. A perfect example case study would be creating the class then testing whether bn_dist_pt3_pt3() and bn_mat_determinant() compute correctly for values that cannot be exactly represented with floating point arithmetic.
 +
 
 +
Building on the previous GCI task work, take it to the next step.  Try setting a vector to 1/3, 1/3, 1/3 and 0.1, 0.1, 0.1 and get proper values to print.  Change the V3ARGS() macro if neededIf that all works, try to get bn_dist_pt3_pt3() to workReport and discuss your progress.
  
References:
 
* Introduction to MGED at http://brlcad.org/wiki/Documentation
 
 
|}
 
|}
  
 
&nbsp;
 
&nbsp;
{| style="background-color:#666666;" cellpadding="20" cellspacing="0" border="2" width="100%"
+
{| style="background-color:#ffffff;" cellpadding="20" cellspacing="0" border="2" width="100%"
 
|
 
|
== Model new BRL-CAD Logo using BRL-CAD ==
+
=== Design a T-Shirt for BRL-CAD ===
  
The winner of the recent BRL-CAD Logo contest is a clean depiction of two interlocked components. Modeling the new Logo in BRL-CAD in CSG (without NURBS, without polygons) requires some careful arrangement, but can provide an attractive three dimensional rendering.
+
This task involves designing a T-Shirt for BRL-CAD. Use your designing skills to design a T-Shirt for BRL-CAD. You can use the current BRL-CAD logo, or you may tweak it. Be creative while designing this T-Shirt. It would be good if the design has some special meaning.
  
The output of this task would be a .g file of BRL-CAD logo. The two segments should overlap at the join, but this is your opportunity as an artist and 3D magician to come up with an interesting or faithful interpretation.
+
Logo References
 
 
References:
 
 
* http://brlcad.org/images/angelov_256.png
 
* http://brlcad.org/images/angelov_256.png
 
* http://brlcad.org/d/node/92
 
* http://brlcad.org/d/node/92
* Introduction to MGED at http://brlcad.org/wiki/Documentation
 
  
 
|}
 
|}
 +
 
&nbsp;
 
&nbsp;
{| style="background-color:#666666;" cellpadding="20" cellspacing="0" border="2" width="100%"
+
{| style="background-color:#ffffff;" cellpadding="20" cellspacing="0" border="2" width="100%"
 
|
 
|
== Write BRL-CAD News article on .deb/.rpm builds ==
+
=== Design a coffee mug for BRL-CAD ===
  
BRL-CAD's maintainer, Jordi Sayol, manages the .deb and .rpm builds.  Interview the developer, obtain details on how the releases are produced, what platforms are supported, etc, and write up an article for our Community Publication Portal (CPP)
+
This task involves designing a coffee mug for BRL-CAD. Make it look good, so that one can use it while working on BRL-CAD. Look over some great coffee mug designs before starting to work on this. It would be great if the design on coffee mug has some special meaning.
  
The output of this task is an article added to our CPP wiki page in a final production-quality review state.
+
Logo References
 +
* http://brlcad.org/images/angelov_256.png
 +
* http://brlcad.org/d/node/92
  
References:
+
|}
* http://brlcad.org/wiki/Community_Publication_Portal
 
  
|}
 
 
&nbsp;
 
&nbsp;
{| style="background-color:#666666;" cellpadding="20" cellspacing="0" border="2" width="100%"
+
{| style="background-color:#ffffff;" cellpadding="20" cellspacing="0" border="2" width="100%"
 
|
 
|
== Write a BRL-CAD showcase article ==
+
=== Design BRL-CAD sticker ===
  
BRL-CAD has several ongoing development activities developed by community members that showcase the power and applicability of BRL-CAD to various domains.  For this task, you'd be expected to interview one or more individuals to obtain information and pictures about their project, write up a descriptive overview of their model, the goals of the project, and any interesting ancillary information that may be relevant. There are presently several candidate topics listed in our Community Publication Portal (CPP).
+
This task involves designing a BRL-CAD sticker. The design should be simple and sleek. The concept of sticker should be clear and also it should be creatively presented. Get inspired from some sticker designs but choose your own imagination while designing the sticker. There is no bound for shape of sticker, it can be rectangular, circular or even irregular. The only thing that matters is that it should look good.
  
The output of this task is an article added to our CPP wiki page in a final draft review state.
+
Logo References
 +
* http://brlcad.org/images/angelov_256.png
 +
* http://brlcad.org/d/node/92
  
References:
+
|}
* http://brlcad.org/wiki/Community_Publication_Portal
 
  
|}
 
 
&nbsp;
 
&nbsp;
{| style="background-color:#666666;" cellpadding="20" cellspacing="0" border="2" width="100%"
+
{| style="background-color:#ffffff;" cellpadding="20" cellspacing="0" border="2" width="100%"
 
|
 
|
== Design a "Commercial CAD Comparison" diagram ==
+
=== Design BRL-CAD phone/tablet back cover ===
  
New users frequently ask how BRL-CAD compares to other major commercial CAD systems such as CATIA, Unigraphics/NX, Pro/ENGINEER, Solidworks, and AutoCAD. BRL-CAD has many of the same features and it would be very useful to visualize the feature overlap graphically with a diagram.
+
This task involves designing a BRL-CAD phone/tablet cover.
 +
While submitting your design, provide the sample phone cover, tablet cover with the design and rendered png or jpg image of the sticker design. Try to have a special meaning of design, and the concept should be creatively illustrated.
  
This task involves identifying core significant features of relevance and describing BRL-CAD along with the various major CAD vendors. The diagram should fit on one page.
+
Logo References
 +
* http://brlcad.org/images/angelov_256.png
 +
* http://brlcad.org/d/node/92
  
References:
+
|}
* http://brlcad.org/Industry_Diagram.png
 
* Example feature comparisons (although not a diagram): http://en.wikipedia.org/wiki/Comparison_of_3D_computer_graphics_software
 
* Additional feature comparisons (also not a diagram): http://en.wikipedia.org/wiki/Comparison_of_CAD_editors_for_CAE
 
  
|}
 
 
&nbsp;
 
&nbsp;
{| style="background-color:#666666;" cellpadding="20" cellspacing="0" border="2" width="100%"
+
{| style="background-color:#ffffff;" cellpadding="20" cellspacing="0" border="2" width="100%"
 
|
 
|
== Investigate performance of setting thread affinity ==
+
=== Design a wallpaper set for BRL-CAD ===
  
BRL-CAD's raytrace library (LIBRT) is pervasively multithreaded using routines defined in our basic utility library (LIBBU) for detecting an using multiple CPUs/cores/threads. On Linux, BSD, or Mac OS X, you can set the affinity of a process to stay on a processor.
+
This task involves designing a set of wallpapers for BRL-CAD. The central idea of each wallpaper should represent any feature of BRL-CAD. Try to design a minimum of 5 wallpapers but if you have more than 5 designs than you are welcomed.
 +
 +
Try to different resolutions of each wallpaper.
  
This task involves making minor modifications to the LIBBU parallel interface using sched_setaffinity and/or pthread_attr_setaffinity_np (or similar affinity mechanism depending on the platform) and then evaluating the performance impact using our BRL-CAD Benchmark suite ('benchmark' command).
+
Check the following wallpapers for inspiration.
 +
* http://www.smashingmagazine.com/tag/wallpapers/
  
Code:
+
Logo References
* src/libbu/parallel.c
+
* http://brlcad.org/images/angelov_256.png
* src/libbu/semaphore.c
+
* http://brlcad.org/d/node/92
  
 
|}
 
|}
&nbsp;
 
{| style="background-color:#666666;" cellpadding="20" cellspacing="0" border="2" width="100%"
 
|
 
== Determine why solids.sh fails on 64-bit ==
 
 
BRL-CAD has a regression test script called solids.sh that creates a bunch of primitives, renders an image of those primitives, and then compares that image to a reference image.  On (most?) 64-bit platforms, the test is off by several RGB values for exactly 3 pixels.
 
 
This task involves figuring out why, exactly, this is occurring.  It may be helpful to compare intermediate computation results from a 32-bit environment to see where the computations diverge, however slightly.  Ultimately, the goal is to identify the cause and a recommended course of action to fix the divergence problem.
 
  
Code:
 
* regress/solids.sh
 
* src/librt
 
* src/liboptical
 
  
|}
 
 
&nbsp;
 
&nbsp;
{| style="background-color:#666666;" cellpadding="20" cellspacing="0" border="2" width="100%"
+
{| style="background-color:#ffffff;" cellpadding="20" cellspacing="0" border="2" width="100%"
 
|
 
|
 +
=== Create Iron Man Arc Reactor Model in BRL-CAD ===
  
== Investigate permuted vertex lists from g-iges + iges-g ==
+
This task involves creating Arc Reactor as seen in hollywood movie Iron-Man. You will have to create two versions of the Arc Reactor one glowing and another non glowing.
 +
 +
Check this model for inspiration
 +
* http://grabcad.com/library/iron-man-arc-reactor-request
  
BRL-CAD has a geometry exporter and importer for the International Graphics Exchange Standard (IGES) file format.  If you run our g-iges exporter on some geometry, then run iges-g on that same geometry to import it back to BRL-CAD format, the geometry will have permuted vertex lists.  Particularly for geometry already in polygonal format, such as our NMG or BoT geometry, this conversion should result in identical geometry but presently does not.
 
  
This task involves investigating why this occurs, reporting (in detail) why it occurs, and if obvious, making a recommendation on how to fix the problem.
+
|}
  
Code:
 
* src/conv/iges
 
  
|}
 
 
&nbsp;
 
&nbsp;
{| style="background-color:#666666;" cellpadding="20" cellspacing="0" border="2" width="100%"
+
{| style="background-color:#ffffff;" cellpadding="20" cellspacing="0" border="2" width="100%"
 
|
 
|
== Investigate GMP integration ==
+
=== Tweak BRL-CAD logo to wish New Year ===
  
BRL-CAD uses a fastf_t typedef for most all math operations that is usually a "double" floating point type. We would like to provide the option for resorting to exact arithmetic if possible by merely redefining fastf_t to a C++ type sufficiently overloaded to behave the same. You should be proficient with C++ operator overloading to take this task on.  
+
You might have heard and praised those google doodles we occasionally see on google.com on special days. This task is all about tweaking BRL-CAD logo to wish New Year. You may have a look at google doodles but don't entirely copy their style. I am sure your creative mind will get something much better.
 +
Make sure this tweak should be tweaked version of current logo and not entirely new logo.
  
This task involves testing compilation with a C++ class with overloaded operators such that vmath macro calls still work as well as a sampling of LIBBN API function calls without major changes to the original code. A perfect example case study would be creating the class then testing whether bn_dist_pt3_pt3() and bn_mat_determinant() compute correctly for values that cannot be exactly represented with floating point arithmetic.
+
Tip: Search for some global events occurring in 2015 and design accordingly. Also keep the letters 2,0,1,5 in mind while designing. ;)
  
References:
+
Also output of this task shall be the png file of your work and the raw file but don't upload the raw file(.psd, .xcf or some other) for review of this task. We will ask for it later, when the design is finalized.
* http://gmplib.org/
+
 
 +
Gallery of all google doodles
 +
* http://www.google.com/doodles
  
Code:
 
* include/vmath.h
 
* include/bn.h
 
  
 
|}
 
|}
 +
 +
 
&nbsp;
 
&nbsp;
{| style="background-color:#666666;" cellpadding="20" cellspacing="0" border="2" width="100%"
+
{| style="background-color:#ffffff;" cellpadding="20" cellspacing="0" border="2" width="100%"
 
|
 
|
== Research status of compiling BRL-CAD on MINGW ==
+
=== Tweak BRL-CAD logo to wish Merry Christmas ===
  
BRL-CAD compiles on a number of platforms but is rarely compiled under mingw. A cygwin compilation was last successfuly performed a few years ago with relatively minor effort, but mingw hasn't been tested.
+
You might have heard and praised those google doodles we occasionally see on google.com on special days. This task is all about tweaking BRL-CAD logo to wish Christmas. You may have a look at google doodles but don't entirely copy their style. I am sure your creative mind will get something much better.
 
+
Make sure the output of this task should be tweaked version of current logo and not entirely new logo.
This task involves attempting to compile BRL-CAD under mingw (AFTER successfully compiling with MSVC).  Follow the CMake documentation and edit our build system accordingly. Report on what fails and write up a tutorial on the BRL-CAD wiki.
 
 
 
References:
 
* http://brlcad.org/wiki/
 
* http://www.mingw.org/
 
* http://www.cmake.org/Wiki/CmakeMingw
 
 
 
Code:
 
* CMakeLists.txt
 
* misc/CMake/*
 
|}
 
  
&nbsp;
+
Also output of this task shall be the png file of your work and the raw file but don't upload the raw file(.psd, .xcf or some other) for review of this task. We will ask for it later, when the design is finalized.
{| style="background-color:#666666;" cellpadding="20" cellspacing="0" border="2" width="100%"
 
|
 
== Create an awesome screenshot ==
 
  
Everyone loves to see screenshots of software in action. We use screenshots in our marketing and outreach.  See some of the examples below that we already have.
+
Gallery of all google doodles
 +
* http://www.google.com/doodles
  
Create an awesome screenshot of either mged or archer.  It should be graphically interesting, show wireframe and/or raytraced geometry and give some sense of capability.
 
  
References:
 
* http://brlcad.org/gallery/d/19-4/MGED.jpg
 
* http://brlcad.org/tmp/archer.png
 
* http://brlcad.org/gallery/s/screenshots/
 
 
|}
 
|}
  
 
----
 
----
  
= Quality Assurance =
+
== Quality Assurance ==
 
----
 
----
 
''Tasks related to testing and ensuring code is of high quality''
 
''Tasks related to testing and ensuring code is of high quality''
  
{| style="background-color:#666666;" cellpadding="20" cellspacing="0" border="2" width="100%"
+
{| style="background-color:#ffffff;" cellpadding="20" cellspacing="0" border="2" width="100%"
 
|
 
|
== Fix single-precision floating point crash ==
+
=== Fix single-precision floating point crash ===
  
 
By default, all of BRL-CAD compiles using double-precision floating point arithmetic.  We provide a simple typedef, however, that converts almost the entire system over to single-precision floating point.  This compilation mode was recently cleaned up and tested, but a bug was found.  The problem is reproduced very simply by compiling in single precision mode and running our "rt" ray tracer tool.
 
By default, all of BRL-CAD compiles using double-precision floating point arithmetic.  We provide a simple typedef, however, that converts almost the entire system over to single-precision floating point.  This compilation mode was recently cleaned up and tested, but a bug was found.  The problem is reproduced very simply by compiling in single precision mode and running our "rt" ray tracer tool.
Line 1,264: Line 671:
  
 
&nbsp;
 
&nbsp;
{| style="background-color:#666666;" cellpadding="20" cellspacing="0" border="2" width="100%"
+
{| style="background-color:#ffffff;" cellpadding="20" cellspacing="0" border="2" width="100%"
 
|
 
|
== Fix closedb ==
+
=== Fix closedb ===
  
 
BRL-CAD geometry editor application (mged) has several hundred commands including two very simple commands for opening and closing a geometry database file.  While the user rarely ever needs to close the file, as all changes are always immediately saved, it can be of use to scripting applications.  However, at some point in the recent past, the ''closedb'' command was horked.  It's undoubtedly something very simple but we haven't bothered to look due to other priorities.  You can fix it.  If you run these simple steps within graphical mged, you should see how commands stop working after calling closedb:
 
BRL-CAD geometry editor application (mged) has several hundred commands including two very simple commands for opening and closing a geometry database file.  While the user rarely ever needs to close the file, as all changes are always immediately saved, it can be of use to scripting applications.  However, at some point in the recent past, the ''closedb'' command was horked.  It's undoubtedly something very simple but we haven't bothered to look due to other priorities.  You can fix it.  If you run these simple steps within graphical mged, you should see how commands stop working after calling closedb:
Line 1,287: Line 694:
  
 
&nbsp;
 
&nbsp;
{| style="background-color:#666666;" cellpadding="20" cellspacing="0" border="2" width="100%"
+
{| style="background-color:#ffffff;" cellpadding="20" cellspacing="0" border="2" width="100%"
 
|
 
|
== Create geometry database with one of every primitive ==
+
=== Create a utility library (LIBBU) API unit test ===
 
 
BRL-CAD implements 40 different types of 2D, 3D, and non-geometric objects that get stored in a ".g" geometry database file.  For numerous debugging and testing purposes, it'd be useful to have a database with all object types included.  Our ''csgbrep'' procedural geometry database tool creates 21 of them.  Our ''mged'' geometry editor application lets users create them manually using the "make" and "in" commands via the command-line interface.
 
 
 
This task involves running the csgbrep to create a starting set of objects and then creating the remaining ones manually.  Provide a .g file that contains every possible object type.
 
 
 
References:
 
* http://brlcad.org/wiki/Documentation
 
* http://brlcad.org/wiki/EBM
 
* http://brlcad.org/wiki/DSP
 
* src/librt/primitives <-- lists all object types except comb, binunif, and attribute objects
 
* csgbrep <-- creates half of what you need
 
* mged <-- can create the other half
 
 
 
|}
 
&nbsp;
 
{| style="background-color:#666666;" cellpadding="20" cellspacing="0" border="2" width="100%"
 
|
 
== Create an utility library (LIBBU) API unit test ==
 
  
 
There are more than 300 library functions in our core LIBBU library.  As a core library used by nearly every one of BRL-CAD's tools, testing those functions for correct behavior is important.
 
There are more than 300 library functions in our core LIBBU library.  As a core library used by nearly every one of BRL-CAD's tools, testing those functions for correct behavior is important.
  
This task involves implementing a new unit test for any of LIBBU's source files that do not already have a unit test defined.  The test should run all of the public functions and be hooked into our build system.  We have lots of existing unit tests to follow as an example.
+
This task involves implementing new unit tests for any of LIBBU's source files that do not already have a unit test defined.  The test should run all of the public functions and be hooked into our build system.  We have lots of existing unit tests to follow as examples.
  
 
References:
 
References:
Line 1,322: Line 711:
 
* src/libbu/tests/CMakeLists.txt
 
* src/libbu/tests/CMakeLists.txt
  
{| style="background-color:#222222;" cellpadding="20" cellspacing="0" border="2" width="100%"
+
 
 +
{| cellpadding="20" cellspacing="0" border="2" width="100%"
 
|
 
|
=== ... unit test for LIBBU argv.c ===
+
==== ... unit test for LIBBU bomb.c ====
 
|}
 
|}
&nbsp;
 
{| style="background-color:#222222;" cellpadding="20" cellspacing="0" border="2" width="100%"
 
|
 
=== ... unit test for LIBBU avs.c ===
 
|}
 
&nbsp;
 
{| style="background-color:#222222;" cellpadding="20" cellspacing="0" border="2" width="100%"
 
|
 
=== ... unit test for LIBBU backtrace.c ===
 
 
|}
 
|}
 +
 
&nbsp;
 
&nbsp;
{| style="background-color:#222222;" cellpadding="20" cellspacing="0" border="2" width="100%"
+
{| style="background-color:#ffffff;" cellpadding="20" cellspacing="0" border="2" width="100%"
 
|
 
|
=== ... unit test for LIBBU badmagic.c ===
 
|}
 
&nbsp;
 
{| style="background-color:#222222;" cellpadding="20" cellspacing="0" border="2" width="100%"
 
|
 
=== ... unit test for LIBBU bomb.c ===
 
|}
 
|}
 
  
&nbsp;
+
=== Create Numerics library (LIBBN) API unit tests ===
{| style="background-color:#666666;" cellpadding="20" cellspacing="0" border="2" width="100%"
 
|
 
== Create numerics library (LIBBN) API unit test ==
 
  
 
There are more than 300 library functions in our core LIBBN library.  As a core library used by nearly every one of BRL-CAD's tools, testing those functions for correct behavior is important.
 
There are more than 300 library functions in our core LIBBN library.  As a core library used by nearly every one of BRL-CAD's tools, testing those functions for correct behavior is important.
  
This task involves implementing a new unit test for any of LIBBN's source files that do not already have a unit test defined.  The test should run all of the public functions and be hooked into our build system.  We have lots of existing unit tests to follow as an example.
+
This task involves implementing new unit tests for any of LIBBN's source files that do not already have a unit test defined.  The test should run all of the public functions and be hooked into our build system.  We have lots of existing unit tests to follow as examples.
  
 
References:
 
References:
Line 1,362: Line 733:
 
* include/vmath.h
 
* include/vmath.h
 
* src/libbn/*.c
 
* src/libbn/*.c
* src/libbu/tests/*.c <-- note libbu, not libbn for examples
+
* src/libbn/tests/*.c <-- check this directory for examples
 +
* src/libbu/tests/*.c <-- Note: Also check this too for more examples.
  
 
Code:
 
Code:
Line 1,368: Line 740:
 
* src/libbn/tests/CMakeLists.txt
 
* src/libbn/tests/CMakeLists.txt
  
{| style="background-color:#222222;" cellpadding="20" cellspacing="0" border="2" width="100%"
+
<b> Note </b>
 +
A valid task will constitute writing a basic test for each function in the following libbn/ files.
 +
 
 +
{| cellpadding="20" cellspacing="0" border="2" width="100%"
 
|
 
|
=== ... unit test for LIBBN list.c ===
+
==== ... unit tests for LIBBN anim.c ====
 
|}
 
|}
 
&nbsp;
 
&nbsp;
{| style="background-color:#222222;" cellpadding="20" cellspacing="0" border="2" width="100%"
+
{| cellpadding="20" cellspacing="0" border="2" width="100%"
 
|
 
|
=== ... unit test for LIBBN axis.c ===
+
 
 +
*Useful resources
 +
  ->coming!
 +
 
 +
==== ... unit tests for LIBBN axis.c ====
 
|}
 
|}
 
&nbsp;
 
&nbsp;
{| style="background-color:#222222;" cellpadding="20" cellspacing="0" border="2" width="100%"
+
{| cellpadding="20" cellspacing="0" border="2" width="100%"
 
|
 
|
=== ... unit test for LIBBN complex.c ===
+
==== ... unit tests for LIBBN qmath.c ====
 
|}
 
|}
 
&nbsp;
 
&nbsp;
{| style="background-color:#222222;" cellpadding="20" cellspacing="0" border="2" width="100%"
+
{| cellpadding="20" cellspacing="0" border="2" width="100%"
 
|
 
|
=== ... unit test for LIBBN qmath.c ===
+
 
 +
 
 +
*Useful links and Resources
 +
-> Coming!
 +
 
 +
==== ... unit tests for LIBBN rand.c ====
 
|}
 
|}
 
&nbsp;
 
&nbsp;
{| style="background-color:#222222;" cellpadding="20" cellspacing="0" border="2" width="100%"
+
{| cellpadding="20" cellspacing="0" border="2" width="100%"
 
|
 
|
=== ... unit test for LIBBN rand.c ===
+
==== ... unit tests for LIBBN vector.c ====
 
|}
 
|}
 
|}
 
|}
  
 
&nbsp;
 
&nbsp;
{| style="background-color:#666666;" cellpadding="20" cellspacing="0" border="2" width="100%"
+
{| style="background-color:#ffffff;" cellpadding="20" cellspacing="0" border="2" width="100%"
 
|
 
|
== Create a COMPREHENSIVE unit test for bn_dist_pt3_pt3() ==
 
  
There are more than 300 library functions in our LIBBN numerics library.  Creating a comprehensive unit test involves exhaustively exploring all possible inputs to the function, testing them for proper behavior, and characterizing the output in a PASS/FAIL fashion.
+
*Useful links and resources
 +
-> To be added.
  
Unlike the other testing framework tasks, the goal of this task is comprehensiveness.  The task must cover all possible inputs including NULL, -inf, +inf, NaN, real numbers, and other values in most if not all possible combinations.
+
=== Find, reliably reproduce, and report any bug in Archer ===
 
 
Code:
 
* include/bn.h
 
* src/libbn/plane.c
 
* src/libbn/tests/CMakeLists.txt
 
* src/libbn/tests/bn_plane.c <-- you write this
 
|}
 
 
 
&nbsp;
 
{| style="background-color:#666666;" cellpadding="20" cellspacing="0" border="2" width="100%"
 
|
 
== Find, reliably reproduce, and report any bug in Archer ==
 
  
 
Archer is our new modeling interface and a soon to merge with our long-standing MGED geometry editor.  It undoubtedly has bugs.  It's your job to find one, but do so in a manner that is so obvious that one of the other devs will be able to instantly reproduce the bug given your specific instructions.  Find a way to make archer crash, become unresponsive, or otherwise behave incorrectly.  You will have to explore the tool with minimal documentation.
 
Archer is our new modeling interface and a soon to merge with our long-standing MGED geometry editor.  It undoubtedly has bugs.  It's your job to find one, but do so in a manner that is so obvious that one of the other devs will be able to instantly reproduce the bug given your specific instructions.  Find a way to make archer crash, become unresponsive, or otherwise behave incorrectly.  You will have to explore the tool with minimal documentation.
Line 1,427: Line 799:
  
 
&nbsp;
 
&nbsp;
{| style="background-color:#666666;" cellpadding="20" cellspacing="0" border="2" width="100%"
+
{| style="background-color:#ffffff;" cellpadding="20" cellspacing="0" border="2" width="100%"
 
|
 
|
== Reproduce any 10 unconfirmed open bug reports ==
+
=== Reproduce any 10 unconfirmed open bug reports ===
  
 
BRL-CAD presently has approximately 75 open bug reports of which 50 are unassigned.  Read the comments and status to see if the bug has been confirmed/reproduced.   
 
BRL-CAD presently has approximately 75 open bug reports of which 50 are unassigned.  Read the comments and status to see if the bug has been confirmed/reproduced.   
Line 1,439: Line 811:
 
|}
 
|}
  
&nbsp;
 
{| style="background-color:#666666;" cellpadding="20" cellspacing="0" border="2" width="100%"
 
|
 
== Fix documentation XML errors in doc/docbook/articles ==
 
 
Some of BRL-CAD's existing documentation has been converted to DocBook format, but not all of the new files pass strict XML validation.  We want to make our existing pages conform strictly.  The simplest way to find documents with errors is to add a CMake configuration flag when preparing to build BRL-CAD that enables a strict check when make is run.  Adding this flag will cause a build failure if there's a syntax error:
 
 
-DBRLCAD_EXTRADOCS_VALIDATE=ON
 
 
Generally, the resulting error message will provide hints that can be used to identify and fix the problem.  Also, once it is clear how to address one particular problem, it is likely that that problem will occur multiple times in different files.  This will make the process faster once initial errors are solved. 
 
 
This task involves preparing a BRL-CAD compilation environment with validation enabled, then cleaning up the DocBook XML files under the doc/docbook/articles directory (e.g., doc/docbook/articles/en/pipes.xml), fixing whatever errors arise and submitting a patch.  You can build test your changes by compiling just a subset of the documentation.  In your ''build'' directory (not source), you can run this:
 
 
# in your build directory
 
cd doc/docbook/articles
 
make
 
 
Once you're done, make and submit your patch:
 
svn diff ~/brlcad.svn/doc/docbook/articles > xmlfixes.patch
 
 
Keep track of how long this all takes you because we intend to add a lot more tasks like this one.
 
 
References:
 
* doc/docbook/README
 
* DocBook 5 Reference: http://docbook.org/tdg5/en/html/docbook.html
 
* Emacs editor: http://www.gnu.org/software/emacs/emacs.html
 
* nxml Emacs mode: http://www.thaiopensource.com/nxml-mode/
 
 
Code:
 
* doc/docbook/articles/*.xml
 
|}
 
  
 
----
 
----
  
= User Interface =
+
== User Interface ==
 
----
 
----
 
''Tasks related to user experience research or user interface design and interaction''
 
''Tasks related to user experience research or user interface design and interaction''
  
{| style="background-color:#666666;" cellpadding="20" cellspacing="0" border="2" width="100%"
+
 
 +
&nbsp;
 +
{| style="background-color:#ffffff;" cellpadding="20" cellspacing="0" border="2" width="100%"
 
|
 
|
== Design an MGED command spreadsheet ==
+
=== Create an ISST screenshot or animation ===
  
BRL-CAD's primary solid geometry modeling application is called MGED. MGED contains a comprehensive set of more than 700 commands for manipulating, viewing, and inspecting geometry. There is a need to more effectively manage those commands, characterize them all, and get a "big picture" of the command landscape so that usability may be addressed.
+
Everyone loves to see screenshots and animations of software in action. We use both in our marketing and outreach. See some of the examples below that we already have.
  
This task involves designing a spreadsheet that will be used to characterize all of MGED's commands.
+
Create an awesome screenshot and/or animation of our 'isst' tool in action. It's an interactive geometry viewer interface.  It should be graphically interesting and give some sense of capability.  You should import a visually complex and interesting model with LOTS of polygons and detail.
  
 
References:
 
References:
* An existing spreadsheet already being used for BRL-CAD (i.e., non-MGED) commands is available.
+
* http://brlcad.org/gallery/d/19-4/MGED.jpg
 +
* http://brlcad.org/tmp/archer.png
 +
* http://brlcad.org/gallery/s/screenshots/
 +
* http://www.google-melange.com/gci/task/view/google/gci2012/8019211
  
|}
+
Note that we have several screenshot tasks.  Note you may have to go through some or our basic MGED tutorials (see docs section on our website) just to be able to display geometry.  Finally, give others a chance if you already completed one of the other screenshot tasks. ;)
&nbsp;
 
{| style="background-color:#666666;" cellpadding="20" cellspacing="0" border="2" width="100%"
 
|
 
== Create prototype 2D CAD drawing(s) ==
 
  
BRL-CAD provides limited services for drafting features including the production of 2D CAD drawings (blueprints).
 
 
This task involves designing a 2D CAD drawing prototype that effectively captures a set of design requirements and follows industry conventions.  Basically, this requires identifying one or more style(s) of drawings that should be supported along with critical elements to be included on each drawing.
 
 
References:
 
* http://brlcad.org/design/drafting
 
* http://en.wikipedia.org/wiki/ISO_128
 
* http://en.wikipedia.org/wiki/ASME_Y14.41-2003
 
* http://en.wikipedia.org/wiki/Geometric_Dimensioning_and_Tolerancing
 
* http://www.ptc.com/WCMS/files/45691/en/4307_FoundationXE_DS.pdf
 
 
 
|}
 
|}
  
 
&nbsp;
 
&nbsp;
{| style="background-color:#666666;" cellpadding="20" cellspacing="0" border="2" width="100%"
+
{| style="background-color:#ffffff;" cellpadding="20" cellspacing="0" border="2" width="100%"
 
|
 
|
== Create prototype CAD GUI layout diagram ==
+
=== Categorize all of BRL-CAD's commands into a spreadsheet ===
  
BRL-CAD's usability is notoriously complex and "expert friendly". MGED and Archer are the main geometry editors, with drastically different user interfaces.
+
BRL-CAD is a suite of more than 400 processing tools, image tools, geometry converters, and more. There is an existing spreadsheet that characterizes all of the available commands in terms of inputs, outputs, and options, but there is insufficient characterization of BRL-CAD's commands as to how they logically group and work together.
  
This task involves evaluating the features provided by MGED and Archer, then designing a new GUI layout that encompasses their features while improving usability.  Rationale for design decisions and layout should be provided.
+
This task involves building up a spreadsheet that lists all of our commands, describing a finite set of command categories, and characterizing all commands into those categories while filling in the spreadsheet with details for each command.
  
 
References:
 
References:
* http://brlcad.org/design/gui
+
* A spreadsheet template will be provided.
  
 
|}
 
|}
 +
 
&nbsp;
 
&nbsp;
{| style="background-color:#666666;" cellpadding="20" cellspacing="0" border="2" width="100%"
+
{| style="background-color:#ffffff;" cellpadding="20" cellspacing="0" border="2" width="100%"
 
|
 
|
== Reorganize MGED menu ==  
+
===  Design a Cover Photo for Facebook page (and other social networks) ===
  
BRL-CAD's main graphical user interface, MGED, is heavily menu-driven but not exceptionally well organized.  This task involves performing an exhaustive review of MGED's various menus, including temporary menus when in a given editing state, reorganizing them for logical groupings, and rewording them for clarity. It's necessary to learn the basics of the MGED interface in order to understand what the various options do.
+
BRL-CAD got it's logo changed, and it's website is undergoing a change. So this re-branding of BRL-CAD also requires a good, well designed and attractive cover photo for the BRL-CAD's Facebook page or other Social Media Appearances. It should feature a good tagline telling some killer feature of BRL-CAD, BRL-CAD's new logo and/or some illustration/image regarding the feature highlighted in tagline.
  
For this task, you'll provide a description of the existing menus and mapping to a new organization including basic rationale behind any new groupings or rewording.  
+
It should be consistent with the color scheme of our new website design.
  
References:
+
New website design
* Introduction to MGED at http://brlcad.org/wiki/Documentation
+
*http://cpp-tricks.com/brlcad/
  
 
|}
 
|}
 +
 
&nbsp;
 
&nbsp;
{| style="background-color:#666666;" cellpadding="20" cellspacing="0" border="2" width="100%"
+
{| style="background-color:#ffffff;" cellpadding="20" cellspacing="0" border="2" width="100%"
 
|
 
|
== Categorize all of BRL-CAD's commands into a spreadsheet ==
 
  
BRL-CAD is a suite of more than 400 processing tools, image tools, geometry converters, and more.  There is an existing spreadsheet that characterizes all of the available commands in terms of inputs, outputs, and options, but there is insufficient characterization of BRL-CAD's commands as to how they logically group and work together.
+
===  Design a banner ad for BRL-CAD ===
  
This task involves building up a spreadsheet that lists all of our commands, describing a finite set of command categories, and characterizing all commands into those categories while filling in the spreadsheet with details for each command.
+
BRL-CAD is one of the oldest open source communities. This community has a good following, so we want to give a chance to everyone so that they can show their support to the community by adding a banner ad in their website. You have to create a banner ad that can be embedded in the website by copy pasting some simple lines of code (basically an iframe).  
 
 
References:
 
* A spreadsheet template will be provided.
 
  
|}
+
Such a banner ad can also be used in various sections of our own website.
&nbsp;
 
{| style="background-color:#666666;" cellpadding="20" cellspacing="0" border="2" width="100%"
 
|
 
== Upgrade Drupal website ==
 
  
A portion of the BRL-CAD website runs on Drupal, but it's out of date.  Migrating to newer versions will require incrementally updating the website database per Drupal's upgrade instructions along with all of our modules. Access to a copy of our webserver files will be provided.  Experience working on a command-line is a must, ideally with prior Drupal experience if you hope to complete this within a couple hours.
+
The task requires you to create a CSS3 based animated horizontal and vertical banner add, highlighting some feature of BRL-CAD or making some call to action. This call to action can be joining mailing list, or signing up for community, or link to latest post etc.  
  
This task involves getting the Drupal portion of our website cleanly migrated to the latest version of Drupal.  All installed modules should also be updated.
+
For Inspiration and tutorial refer
 +
*http://tympanus.net/Tutorials/AnimatedWebBanners/
  
References:
 
* http://brlcad.org/d/
 
* http://drupal.org
 
 
|}
 
|}
  
 
&nbsp;
 
&nbsp;
{| style="background-color:#666666;" cellpadding="20" cellspacing="0" border="2" width="100%"
+
{| style="background-color:#ffffff;" cellpadding="20" cellspacing="0" border="2" width="100%"
 
|
 
|
 +
=== Creating Motion Typography video for BRL-CAD  ===
  
== Upgrade Mediawiki website ==
+
BRL-CAD has a lot of great features that can be highlighted. A motion typography video highlighting these features would be a wonderful addition to the front page of website.
  
A portion of the BRL-CAD website runs on Mediawiki, but it's out of date.  Migrating to newer versions will require incrementally updating the website database per Mediawiki's upgrade instructions along with all of our extensions. Access to a copy of our webserver files will be provided.  Experience working on a command-line is a must, ideally with prior Mediawiki experience if you hope to complete this within a couple hours.
+
This task requires you to create a motion typography video that will convince user to give BRL-CAD a try, it could be titled something like "x reasons to choose BRL-CAD" or anything similar (give your creative minds a flight). The video should not be more than 2 minutes.  
  
This task involves getting the Mediawiki portion of our website cleanly migrated to the latest version of Mediawiki.  All installed extensions should also be updated.
+
For inspiration about what a motion typography, see
 
+
*http://vimeo.com/24715531
References:
 
* http://brlcad.org/w/
 
* http://mediawiki.org
 
  
 
|}
 
|}
  
 
&nbsp;
 
&nbsp;
{| style="background-color:#666666;" cellpadding="20" cellspacing="0" border="2" width="100%"
+
{| style="background-color:#ffffff;" cellpadding="20" cellspacing="0" border="2" width="100%"
 
|
 
|
 +
=== Create a screen-cast for BRL-CAD  ===
  
== Upgrade Gallery website ==
+
Getting started with BRL-CAD is sometimes not so smooth. A screen-cast giving a tour of BRL-CAD's GUI and the steps involved in creating the first model will make it easy for users to get started.
  
A portion of the BRL-CAD website runs on Gallery, but it's out of date. Migrating to a newer version will require incrementally updating the website database per Gallery's upgrade instructions. Access to a copy of our webserver files will be provided. Experience working on a command-line is a must.
+
For this task you need to install BRL-CAD on your computer. Create a very basic model in it and record your screen as you create the model. It should also give a tour of BRL-CAD's workspace. You can choose model of your choice. Keep something very basic and easy for the first time users.  
  
This task involves getting the Gallery portion of our website cleanly migrated to the latest version of Gallery.  All images and view statistics should be preserved.
+
|}
  
References:
 
* http://brlcad.org/gallery/
 
* http://gallery.menalto.com/
 
 
|}
 
  
 
&nbsp;
 
&nbsp;
{| style="background-color:#666666;" cellpadding="20" cellspacing="0" border="2" width="100%"
+
{| style="background-color:#ffffff;" cellpadding="20" cellspacing="0" border="2" width="100%"
 
|
 
|
 +
=== Loading Google charts from API  ===
  
== Set up StatSVN ==
+
A basic wrapper of GCharts has been implemented a while ago : https://bitbucket.org/suryajith/benchmark/src/a27dd8c05d6819a527650e06a63076599d2e0d66/libs/charting.py?at=default With the google charts improving their API system which wasn't around then, see if the code could be optimized so to get the charts the optimal way.
  
BRL-CAD's Subversion repository is the oldest open source repository on the planet and we love statistics. A decade ago, we used to run a little tool called StatCVS that gave pretty graphs of commit activity.  When we converted to Subversion, a comparable tool didn't exist but now there are several and we want to try them out.  We'll set you up with an account on our web server.
+
Reference:
 +
*https://developers.google.com/chart/interactive/docs/index
  
This task involves running the latest version of StatSVN on our repository, providing the output, and providing instructions for running it again so we can keep the output up to date.  You may need to normalize the results if StatSVN has the same bug that StatCVS used to have if the line counts are incorrect, but hopefully not.
 
  
References:
 
* http://brlcad.org/OLD/statcvs.normalized/
 
* http://statsvn.org/
 
 
|}
 
|}
  
&nbsp;
+
=== Design a hall of fame for BRL-CAD developers ===
{| style="background-color:#666666;" cellpadding="20" cellspacing="0" border="2" width="100%"
 
|
 
== Set up SvnPlot ==
 
  
BRL-CAD's Subversion repository is the oldest open source repository on the planet and we love statistics. A decade ago, we used to run a little tool called StatCVS that gave pretty graphs of commit activity. When we converted to Subversion, a comparable tool didn't exist but now there are several and we want to try them out.  We'll set you up with an account on our web server.
+
We love our developers and want to have a special place in it's website to thank and motivate hard working folks behind BRL-CAD. Your task would be to use an image manipulation software such as GIMP or Photoshop and design a hall of fame page for developers. It should have avatars and names of all the developers. For inspiration you can take a look at http://underscores.me/. You are free to experiment and design anyway you want, just make sure that the color scheme and font-scheme is consistent with the new BRL-CAD web design.  
  
This task involves running the latest version of SvnPlot on our repository, providing the output, and providing instructions for running it again so we can keep the output up to date.
+
Links:
 +
* http://cpp-tricks.com/brlcad/
 +
* http://underscores.me/
  
References:
 
* http://brlcad.org/OLD/statcvs.normalized/
 
* http://code.google.com/p/svnplot/wiki/Introduction
 
  
 
|}
 
|}
 +
----
  
&nbsp;
+
= When You're Done =
{| style="background-color:#666666;" cellpadding="20" cellspacing="0" border="2" width="100%"
+
----
|
 
== Convert Gallery to Piwigo ==
 
  
A portion of the BRL-CAD website runs on Gallery, but it's been difficult to maintainWe'd like to see what our gallery would look like in PiwigoAccess to a copy of our webserver files will be provided.  Experience working on a command-line is a must.
+
For non-code, just send us your file(s).  For code changes, you will be expected to [[Patches|provide a patch file]]Make sure you ''read'' your patch file before submitting itMake sure your patch file will apply cleanly to an unmodified checkout of BRL-CAD:
  
This task involves getting the Gallery portion of our website cleanly migrated to PiwigoAll images should be preservedBonus points if you can preserve the image view counts.
+
svn co https://brlcad.svn.sourceforge.net/svnroot/brlcad/brlcad/trunk brlcad.edit
 
+
  cd brlcad.edit
References:
+
# make changes
* http://brlcad.org/gallery/
+
  svn diff > ~/my.patch
* http://piwigo.org/
+
# read ~/my.patch file with text editor
|}
+
cd ..
 +
svn co https://brlcad.svn.sourceforge.net/svnroot/brlcad/brlcad/trunk brlcad.fresh
 +
cd brlcad.fresh
 +
patch -p0 < ~/my.patch
 +
# submit your patch file to our patches tracker
 +
&nbsp;

Revision as of 00:12, 24 October 2017

This is a list of succinct tasks that are expected to take most people familiar with the prerequisites less than two hours to complete. It's a great starting point for anyone interested in contributing to BRL-CAD.

The tasks are all roughly the same complexity with no prior BRL-CAD experience expected. A description is provided along with a list of references and files you'll probably need to edit. Can we make it any easier?

Getting Started

Contact us (via IRC or brlcad-devel mailing list) if you have questions, comments, or ideas of your own you'd like to suggest.

We've made an awesome virtual disk image that has everything you need preconfigured and ready to go:

  1. Download our BRL-CAD Virtual Machine (VM) disk image.
  2. Install VirtualBox.
  3. Import and start the VM, log in (the password is "Brlcad!" without the quotes).
  4. Run "svn up brlcad-svn-trunk" and get started!

Pick a Task

We break down all tasks into one of five categories. Don't be worried if the tasks all sound confusing to you. Just pick one and start reading the references we've provided. Join IRC or our mailing list and ask questions.

  1. Code (programming)
  2. Documentation and Training (writing)
  3. Outreach and Research (graphics)
  4. Quality Assurance (testing)
  5. User Interface (designing)

Contents


Code


Tasks related to writing or refactoring code

See the When You're Done section above for details on submitting your changes.

 

Fix bounding box function for our polygonal mesh (BoT) primitive

BRL-CAD provides functions for its geometric primitives that define a bounding box - a box that completely encloses the volume described by the primitive. Ideally, these boxes are as small as possible while still enclosing the primitive. Currently the routine for BoTs is incorrect. You can use stl-g, obj-g, or any of our other *-g converters to import BoT geometry for testing.

This task involves studying the current code for the function rt_bot_bbox() and determining what is causing the current inaccuracies (the mged 'bb' command is a good way to visualize primitive bounding boxes). Make changes to produce a more optimal bounding box. Reimplement it from scratch if you like. The raytracing prep code in rt_bot_prep does prepare a better bounding box, so that is one place to check.

Code:

  • src/librt/primitives/bot/bot.c

   

Close MGED when both windows are closed

BRL-CAD has an interactive geometry editor called MGED. It's often the starting point for beginners and allows creation and manipulation of models using commands. When mged is run, it creates 2 windows: a text-console command window and an interactive graphics window. When the user closes one of those windows, there is a bug. Closing the graphics window closes the command window.

This task involves fixing this behavior so that ONLY closing both windows terminates the process properly and that closing either window does not take the other along with it.

Code:

  • src/mged/mged.c
  • src/tclscripts/mged/openw.c

 


Implement a primitive centroid function

BRL-CAD provides more than two dozen types of geometry "primitives" such as ellipsoids, boxes, and cones. Every primitive is described by a collection of callback functions, for example rt_ell_bbox() returns the bounding box dimensions for an ellipsoid. Wikipedia, Wolfram Mathworld, and various other math sites (and research papers) around the web include the equations for most of our basic primitives while others are a little more tricky to compute.

This task involves writing a new callback function that takes an rt_db_internal object and calculates its centroid (as a point_t 3D point). There are numerous examples in our code where we compute centroids for other primtiives. The primitives that do not already have a centroid callback are itemized in following.

References:

Code:

  • src/librt/primitives/table.c
  • src/librt/primitives/[PRIMITIVE]/[PRIMITIVE].c

 


Implement a primitive curvature function

BRL-CAD provides more than two dozen types of geometry "primitives" such as ellipsoids, boxes, and cones each described by a collection of callback functions, for example rt_sph_bbox() returns the bounding box dimensions for a sphere. Wikipedia, Wolfram Mathworld, and various other math sites (and research papers) around the web include the equations for most of our basic primitives while others are a little more tricky to compute.

This task involves writing the callback function rt_xxx_curve() that computes the curvature at a given point on the surface of a primitive such as;

  • superell
  • cline
  • extrude
  • grip
  • metaball
  • hrt.

There are numerous examples in our code where we compute the curvature for other primtives like the ellipsoid, sphere, elliptical parabola, etc.

References:

Code:

  • src/librt/primitives/table.c
  • src/librt/primitives/[PRIMITIVE]/[PRIMITIVE].c

 


Implement a primitive UV-mapping callback

BRL-CAD provides more than two dozen types of geometry "primitives" such as ellipsoids, boxes, and cones. Every primitive is described by a collection of callback functions, for example rt_ell_bbox() returns the bounding box dimensions for an ellipsoid. One of those functions describes a UV mapping of the object's surface, which is used for things like texture and bump mapping. An example of this is rt_ell_uv() in the src/librt/primitives/ell/ell.c source file for an ellipsoid. Several of our more complex primitive types (such as BoT, NMG, and BREP/NURBS) do not presently implement a UV-mapping function leading to unexpected runtime behavior.

This task involves implementing a UV-mapping callback for any of the primitives that do not already have a functional UV-callback defined. Note that this is an advanced task that might take you more than a couple hours if you don't have solid coding skills, but it's ultimately just a few lines of code. See other primitives that already implement a UV-mapping callback for reference.

References:

... UV-mapping for extruded sketches (EXTRUDE)

Code:

  • src/librt/primitives/extrude/extrude.c
  • src/librt/primitives/table.c
  • include/rtgeom.h

 

   

Implement a platform independent re-entrant sort function

The classic C library qsort() does not support a context parameter. A work around is to store the context information in a static variable. However, this solution is not thread save and may result in unpredictable behavior.

There are platform specific sort functions qsort_r() in incompatible versions for BSD and GNU and qsort_s() for MSVC. Your task is to implement a bu_sort() function for BRL-CAD which is platform independent.

Code:

  • src/libbu/sort.c

The new sort function could look like this:

void bu_sort(genptr_t array, size_t nummemb, size_t sizememb, int (*compare)(const_genptr_t, const_genptr_t, genptr_t), genptr_t context);

 


|}    

Solve fonts related bug in new wiki theme

BRL-CAD has been working on a new incarnation of the website and has developed a new wiki theme and wordpress theme. Wiki theme uses a font called 'open-sans' from google fonts directory. It's linked via CSS but it does not get loaded (we still see default serif all over the place). So your task will be to debug the CSS code and get Open Sans loaded.

Links:

 


   

Better placement of icons in wiki theme

BRL-CAD has been working on a new incarnation of the website and has developed a new wiki theme and wordpress theme. Wiki theme is responsive but has a small styling problem. On smaller screens icons near the search bar gets misplaced and unaligned. Your task would be to fix that. Task would include diving into sass file that corresponds to styling of this part of theme (given below) and adjusting spacing between icons to keep them aligned even at smaller screens.

Links:

 


Documentation and Training


Tasks related to creating/editing documents and helping others learn more about BRL-CAD

Add missing documentation (for any ONE command)

BRL-CAD is an extensive system with more than 400 commands and more than a million pages of documentation, but there are approximately 120 commands that are entirely undocumented:

a-d archer asc2g asc2pix bot-bldxf bottest brep_cube brep_simple brickwall btclsh burst bw-a bw-d bwish c-d chan_add clutter contours d-a damdf dauto dauto2 d-bw dconv ddisp d-f dfft d-i dmod double-asc dpeak dsel dsp_add dstat d-u dwin euclid_format euclid_unformat fbgammamod f-d fence fhor f-i g-adrt g-euclid1 g-jack globe g-off i-a i-d i-f ihist imod istat jack-g kurt lowp molecule nmgmodel nmg-sgp off-g pipe pipetest pix2g pix3filter pixcount pixelswap pixembed pixfields pixfieldsep pixflip-fb pixpaste pix-spm pix-yuv plstat pyramid rawbot remapid rlesortmap rletovcr room rtcell rtexample rtfrac rtrad rtsil rtsrv script-tab sketch solshoot sphflake spltest spm-fb ssampview syn tea tea_nmg testfree texturescale torii ttcp tube txyz-pl u-a u-bw u-d u-f umod ustat vcrtorle vegitation wall wdb_example xbmtorle xyz-pl yuv-pix

This task involves writing basic documentation for JUST ONE of those commands in the Docbook XML format. The command documentation should provide a one-sentence description, a detailed paragraph description (200+ words), explanation of all available command-line options, and one or more examples on how to use the command.

Code:

  • doc/docbook/system/man1/en/Makefile.am
  • doc/docbook/system/man1/en/*.xml

 

Write an article "BRL-CAD for dummies"

Although BRL-CAD has extensive documentation, still it needs a short and simple document which is particularly built for dummies.

This task involves writing a article named BRL-CAD for dummies. This article should start with the installation process, if there is any existing installation guide for dummies, provide a link to it. The main motive of this article to empower dummy to make his/her first model using BRL-CAD. One thing to be kept in mind while writing this article is that this article is mainly concentrated for dummies. So use simple language to an extent and if you need to mention some technical term, first explain that term.

The output of this task can be a pdf, html, doc, odt or any other document file that contains this article. Go through the link provided. Use screenshots and images to make it look attractive so that the reader is not bored.

Reference:

 

Translate "Contributors Guide To BRL-CAD" To Any Language

People interested in improving BRL-CAD sometimes find themselves lost in a sea of information. In all, BRL-CAD has more than a million words of documentation across hundreds of manual pages, dozens of tutorials and examples, hundreds of wiki pages, dozens of technical papers, and other resources. There are literally thousands of features and this can sometimes pose problems.

In 2013, a team of contributors got to California and worked on an entire book titled "Contributors Guide To BRL-CAD" in just a few days. This great resource needs to be translated to other languages to attract developers from other lingual backgrounds (who don't read English ) to contribute to BRL-CAD.

This task involves translating the chapters/sections of the "Contributors Guide To BRL-CAD" into a language of your choice such as Mandarin, French, Chinese, Spanish, German, Hindi, Arabic, Russian, etc. Chapters/Sections include

  • Feature Overview
  • Working with our Code
  • What code to work on
  • How to contribute
  • .... (Just to name a few )

The output of this task can be a pdf, html, doc, odt or any other document file that contains the translated article.Images in the original document (see link in Reference below) should not be changed ! only text should be.

Reference:

 


Write a "BRL-CAD Commands Quick Reference" document

There is already a command quick reference for BRL-CAD's MGED geometry editing tool, but there is not a similar document for BRL-CAD's 400+ command-line commands.

This task involves writing a quick reference document similar to the MGED quick reference but for BRL-CAD commands. The sheet should minimally include the following commands:

mged, rt*, *-g, g-*, fb*, *fb, nirt, remrt, rtsrv, asc2g, g2asc, dbupgrade, pix*, *pix, *-*, brlman, benchmark

References:

 

Doxygen cleanup

BRL-CAD uses Doxygen for most API documentation but the comment blocks are not optimally set up for Doxygen output.

This task involves cleaning up the Doxygen comments in the library so that useful reports and API documentation automatically generated (correctly, completely, and cleanly). Verify/fix any Doxygen syntax. Verify/fix groups so that functions are organized neatly and all contained within a group. Provide patches that give clean (PDF) output from Doxygen.

References:

... doxygen cleanup for LIBBU

There are approximately 300 documented API function calls in LIBBU.

Code:

  • include/bu.h
  • src/libbu
  • misc/Doxyfile

 

... doxygen cleanup for LIBWDB

There are approximately 100 documented API function calls in LIBWDB.

Code:

  • include/wdb.h
  • include/raytrace.h
  • src/libwdb
  • misc/Doxyfile

 

... doxygen cleanup for LIBRT

There are approximately 1000 documented API function calls in LIBRT.

Code:

  • include/raytrace.h
  • src/librt
  • src/librt/primitives
  • src/librt/comb
  • src/librt/binunif
  • misc/Doxyfile

 

Write up Wiki page tutorial on our Volumetric Primitive

BRL-CAD provides a couple dozen distinct primitives. Each primitive is defined by a set of parameters. Several of the more complex primitives have a wiki page describing them in more detail with an example on how to create them.

This task involves writing up a page on the VOL primitive. Figure out how to use it (see the "in" command), create an example input data set, and write up a wiki page on exactly what steps are needed similar to our other wiki pages:

References:

Show how to create a VOL with at least two layers/slices. Include images like the other examples. Put the write-up at http://brlcad.org/wiki/VOL

 

Write a wiki tutorial on how to create a polygonal mesh (NMG) manually

BRL-CAD provides a couple dozen distinct primitives. Each primitive is defined by a set of parameters. Several of the more complex primitives have a wiki page describing them in more detail with an example on how to create them.

This task involves writing up a page on the NMG polygonal mesh primitive. Figure out how to use it (not a simple task, will require some trial and error), create an example input, and write up a wiki page on exactly what steps are needed similar to our other wiki pages:

References:

Note the "facetize" command in mged will convert an existing object into NMG format. The get/put commands should help from there like the sketch tutorial.

Show how to create an NMG cube or wedge or similar simple shape. Include images like the other examples. Put the write-up at http://brlcad.org/wiki/NMG

 

Fix Image Formatting in BRL-CAD's DocBook Documentation (any ONE large document or 4 smaller documents)

The majority of BRL-CAD's documentation is defined as DocBook files, from which other formats (HTML, PDF, man page, etc.) can be generated. PDF files present a particular challenge, and have some very specific requirements to achieve "good" formatting.

BRL-CAD's DocBook files need to uniformly use a style of image inclusion that is aware of what "role" the image is supposed to serve. A "basic" image inclusion example looks like this:

 <mediaobject>
   <imageobject>
     <imagedata align="center" fileref="../../lessons/en/images/img.png" format="PNG"/>
   </imageobject>
   <caption>
     <para>
       Caption goes here.
     </para>
   
 </mediaobject>

This task involves switching image inclusions that use the above style to something like the following:

 <mediaobject>
   <imageobject role="html">
     <imagedata align="center" fileref="../../books/en/images/img.png" format="PNG"/>
   </imageobject>
   <imageobject role="fo">
     <imagedata align="center" fileref="../../books/en/images/img.png" format="PNG"/>
   </imageobject>
   <caption>
     <para>
       Caption goes here.
     </para>
   
</mediaobject>

The "role" flag to imageobject provides the opportunity to specify different image formatting options when the output is HTML (role="html") or PDF (role="fo").

The captions should be preserved as above on mediaobjects that have them, but mediaobjects without a caption should also be converted and there is no need to add a caption in such cases.

Any patch that makes changes to the DocBook sources should result in a successful "make doc" build test. This won't generate PDF documents, but it will validate the XML files and produce HTML - remember that introducing breakage means the patch won't be accepted.

Remember, the tasks are simply to do the above conversion for all images in the file or files, not to introduce PDF specific formatting. Formatting fixes will be needed, but they are very much "case by case" and will take both additional time and a working Apache FOP installation, as well as knowledge of how to enable PDF generation. If all image inclusions have been converted successfully and a student is interested in actually fixing the formatting, please discuss it with us on IRC or the mailing list.

References:

  • doc/docbook/books/en/BRL-CAD_Tutorial_Series-VolumeIII.xml

Code:

  • doc/docbook

 

Make a step by step tutorial for creating BRL-CAD model

BRL-CAD is said to have an expert friendly User Interface so new users mostly have a tough time getting around it's UI and making models. So anything link Django poll app tutorial https://docs.djangoproject.com/en/dev/intro/tutorial01/ would be very helpful.


 

Find 5 bugs in OGV

Online Geometry Viewer is a web based application with which you can see 3D .g models in browser without the use of any plugins. Your task will be to deploy OGV locally and find 5 bugs or errors in it.

Links: https://github.com/BRL-CAD/OGV-meteor/

 

Find 5 coding guidelines violations in OGV

Online Geometry Viewer is a web based application with which you can see 3D .g models in browser without the use of any plugins. Your task will be to deploy OGV locally, look into code and see if any coding guidelines are violated.

Links: https://github.com/BRL-CAD/OGV-meteor/

 


Outreach and Research


Tasks related to community management, outreach/marketing, studying problems, and recommending solutions

 

Profile NURBS prep performance

BRL-CAD implements support for rendering of NURBS representation geometry. If you import a solid 3DM or STEP format model into BRL-CAD, it will import as BREP/NURBS geometry. Opening that geometry in BRL-CAD's MGED editor will tell you what objects are available and our 'rt' tool will raytrace it. When geometry is ray traced, it first goes through a "prep" phase and then it starts shooting rays. Our prep phase is entirely unoptimized so we'd like to know where all the time is presently being spent during prep..

This task involves importing some NURBS geometry into BRL-CAD and ray tracing that geometry with a profiler watching our prep performance. Any profiler will do, including gprof, but a performance monitor like oprofile or the Mac "Instruments" application (or Shark) are preferred.

Learning how to use a profiler is beyond the scope of this task, so it make take you considerably longer to provide us with useful information if you've never run a profiler before.

To capture prep performance, you will need to import some fairly complex geometry. You should be able to search google with "filetype:3dm" or "filetype:step" or find something on grabcad.com to import

Running "tops" within mged will tell you what geometry is available for rendering.

Running "rt -o file.png -s32" on the system command line (not inside mged) should minimize the ray overhead or you can specifically isolate the prep phase we care about. Prep is the time between when rt is run where it opens a window until the first pixels are fired and pixels start filling in.

 

Continue investigating GMP integration

BRL-CAD uses a fastf_t typedef for most all math operations that is usually a "double" floating point type. We would like to provide the option for resorting to exact arithmetic if possible by merely redefining fastf_t to a C++ type sufficiently overloaded to behave the same. You should be proficient with C++ operator overloading to take this work on. This task is a continuation of a prior GCI task (read it in full!):

http://www.google-melange.com/gci/task/view/google/gci2012/7946218

This task involves testing compilation with a C++ class with overloaded operators such that vmath macro calls still work as well as a sampling of LIBBN API function calls without major changes to the original code. A perfect example case study would be creating the class then testing whether bn_dist_pt3_pt3() and bn_mat_determinant() compute correctly for values that cannot be exactly represented with floating point arithmetic.

Building on the previous GCI task work, take it to the next step. Try setting a vector to 1/3, 1/3, 1/3 and 0.1, 0.1, 0.1 and get proper values to print. Change the V3ARGS() macro if needed. If that all works, try to get bn_dist_pt3_pt3() to work. Report and discuss your progress.

 

Design a T-Shirt for BRL-CAD

This task involves designing a T-Shirt for BRL-CAD. Use your designing skills to design a T-Shirt for BRL-CAD. You can use the current BRL-CAD logo, or you may tweak it. Be creative while designing this T-Shirt. It would be good if the design has some special meaning.

Logo References

 

Design a coffee mug for BRL-CAD

This task involves designing a coffee mug for BRL-CAD. Make it look good, so that one can use it while working on BRL-CAD. Look over some great coffee mug designs before starting to work on this. It would be great if the design on coffee mug has some special meaning.

Logo References

 

Design BRL-CAD sticker

This task involves designing a BRL-CAD sticker. The design should be simple and sleek. The concept of sticker should be clear and also it should be creatively presented. Get inspired from some sticker designs but choose your own imagination while designing the sticker. There is no bound for shape of sticker, it can be rectangular, circular or even irregular. The only thing that matters is that it should look good.

Logo References

 

Design BRL-CAD phone/tablet back cover

This task involves designing a BRL-CAD phone/tablet cover. While submitting your design, provide the sample phone cover, tablet cover with the design and rendered png or jpg image of the sticker design. Try to have a special meaning of design, and the concept should be creatively illustrated.

Logo References

 

Design a wallpaper set for BRL-CAD

This task involves designing a set of wallpapers for BRL-CAD. The central idea of each wallpaper should represent any feature of BRL-CAD. Try to design a minimum of 5 wallpapers but if you have more than 5 designs than you are welcomed.

Try to different resolutions of each wallpaper.

Check the following wallpapers for inspiration.

Logo References


 

Create Iron Man Arc Reactor Model in BRL-CAD

This task involves creating Arc Reactor as seen in hollywood movie Iron-Man. You will have to create two versions of the Arc Reactor one glowing and another non glowing.

Check this model for inspiration



 

Tweak BRL-CAD logo to wish New Year

You might have heard and praised those google doodles we occasionally see on google.com on special days. This task is all about tweaking BRL-CAD logo to wish New Year. You may have a look at google doodles but don't entirely copy their style. I am sure your creative mind will get something much better. Make sure this tweak should be tweaked version of current logo and not entirely new logo.

Tip: Search for some global events occurring in 2015 and design accordingly. Also keep the letters 2,0,1,5 in mind while designing. ;)

Also output of this task shall be the png file of your work and the raw file but don't upload the raw file(.psd, .xcf or some other) for review of this task. We will ask for it later, when the design is finalized.

Gallery of all google doodles



 

Tweak BRL-CAD logo to wish Merry Christmas

You might have heard and praised those google doodles we occasionally see on google.com on special days. This task is all about tweaking BRL-CAD logo to wish Christmas. You may have a look at google doodles but don't entirely copy their style. I am sure your creative mind will get something much better. Make sure the output of this task should be tweaked version of current logo and not entirely new logo.

Also output of this task shall be the png file of your work and the raw file but don't upload the raw file(.psd, .xcf or some other) for review of this task. We will ask for it later, when the design is finalized.

Gallery of all google doodles



Quality Assurance


Tasks related to testing and ensuring code is of high quality

Fix single-precision floating point crash

By default, all of BRL-CAD compiles using double-precision floating point arithmetic. We provide a simple typedef, however, that converts almost the entire system over to single-precision floating point. This compilation mode was recently cleaned up and tested, but a bug was found. The problem is reproduced very simply by compiling in single precision mode and running our "rt" ray tracer tool.

To compile in single precision, edit the include/bn.h header file and change the fastf_t typedef from double to float. To reproduce the bug, compile BRL-CAD and write this out to a text file named star.view:

viewsize 2.500000000e+05;
eye_pt 2.102677960e+05 8.455500000e+04 2.934714650e+04;
viewrot -6.733560560e-01 6.130643360e-01 4.132114880e-01 0.000000000e+00
        5.539599410e-01 4.823888300e-02 8.311441420e-01 0.000000000e+00
        4.896120540e-01 7.885590550e-01 -3.720948210e-01 0.000000000e+00
        0.000000000e+00 0.000000000e+00 0.000000000e+00 1.000000000e+00 ;
start 0;
end;

Then run rt feeding it that view script as input. This is an example how to run within the gdb debugger:

gdb path/to/bin/rt
...
(gdb) run -F/dev/X -M .cmake/share/db/star.g all < star.view

At this point, rt should crash due to an infinite recursion. A backtrace in the debugger will show lots and lots of calls to rt_shootray() and light_hit().

This task involves investigating and preventing the crash. Provide a patch that fixes the bug.

References:

  • man gdb
  • brlman rt

Code:

  • src/librt/shoot.c
  • src/liboptical/sh_light.c

 

Fix closedb

BRL-CAD geometry editor application (mged) has several hundred commands including two very simple commands for opening and closing a geometry database file. While the user rarely ever needs to close the file, as all changes are always immediately saved, it can be of use to scripting applications. However, at some point in the recent past, the closedb command was horked. It's undoubtedly something very simple but we haven't bothered to look due to other priorities. You can fix it. If you run these simple steps within graphical mged, you should see how commands stop working after calling closedb:

 mged> opendb test.g y
 mged> make sph sph
 mged> l sph
 mged> closedb
 mged> make sph sph
 mged> opendb test.g
 mged> l sph
 mged> exit

Provide a patch that fixes the bug or tell us which SVN revision introduced the bug. Make sure you can reproduce the bug before claiming this task, which presumes you know how to download/install BRL-CAD from a source distribution.

Code:

  • src/mged/mged.c

 

Create a utility library (LIBBU) API unit test

There are more than 300 library functions in our core LIBBU library. As a core library used by nearly every one of BRL-CAD's tools, testing those functions for correct behavior is important.

This task involves implementing new unit tests for any of LIBBU's source files that do not already have a unit test defined. The test should run all of the public functions and be hooked into our build system. We have lots of existing unit tests to follow as examples.

References:

  • include/bu.h
  • src/libbu/*.c
  • src/libbu/tests/*.c

Code:

  • src/libbu/tests/[TEST].c
  • src/libbu/tests/CMakeLists.txt


... unit test for LIBBU bomb.c

 

Create Numerics library (LIBBN) API unit tests

There are more than 300 library functions in our core LIBBN library. As a core library used by nearly every one of BRL-CAD's tools, testing those functions for correct behavior is important.

This task involves implementing new unit tests for any of LIBBN's source files that do not already have a unit test defined. The test should run all of the public functions and be hooked into our build system. We have lots of existing unit tests to follow as examples.

References:

  • include/bn.h
  • include/plot3.h
  • include/vmath.h
  • src/libbn/*.c
  • src/libbn/tests/*.c <-- check this directory for examples
  • src/libbu/tests/*.c <-- Note: Also check this too for more examples.

Code:

  • src/libbn/tests/[TEST].c
  • src/libbn/tests/CMakeLists.txt

Note A valid task will constitute writing a basic test for each function in the following libbn/ files.

... unit tests for LIBBN anim.c

 

  • Useful resources
 ->coming!

... unit tests for LIBBN axis.c

 

... unit tests for LIBBN qmath.c

 


  • Useful links and Resources
-> Coming!

... unit tests for LIBBN rand.c

 

... unit tests for LIBBN vector.c

 

  • Useful links and resources

-> To be added.

Find, reliably reproduce, and report any bug in Archer

Archer is our new modeling interface and a soon to merge with our long-standing MGED geometry editor. It undoubtedly has bugs. It's your job to find one, but do so in a manner that is so obvious that one of the other devs will be able to instantly reproduce the bug given your specific instructions. Find a way to make archer crash, become unresponsive, or otherwise behave incorrectly. You will have to explore the tool with minimal documentation.

This task involves filing a bug report with verifiable and reproducible steps that clearly demonstrate the bug. It can't be a bug already reported or otherwise documented nor can it be merely behavior you don't like.

References:

 

Reproduce any 10 unconfirmed open bug reports

BRL-CAD presently has approximately 75 open bug reports of which 50 are unassigned. Read the comments and status to see if the bug has been confirmed/reproduced.

This task involves going through those reports and REPRODUCE at least 10 of the ones that have not been confirmed. When you can reproduce the issue being reported, you'll comment on the thread to state as much and attach any data you used to reproduce the crash.

References:



User Interface


Tasks related to user experience research or user interface design and interaction


 

Create an ISST screenshot or animation

Everyone loves to see screenshots and animations of software in action. We use both in our marketing and outreach. See some of the examples below that we already have.

Create an awesome screenshot and/or animation of our 'isst' tool in action. It's an interactive geometry viewer interface. It should be graphically interesting and give some sense of capability. You should import a visually complex and interesting model with LOTS of polygons and detail.

References:

Note that we have several screenshot tasks. Note you may have to go through some or our basic MGED tutorials (see docs section on our website) just to be able to display geometry. Finally, give others a chance if you already completed one of the other screenshot tasks. ;)

 

Categorize all of BRL-CAD's commands into a spreadsheet

BRL-CAD is a suite of more than 400 processing tools, image tools, geometry converters, and more. There is an existing spreadsheet that characterizes all of the available commands in terms of inputs, outputs, and options, but there is insufficient characterization of BRL-CAD's commands as to how they logically group and work together.

This task involves building up a spreadsheet that lists all of our commands, describing a finite set of command categories, and characterizing all commands into those categories while filling in the spreadsheet with details for each command.

References:

  • A spreadsheet template will be provided.

 

Design a Cover Photo for Facebook page (and other social networks)

BRL-CAD got it's logo changed, and it's website is undergoing a change. So this re-branding of BRL-CAD also requires a good, well designed and attractive cover photo for the BRL-CAD's Facebook page or other Social Media Appearances. It should feature a good tagline telling some killer feature of BRL-CAD, BRL-CAD's new logo and/or some illustration/image regarding the feature highlighted in tagline.

It should be consistent with the color scheme of our new website design.

New website design

 

Design a banner ad for BRL-CAD

BRL-CAD is one of the oldest open source communities. This community has a good following, so we want to give a chance to everyone so that they can show their support to the community by adding a banner ad in their website. You have to create a banner ad that can be embedded in the website by copy pasting some simple lines of code (basically an iframe).

Such a banner ad can also be used in various sections of our own website.

The task requires you to create a CSS3 based animated horizontal and vertical banner add, highlighting some feature of BRL-CAD or making some call to action. This call to action can be joining mailing list, or signing up for community, or link to latest post etc.

For Inspiration and tutorial refer

 

Creating Motion Typography video for BRL-CAD

BRL-CAD has a lot of great features that can be highlighted. A motion typography video highlighting these features would be a wonderful addition to the front page of website.

This task requires you to create a motion typography video that will convince user to give BRL-CAD a try, it could be titled something like "x reasons to choose BRL-CAD" or anything similar (give your creative minds a flight). The video should not be more than 2 minutes.

For inspiration about what a motion typography, see

 

Create a screen-cast for BRL-CAD

Getting started with BRL-CAD is sometimes not so smooth. A screen-cast giving a tour of BRL-CAD's GUI and the steps involved in creating the first model will make it easy for users to get started.

For this task you need to install BRL-CAD on your computer. Create a very basic model in it and record your screen as you create the model. It should also give a tour of BRL-CAD's workspace. You can choose model of your choice. Keep something very basic and easy for the first time users.


 

Loading Google charts from API

A basic wrapper of GCharts has been implemented a while ago : https://bitbucket.org/suryajith/benchmark/src/a27dd8c05d6819a527650e06a63076599d2e0d66/libs/charting.py?at=default With the google charts improving their API system which wasn't around then, see if the code could be optimized so to get the charts the optimal way.

Reference:


Design a hall of fame for BRL-CAD developers

We love our developers and want to have a special place in it's website to thank and motivate hard working folks behind BRL-CAD. Your task would be to use an image manipulation software such as GIMP or Photoshop and design a hall of fame page for developers. It should have avatars and names of all the developers. For inspiration you can take a look at http://underscores.me/. You are free to experiment and design anyway you want, just make sure that the color scheme and font-scheme is consistent with the new BRL-CAD web design.

Links:



When You're Done


For non-code, just send us your file(s). For code changes, you will be expected to provide a patch file. Make sure you read your patch file before submitting it. Make sure your patch file will apply cleanly to an unmodified checkout of BRL-CAD:

svn co https://brlcad.svn.sourceforge.net/svnroot/brlcad/brlcad/trunk brlcad.edit
cd brlcad.edit
# make changes
svn diff > ~/my.patch
# read ~/my.patch file with text editor
cd ..
svn co https://brlcad.svn.sourceforge.net/svnroot/brlcad/brlcad/trunk brlcad.fresh
cd brlcad.fresh
patch -p0 < ~/my.patch
# submit your patch file to our patches tracker