Software package for asteroid shape reconstruction from disk-resolved observations
C Python Groff HTML Makefile C++ Other
Latest commit a12a010 Dec 7, 2016 @matvii committed on GitHub Fixed typo
Permalink
Failed to load latest commit information.
Hertha Added example of chordweight file Jul 5, 2016
Kissfft
Utils
iniparser
wcstools-3.9.2
135_1.ini
135_1_oct.ini
135_2.ini Initial release Jun 28, 2016
135_oct.ini
AdjFacet.c Initial release Jun 28, 2016
Calc_FTC.c
Calculate_AO.c
Calculate_AOs.c Initial release Jun 28, 2016
Calculate_HF.c Initial release Jun 28, 2016
Calculate_HFs.c Initial release Jun 28, 2016
Calculate_RDs.c
Calculate_Radiance.c Initial release Jun 28, 2016
Calculate_Range_Doppler.c Initial release Jun 28, 2016
Calculate_Temp.c
Calculate_lcs.c
FacetsOverHorizon.c Initial release Jun 28, 2016
FindActualBlockers.c
Fit_Occ.c Improved handling of miss chords Sep 11, 2016
Hertha.occ Initial release Jun 28, 2016
Hertha_Occ.png
Makefile
Makefile.icc
README.md Utils for plotting shapes Oct 28, 2016
README_occultations.txt
SH.c
adam.c Initial release Jun 28, 2016
adam.ini
adam.pdf
area_reg.c
calc_image_fft.c Initial release Jun 28, 2016
calc_image_fft_sinc.c Initial release Jun 28, 2016
calc_image_fft_unnormed.c
calculate_OCs.c
calculate_lcs.c support for albedo variegation Jul 30, 2016
calculate_lcurve.c
convex_reg.c Initial release Jun 28, 2016
dihedral_angle.c
dihedral_angle_reg.c
find_chord.c Initial release Jun 28, 2016
find_neighborhood.c Initial release Jun 28, 2016
fit_oct_model_to_LC_AO.c
fit_subdiv_model_to_LC_AO.c Minor tweaks and fixes Oct 11, 2016
generate_sphere.c
globals.h Some minor tweaks Sep 12, 2016
is_in_triangle.c
lcgen.c Utils for plotting shapes Oct 28, 2016
libiniparser.so.1
line_intersect.c
map_sqrt_subdiv_limit.c Initial release Jun 28, 2016
matrix_ops.c
matrix_ops.h Added support for occultation chord offsets Jul 10, 2016
mshape.txt Initial release Jun 28, 2016
num_of_threads.h
octantoid_reg.c
octantoid_to_trimesh.c
parse_ini.c Minor tweaks and fixes Oct 11, 2016
phase_function.c
prepare.h Initial release Jun 28, 2016
process_ao_images.c
process_rd_images.c
read_ephm_data.c
read_occ.c
readfits.c Initial release Jun 28, 2016
readfits_rd.c Initial release Jun 28, 2016
readshape.c
rotate.c Initial release Jun 28, 2016
shape.txt
sinc.c
sqrt3_subdiv.c
structs.h Initial release Jun 28, 2016
thermal.c Expanded documentation, thermal utility. Aug 30, 2016
triangulate_sphere.c Added support for calibrated lightcurves Jul 23, 2016
utils.c
utils.h

README.md

ADAM: All-Data Asteroid Modelling

ADAM is a program for 3D shape reconstruction of asteroids from disk-resolved observations. Current version supports lightcurves, albedo variegation, adaptive optics, occultations, and range-Doppler radar images. Raw images are used directly, boundary extraction is not required. Source code for thermal modelling is also included, but not currently integrated into main program.

Required libraries

KissFFT, Iniparser and Wcstools folders are included for convenience; they come with their own licenses.

Building

  • Build Iniparser
  • Build Wcstools
  • Change Makefile to reflect installed libraries, i.e. change reflapacke, reflapack, atlas and atlcbas.
  • make adam

This program has been tested on Linux with gcc 5.3.

Usage

ADAM uses ini files to process data. For an example of asteroid Hertha, 135_1.ini and 135_1_oct.ini (usage: ./adam 135_1.ini). For all available config options and short descriptions, see the file Adam.ini. Adam.pdf contains some useful tips. For theoretical background, read Shape reconstruction from generalized projections.

License

This software is licensed under CC Attribution 4.0 international License.

If you use ADAM in your research, please cite Viikinkoski, M; Kaasalainen, M.; Durech, J.: ADAM: a general method for for using various data types in asteroid reconstruction, A&A Vol 576, 2015.

Contact

Bug reports, data, feature suggestions and comments are welcome.

Matti Viikinkoski (matti.viikinkoski@gmail.com)

Updates

10.7.2016

  • Added support for occultation chord offsets
  • Added support for optimizing occultation chord offsets

23.7.2016

  • Added support for calibrated lightcurves

30.7.2016

  • Support for albedo variegation

29.8.2016

  • Documentation expanded
  • Utility program (make thermal) to calculate temperature distribution of an asteroid using FFT. Shadowing effects are taken into account.
  • Makefile for the intel compiler. ICC produces considerably faster code than the GCC.

11.9.2016

  • Occultations: Improved handling of negative chords

29.10.2016

  • Python and Matlab utilities for displaying shapes and plotting projections and occultations. See Readme in the Utils directory.

TODO

  • Hapke scattering law
  • Integration of thermal modelling stuff into the main program