kglotfelty / adaptivebin

Various adaptive binning routines for use in CIAO

Adaptive Binning Routines

This repo contains several adaptive binning routines for use in CIAO. These include

• contour_map : follows local contours
• dragon_scales : overlapping shapes
• grow_from_max : Voronoi tesselation map
• hexgrid : regular hexagonal grid
• mkregmap : stack of regions to a map
• pathfinder : steepest ascent
• centroid_map : iterative centroid map

Users may also be interested in the compiled tools

• dmnautilus (upgraded from CIAO version)
• dmradar polar version of dmnautilus

These are C programs that need to be built into your CIAO installation. (You do not have to build all of CIAO or even have the CIAO source code installed).

Installation

Users must have CIAO installed and have already sourced the setup script.
Then if you installed CIAO using conda just

git clone https://github.com/kglotfelty/AdaptiveBin
cd AdaptiveBin
python setup.py install 

or if you installed CIAO using ciao-install then

git clone https://github.com/kglotfelty/AdaptiveBin
cd AdaptiveBin
python setup.py build -f -e "/usr/bin/env python" install -f --prefix=$ASCDS_CONTRIB

You will then need to re-index your ahelp to get access to the help files

ahelp -r

Banner

In the banner image above, from left to right we have original data, dmnautilus (original), contour_map, grow_from_max, pathfinder, dragon_scales, hexmap, mkregmap, centroid_map, and dmradar

adaptivebin's Issues

Map2reg clobber

AdaptiveBin/map2reg

Line 107 in b61fe29

allout.write( pars["outfile"], fits=True )

Add clobber here

dragon_scales gradient

w.r.t. box vs. diamond ...

We could compute the gradient of the image and rotate the polygon.

That then may make it more natural to create N-sided regular polygon (ie hexagons) ; possibly with rotation offset (ie triangle up vs. triangle down)