NASAsAsteroidDataHunter

UserGuide


Preface
AboutThisGuide
IntendedAudience
RevisionHistory
InstallationProceduresforWindows
Prerequisites
Security
Installation
UninstalltheApplication
RuntheApplication
InstallationProceduresforMac
Prerequisites
Security
Installation
UninstalltheApplication
RuntheApplication
InstallationProceduresforLinux
Prerequisites
Installation
UninstalltheApplication
ViewDashboard(ApplicationHomepage)
SelectDataFilestoHunt
StartHuntingData
DisplayDataHuntResults
ViewSearchHistory
FilterSearchData
ViewSearchDetails
SubmittoMPC
ReportNewComet
ViewDataontheSkyPage
FilterSkyData

1. Preface
1.1 AboutThisGuide
WelcometotheAsteroidDataHunterApplicationuserguide.Pleaseusethisguideasastarting
pointandreferenceforallfunctionsandcapabilitiesoftheAsteroidDataHunterApplication.
1.2 IntendedAudience
ThisguideisintendedfortheenduseroftheAsteroidDataHunterApplication.Assuch,itwill
addressbasicfunctionalityandintendeduseoftheAsteroidDataHunterApplication.
1.3 RevisionHistory
ThisisthefirstrevisionoftheendusermanualfortheAsteroidDataHunterApplication.

2. InstallationProceduresforWindows
2.1 Prerequisites
Pleasemakesurethefollowingprerequisiteshavebeenmet:
MustberunonWindows7orhigher(usingParallelsonaMacwillnotwork)
Yourcomputermusthaveatleast3GBofram.

2.2 Security
Ifyoureusingwindows,yourcomputermay:
1. Informyouthatyoucantinstalltheprogramtoaspecificareabecauseitsbeendownloadedfrom
theInternetinwhichcase,wesuggestyouinstallittoafolderonyourdesktop.
2. InformyoutoUnblocktheappsothatitcanbeinstalledpleaseconfirmandorunblockthatapp
sothatitcanproperlybeinstalled.

Pleasenotethatthisisanartifactofyourcomputerssetting,andnotallcomputerswilldisplaythese
messages.

2.3 Installation
Theinstallationfortheapplicationisprettystraightforward.ItisassumedthattheuserisusingWindows7
orabove,andthemachinehasatleast3GBofRAM.

Onceyougettheinstallationfile"
ADHWindowsInstaller.zip ",pleaseunzipittoyourdesktop,thengo
intoitssubdirectory"
installerdist
",anddoubleclick"AsteroidDataHunterInstaller.bat "toinitiatethe
installationprocess.


Itwillstartthecommandlinetool.

Thentheinstallationstartpagewillbepresented.

Clickthe"Next"buttontwice,you'llseethelicenseagreementpage.Bydefault,the"Next"buttonis
disabled.Youhavetocheckthe"Iacceptthetermsofthislicenseagreement"optiontoenablethe"Next"
button.


Clickthe"Next"buttontoproceed.Thenitwillallowtheusertoselecttheinstallationpath.Clickthe
"Browse..."buttontochangetheinstallationpath.


Afterselectingapath(e.g.C:\NASA),clickthe"Next"button.Itwilldisplayawarningpopup,click"Yes".
Thenthewarningpopupwillbedismissed.

Clickthe"Next"button.Itwilldisplaypreselectedpackswhichneedtobeinstalled.


Clickthe"Next"button.Itwillstarttoinstalltheapp.Theprogressscreenlookslike:


Waitforseveralminutes,onceitisdoneinstalling,you'llseethesuccessmessage.


Optionally,youcanclickthe"Next"buttontosetshortcutsorjustclickthe"Quit"buttontoquitthe
installation.

Youcanseethattheapplicationisinstalledunderthechosenpath.Gointothechosenpath("C:\NASA"in
thiscase),theinstalledfilesandfolderslooklikebelow:

2.4 UninstalltheApplication
Touninstalltheapplication,navigatetothefolderwhereyouinstalledtheapp.GototheUninstall
subdirectoryandclickUninstaller.jartouninstalltheapp.

2.5 RuntheApplication
Oncetheapplicationisinstalled,it'stimetorunit.Gointotheinstallationpath,thendoubleclickthe
"start.bat
"filetoruntheapplication.

Itwillstartthecommandlinetoolandthentheapplicationwillbeopenedinthedefaultbrowser.

NOTE:Pleasemakesuretokeepthecommandlinewindowopenwhenusingtheapp,otherwisethe
appwillnotfunction.

3. InstallationProceduresforMac
3.1 Prerequisites
Pleasemakesurethefollowingprerequisiteshavebeenmet:
MustberunonMacOS10.10.2orhigher
Yourcomputermusthaveatleast3GBofram.

3.2 Security
Ifyoureusingwindows,yourcomputermay:
3. Informyouthatyoucantinstalltheprogramtoaspecificareabecauseitsbeendownloadedfrom
theInternetinwhichcase,wesuggestyouinstallittoafolderonyourdesktop.
4. InformyoutoUnblocktheappsothatitcanbeinstalledpleaseconfirmandorunblockthatapp
sothatitcanproperlybeinstalled.

Pleasenotethatthisisanartifactofyourcomputerssetting,andnotallcomputerswilldisplaythese
messages.

3.3 Installation
Theinstallationfortheapplicationisprettystraightforward.ItisassumedthattheuserisusingMacOS
10.10.2orabove,andthemachinehasatleast3GBofRAM.

Onceyouvedownloadedtheinstallationfile,pleaseunzipittoyourdesktop,thengointoitssubdirectory
anddoubleclick"
asteroidinstallermac.jar"toinitiatetheinstallationprocess.

Thentheinstallationstartpagewillbepresented.


Clickthe"Next"buttontwice,you'llseethelicenseagreementpage.Bydefault,the"Next"buttonis
disabled.Youhavetocheckthe"Iacceptthetermsofthislicenseagreement"optiontoenablethe"Next"
button.


Clickthe"Next"buttontoproceed.Thenitwillallowtheusertoselecttheinstallationpath.Clickthe
"Browse..."buttontochangetheinstallationpath.


Afterselectingapath,clickthe"Next"button.Itwilldisplayawarningpopup,click"Yes".Thenthewarning
popupwillbedismissed.


Clickthe"Next"button.Itwilldisplaypreselectedpackswhichneedtobeinstalled.


Clickthe"Next"button.Itwillstarttoinstalltheapp.Waitforseveralminutes,onceitisdoneinstalling,you'll
seethesuccessmessage.

3.4 UninstalltheApplication
Touninstalltheapplication,navigatetotheApplicationfolder,andremovethedirectorywhereyouinstalled
theapplication.

3.5 RuntheApplication
Oncetheapplicationisinstalled,it'stimetorunit.GotoFinder,andenterTerminal.TheTerminalappwill
thenlaunch.GototheApplicationsfolder,locatetheappfolder,grabstart.sh,anddragstart.shintothe
terminalwindow.Thiswillthenlaunchtheapplicationwithinyourdefaultbrowser.

NOTE:Pleasemakesuretokeeptheterminalwindowopenwhenusingtheapp,otherwisetheapp
willnotfunction.

4. InstallationProceduresforLinux
4.1 Prerequisites
Pleasemakesurethefollowingprerequisiteshavebeenmet:
MustberunningLinuxUbuntu
Yourcomputermusthaveatleast3GBofram.

4.2 Installation
Theinstallationfortheapplicationisprettystraightforward.ItisverysimilartotheMacOSXinstallation.
Herearetherequiredsteps:
1. Downloadthe.tarfile
2. Unzipthe.tar
3. Gointothefolder
4. Rightclickon"asteroidinstallerlinuxubuntu.jar",selectProperties,andthenselectthe
Persmissionstab.
5. Checkthecheckboxnextto"Allowexecutingfileasprogram"
6. Closethepropertieswindow
7. Nowdoubleclick"asteroidinstallerlinuxubuntu.jar"andtheinstallerwilllaunch.
8. AllstepsfromtheWindowssectionandonwardsmatchtheLinuxinstallerinstructions.
9. Gototheinstalledfolder.
10. Rightclick"start.sh"andseletProperties.
11. GotothePermissionstab.Makesure"Allowexecutingfileasprogram"ischecked.
12. OpenTerminal
13. Drag"start.sh"intotheTerminalwindowandhitenter.
14. Theappwilllaunch.

4.3 UninstalltheApplication
Theinstallationfortheapplicationisprettystraightforward.ItisverysimilartotheMacOSXinstallation.
Herearetherequiredsteps:
 1. Gotothefolderwhereitwasinstalled.
2. Rightclickon"uninstaller.jar",selectPropertiesandmakesure"Allowexecutingfileasprogram"is
checked.Saveandclosethepropertieswindow.
3. Doubleclick"uninstaller.jar"tolaunchtheuninstallerandremovetheprogram.

5. ViewDashboard(ApplicationHomepage)
Thehomepagewillbedisplayedafterlaunchingtheapplication.Therewillbe3tabsavailable:
DASHBOARD,SEARCHandSKY.Thedefaulttabis"DASHBOARD",whichisthehomepageofthe
application.

NOTE:Theappdoesnotcomeprebundledwithtestdata.Todownloadtestimages/data,please
usetheTestImageslink .
here

5.1 SelectDataFilestoHunt
Theusercanclickthe"BROWSE"buttontoselectdatafilestohuntdata.Itisrequiredthattheuserhasto
selectexactly4filesonetime.

Inordertoselectmultiplefiles,you'llneedtoholdthe"Ctrl"button(forWindows)orthe"Command"button
(forMac)inthefilesbrowser.


Afterselecting4filessuccessfully,itwilldisplaythechosenfilesname(
commaseparated
)inthetextfield.

NOTE:Theappdoesnotcomeprebundledwithtestdata.Todownloadtestimages/data,please
usetheTestImageslink
here
.

5.2 StartHuntingData
Theusercanclickthe"STARTHUNTING"buttontostartdatahuntingafterselecting4datafiles.

Itwilldisplaythedatahuntingprogresswithapercentindicator.

Whenthedatahuntprocessisfinished,itwilldisplaytheresults.Itlookslike:

5.3 DisplayDataHuntResults
Clicking"OK"willclosethepopup.Itwillthendisplaythedatahuntresults.Thelatestresultssectionand
searchhistorysectionwillbeupdatedwithhuntdata.

Theusercanclickanynumberbuttontoviewtheimage:

Theusercanhoverthecursoronanypointoftheimagetozoomin:


Theusercanclick buttontoautomaticallyplayall4imagesinorder.Afterthat,thePlaybuttonwill

changetothePausebuttonwhichcanpausetheautomaticplaying:

Theusercanclick buttontoinverttheimage.

Theusercanadjustthecontrastusingtheslidebar:

Therewillbea"SEARCHHISTORY"sectiondisplayedwiththehuntdata.Theusercanclick"MORE>"
buttontoviewmoreresults.Eachrowinthetablecanbeclickedtoviewitsdetails.Pleaserefertochapter
4.2formoredetails.

6. ViewSearchHistory
Theusercanviewsearchhistorybyselectingthe"SEARCH"tab.Bydefault,alldatawillbedisplayedand
sortedbyDateindescendingorder.


Thereisapaginationwhichcanbeusedfornavigatingtodifferentpages.Thedatacanbesortedin
ascendingordescendingorderbyeachcolumnheader.Thecurrentsortingruleisindicatedbythearrow
directionnexttothecolumnheader(Arrowdownmeansdescending,arrowupmeansascending).Thereis
alsoafilterwhichcanfilterbydifferentfiltercriteria.Pleaserefertothechapter4.1formoredetails.The
usercanchoosetoviewsearchdetailsbyclickinganyrowinthetable.Pleaserefertothechapter4.2for
moredetails.

6.1 FilterSearchData
Bydefault,thefiltersectionisnotshown.Clickingthe"Filter"iconwilltogglethefiltersection:

Thedataformatofeachoptionwillfollowthenexttable.

DataElement Description Format Required?

StartDate Thestartdateofthesearch. "MM/DD/YYYY" N
EndDate Theenddateofthesearch. "MM/DD/YYYY","StartDate" N
mustnotbelaterthan"End
Date"ifbotharepresented.
StartTime Thestarttimeofthesearch. "hh:mm"AM/PM. N
EndTime Theendtimeofthesearch. "hh:mm"AM/PM,"Start N
Date/Time"mustnotbelater
than"EndDate/Time"ifbothare
 presented.
SUBMITTED Whetherthesearchissubmitted Possiblevalues:Yes,No,All. Y
ornot. Defaultvalueis"All".
Theusercanclickthe"Filter"buttontofilterthedata.

6.2 ViewSearchDetails
Thesearchdetailslooklike:

Thisscreenlookssimilartothedashboardexcepttherightsection,whichcanbeusedtosubmittoMPC
andreportnewcomet.Pleaserefertochapters4.3and4.4formoredetails.

Theusercanhoverthecursoronanypointoftheimagetozoomin:

6.3 SubmittoMPC
TheusercanclickEmailaddressinthe"OBSERVATIONS"sectiontosubmittheobservationstoMPC.

ItwillcomposeanEmailtothisemailaddress.

6.4 ReportNewComet
TheusercanclickEmailaddressinthe"NEWCOMETREPORTS"sectiontoreportnewcomet.

ItwillcomposeanEmailtothisemailaddress.

7. ViewDataontheSkyPage
TheusercanviewdataontheSKYpagebyselectingthe"SKY"tab.Bydefault,alldataoftheskywillbe
displayedandsortedby"OBJECTDESIGNATION"inascendingorder.

Thedatacanbesortedinascendingordescendingorderbyeachcolumnheader.Thecurrentsortingruleis
indicatedbythearrowdirectionnexttothecolumnheader(Arrowdownmeansdescending,arrowupmeans
ascending).Thereisapaginationwhichcanbeusedfornavigatingtodifferentpages.Thereisalsoafilter
sectionwhichcanfilterdatabydifferentfiltercriteria.Pleaserefertothechapter5.1formoredetails.

7.1 FilterSkyData
Therewillbesomefilteroptionsdisplayedinthe"Filter"section:

Theusercaninputthefiltercriteriaandclickthe"SEARCH"buttontofilterdata.Theresultswillbeupdated
basedonenteredfiltercriteria.