Tycho User Guide
Tycho User Guide
By Daniel Parrott
2
Step 1: Load and Process Images ............................................................................................................ 39
Step 2: Download Observations for the NEO.......................................................................................... 39
Step 3: View the Observations in Find_Orb ............................................................................................ 39
Step 4: Attach Ephemeris to the Dataset ................................................................................................ 40
Step 5: Create Stack (using ephemeris) .................................................................................................. 40
Step 6: Create a Track ............................................................................................................................. 41
Step 7: Create Measurements ................................................................................................................ 41
Step 8: Validate the Measurements ....................................................................................................... 42
Step 9: Generate Report ......................................................................................................................... 43
Step 10: Using “Track – Positions” to Generate Sub-stacks.................................................................... 43
Example #5: Measuring a Faint NEO (with synthetic tracker) .................................................................... 44
Step 1: Load and Process the Images ...................................................................................................... 44
Step 2: Attach Ephemeris to the Dataset ................................................................................................ 44
Step 3: Run the Synthetic Tracker ........................................................................................................... 44
Step 4: Analyze the Tracks ...................................................................................................................... 45
Step 5: Using Orbital Elements to find the NEO ..................................................................................... 46
Step 6: Adjusting the Search Parameters ............................................................................................... 47
Example #6: Discovering New Asteroids with Synthetic Tracker................................................................ 47
Step 1: Load and Process Images ............................................................................................................ 47
Step 2: Run the Synthetic Tracker ........................................................................................................... 47
Step 3: Analyzing the Tracks ................................................................................................................... 50
Step 4: Using MPChecker to Determine if Object is “New” .................................................................... 51
Step 5: Taking Optimal Data for the Tracker........................................................................................... 51
Example #7: Longer Total Exposure Dataset (with Synthetic Tracking) ..................................................... 52
Step 1: Load and Process Images ............................................................................................................ 52
Step 2: Run the Synthetic Tracker ........................................................................................................... 52
Step 3: Analyze the Tracks ...................................................................................................................... 52
Example #8: Using the Test Target Generator ............................................................................................ 53
Step 1: Load and Process Images ............................................................................................................ 53
Step 2: Run the “Evaluate Thresholds” Module ..................................................................................... 53
Step 3: Analyze the Results ..................................................................................................................... 53
Step 4: Compare with only 13 Images .................................................................................................... 54
Cluster Computing ...................................................................................................................................... 55
Express Mode .............................................................................................................................................. 59
Auto Run (Scripting) .................................................................................................................................... 60
Pseudo-Flat Calibration ............................................................................................................................... 62
Dataset Ephemeris ...................................................................................................................................... 63
Repositories ................................................................................................................................................ 65
Saving Observations to a Repository ...................................................................................................... 65
Clearing a Repository .............................................................................................................................. 66
Adding a Repository ................................................................................................................................ 66
Removing a Repository ........................................................................................................................... 66
Refresh Repository List ........................................................................................................................... 66
Viewing Items in a Repository................................................................................................................. 66
Identify Linkages ......................................................................................................................................... 67
3
Image Statistics ........................................................................................................................................... 69
Constructing a Lightcurve ........................................................................................................................... 72
Step 1: Update the “Active Observatory” ............................................................................................... 72
Step 2: Load the “Ivar Night 1” Dataset .................................................................................................. 74
Step 3: Perform “Express Mode” ............................................................................................................ 74
Step 4: Adjust the Apertures ................................................................................................................... 76
Step 5: Specify Comparison Stars............................................................................................................ 77
Step 6: Generate Photometry Measurements........................................................................................ 79
Step 7: Perform an Initial Period Search ................................................................................................. 80
Step 8: Include Nights 2 and 3 ................................................................................................................ 81
Step 9: Final Period Search ..................................................................................................................... 84
Step 10: Compare with Lightcurve Database .......................................................................................... 86
Step 11: Generate Observing Circumstances Table ................................................................................ 87
Step 12: Exporting ALCDEF Data ............................................................................................................. 87
Step 13: Importing ALCDEF Data............................................................................................................. 88
Adjusting Magnitude Offsets .................................................................................................................. 88
Generate Transformation Coefficients ....................................................................................................... 89
Session Planner ........................................................................................................................................... 92
Command Line Interface............................................................................................................................. 95
AutoRun .................................................................................................................................................. 95
Image Preview ......................................................................................................................................... 95
Debayer ................................................................................................................................................... 95
Calibration ............................................................................................................................................... 96
Resize ...................................................................................................................................................... 96
Align ........................................................................................................................................................ 96
Merge ...................................................................................................................................................... 96
Cross-Match ............................................................................................................................................ 97
Object Linker ........................................................................................................................................... 97
Star Extractor .......................................................................................................................................... 97
Troubleshooting .......................................................................................................................................... 98
Additional Resources .................................................................................................................................. 98
4
Introduction
Welcome to Tycho. This software is designed to facilitate the detection and measurement of asteroids,
comets, and variable stars. It also supports a technique known as Synthetic Tracking, which enables the
detection of very faint objects. This is achieved by using the data from many exposures (a minimum of
11) and applying the stacking technique for an improved signal-to-noise ratio. Because the exposures
are stacked in thousands of different possible combinations, synthetic tracking allows for the detection
of faint objects even when the motion of the object is unknown. This is made possible by using the
graphics processing unit (GPU) on your computer.
Starting with v5.3, it is now possible to run the software without a dedicated graphics card. However, it
is still recommended to equip your machine with a dedicated graphics card if you intend to perform
synthetic tracking. Most other functionality can be done acceptably without GPU acceleration.
System Requirements
• CPU: Intel Core i5 4590 or better
• RAM: 8GB or more
• Windows 7 SP1 or better
Terminology
Term/Acronym Definition
CPU Central Processing Unit
Your machine has one or more CPUs. A CPU is designed to carry out instructions in
a procedural fashion (one instruction at a time). This is ideal for database
transactions, spreadsheet functions, and so forth.
GPU Graphics Processing Unit
Your machine may have one or more GPUs. A GPU excels at performing a single
instruction in a massively parallel fashion (applying the same instruction across a
large amount of data).
Dedicated GPU A dedicated GPU is one that has its own source of video memory. Such cards are
typically much more powerful than their “integrated” counterparts.
Integrated GPU An integrated GPU does not have its own memory. Instead, it uses the available
memory from the system, and is much less powerful than a dedicated GPU.
OpenCL Open Compute Language
One of the languages that can interface with a graphics processor is called OpenCL.
This is a cross-platform language, meaning that it can work on both AMD and
NVIDIA graphics cards.
5
First Time Setup
Enable GPU Acceleration (if available)
By default, Tycho will be installed to operate in “CPU mode”, with no GPU acceleration. If your system
has a dedicated video card (GPU), such as NVIDIA or AMD, then it is recommended to enable GPU
acceleration. This is accomplished by going to OpenCL->Device Selector from the main menu.
Troubleshooting
1) If you get an error message when choosing a GPU device, make sure you have the latest drivers
installed for your graphics card. If after updating drivers you continue to get an error, try
renaming the provided “OpenCL.dll” file that comes with Tycho to “OpenCL.dll_old” so that
Tycho will use the OpenCL library provided by your system. The provided DLL file is located in
C:\Program Files\Tycho
2) If the program unexpectedly quits when checking the box to enable GPU acceleration, it is likely
due to having Intel UHD 630 graphics drivers installed alongside the dedicated NVIDIA or AMD
drivers. To remedy this, you can go to Device Manager and disable the Intel graphics driver.
This can be done by opening Control Panel, choosing Device Manager, and under the “Display
Adapters” section, right-click on the Intel UHD 630 device and choose “Properties”. Then, on
the “Driver” tab, click the “Disable” button.
6
Configure Report Parameters
The report parameters are used to specify the persons involved in the acquisition and measurement of
the asteroid image data.
Omit Magnitude Information: These setting apply only to observations generated via “Verify Track”.
Typically, if you wish to share discovery credit with another person, you would designate one person as
the “Observer”, and the other person as the “Measurer”.
All names should be formatted as first initial followed by last name, e.g., “J. Smith”.
“Make these settings unique to the active observatory”: Check this box if you wish to have unique
report parameters for the active observatory. For example, you might use Tycho for multiple
observatories, and if you want them to use different reports, you can check this box. Otherwise, if
unchecked, they will all share a common set of report parameters.
7
Configure Observatory Information
In order to generate reports that can be submitted to the Minor Planet Center (MPC), it is necessary to
provide some information about the observatory that captured the images. Navigate to Settings-
>Observatory from the main menu. Then choose Action->Add Observatory, as shown in Figure 3.
8
Specify Settings for Camera
Click “Next…” to proceed to the camera details for the new observatory.
DATE-OBS: In order to make accurate observations, it is critical that you specify the correct setting for
the time information provided by the camera. Most cameras typically generate a “DATE-OBS” keyword
in the FITS header of the image that refers to the beginning of the exposure. However, some newer
CMOS cameras may specify a “DATE-OBS” timestamp that refers to the end of exposure.
Offset: If you know that the DATE-OBS timestamp is off by a fixed amount, you can specify a time offset
here. However, it is preferred that you fix the clock to be accurate in the first place, if possible.
rmsTime: Random uncertainty in observation time. Used only for ADES reports. Optional.
uncTime: Estimated systematic time error. Used only for ADES reports. Optional.
Precision: For very fast-moving objects (satellites, very close NEOs), it may be necessary to use extra
precision in the timestamp field. Note: the MPC does not allow most observatories to use extra
precision in the position (RA/Dec) field.
Finally, click “OK” and the new observatory will appear in the list of observatories. To make the
observatory the active observatory, right-click on it and choose “Make Active” from the pop-up menu
that appears.
9
If you ever need to modify the observatory information, simply right-click the observatory in the list and
choose “Edit…” from the pop-up menu that appears.
If there are multiple cameras in use by the same observatory, with different time settings, then you can
simply add additional observatories to the list with the same location data but different time settings.
Assign these observatories different labels so as to distinguish between them internally.
In essence, an “observatory” in this context refers to a set of configuration values that can be applied to
a set of images. As a result, the “Observatory Configuration” window allows you to easily switch
between different configurations by right-clicking on the desired configuration and choosing “Make
Active”.
10
Configure the Find_Orb Software
The primary purpose of Tycho is to detect and measure asteroids. After you have generated
measurements, it is generally desirable to compare them with other measurements for validation. The
“Find_Orb” software, written by Bill Gray, is quite useful in this regard.
If you have not already done so, please download the modified version of the Find_Orb software from
the Tycho website:
https://www.tycho-tracker.com/download
Also, do not place Find_Orb in the root directory (C:\), as that would require elevated privileges.
Instead, place it in a folder such as the Desktop, e.g., C:\Users\Daniel\Desktop\find_o64\.
Once you have downloaded Find_Orb, navigate to Settings->Find_Orb and configure the file path similar
to how it is presented in Figure 6:
11
Configure the Known Object Database
The “Known Object” database is useful to determine which detections match up with already known
objects. It can be configured by going to Settings->Known Objects from the main menu.
In the top-left there is a button “Download MPCORB.DAT”. Click this button to download the orbital
elements of over 1 million asteroids (approximately 60MByte in size). When it has completed, proceed
to click the button “Download ELEMENTS.COMET”. Finally, when that has completed, click “Verify
Database”. There should be over 1 million asteroids and over 900 comets listed.
There is also a path to a file labeled “MPCORB.CUSTOM”. This ‘custom’ variant of MPCORB allows you
to put in the orbital elements of objects that are not listed in the official MPCORB file, but will still be
recognized as a valid MPCORB file for the purpose of object matching. You can add custom elements
either by directly modifying this file, or by going to Tools->Existing Observations and choosing Orbital
Elements->Add to MPCORB.CUSTOM. Note that this requires Find_Orb to be configured.
Set the other settings as shown in Figure 7.
12
Configure the Star Catalog
Proceed to Settings->Star Catalog to configure the appropriate settings. For most photometry work, it is
recommended to use the new ATLAS catalog (also known as ATLAS-REFCAT2). The Downloads page on
the Tycho website includes three different links to this catalog, allowing you to choose the desired
coverage from magnitude 16 up to magnitude 20. Refer to the notes on the ATLAS tab for details on
how to acknowledge use of this star catalog in a published paper.
To configure an offline star catalog (such as ATLAS), navigate to the relevant tab and specify the full path
to the folder that contains the “de_*” folders (“z*” in the case of UCAC4). Then, navigate back to the
“Options” tab and select the desired catalog from the dropdown menu next to “Catalog”.
For asteroids, it is recommended not to use a filter, so that you can capture as much light as possible on
these faint targets. For photometry of variable stars, the ATLAS catalog can be used if wanting an
ensemble of comparison stars. However, it is also possible to use AAVSO comparison stars regardless of
the chosen catalog. This is achieved by overriding the catalog from within the “Image Viewer”
photometry menu, “Download AAVSO Chart”. More details are provided in the photometry section.
To summarize: If in doubt, use the ATLAS catalog. It can be overridden by AAVSO comp stars later on.
13
Configure the Alignment Software
If you have not already done so, you may want to configure the Observatory Code file, “ObsCodes.html”.
This file allows Tycho and Find_Orb to recognize the different observatory codes that have been issued
by the Minor Planet Center.
You may update the file by going to Settings->ObsCodes and clicking the button labeled “Download
ObsCodes.html”. Then, if you have configured Find_Orb, you can also keep it updated by clicking the
button labeled “Copy to FindOrb Directory”. The button labeled “Verify Path” allows you to validate
that the file was downloaded correctly. As of January 2, 2021, there were 2248 observatory codes
specified in the file.
14
Configure the Plate Solver
Plate solving is necessary an order to determine image characteristics such as plate scale, orientation,
and sky coordinates. Since plate solving is performed after alignment, it is only necessary to plate solve
the first image in the sequence.
Tycho considers an image to be “plate solved” when two conditions are satisfied. The first is that the
image must contain World Coordinate System (WCS) entries inside its FITS header. The second
condition is that the entries must correspond to a 3rd-order SIP polynomial.
There are three ways to plate solve an image. The first of which is to use the Tycho online service which
invokes the solve-field software developed by Dustin Lang et al. This is the easiest and preferred
technique for most users, and is also very fast because it does not upload the image data – only the
extracted sources. The second option is to download the solve-field software onto your own machine,
along with the necessary index files. This option may be useful for those who do not have a reliable
Internet connection. Finally, the third option is to use the astrometry.net online service, being sure to
specify “tweak_order=3” for the 3rd-order polynomial. This option is the slowest as it requires uploading
the full image data.
15
As mentioned, the Tycho online service is recommended for most users as it is quick, easy, and reliable.
Navigate to Action->Plate Solve Images and configure the solver as shown in Figure 11. Then click “Save
Settings” to save the settings for future use. When you are ready to plate solve, click the “Start” button.
Note:
The default Downsample factor is 2, and usually works. However, if you have large images (3000x3000
or larger) then it may be useful to try a Downsample factor of 4. Conversely, if you have small images
(700x700 or smaller) then it may be useful to try a Downsample factor of 1.
Also new in v9.2 is the ability to select “Standard” or “Extended” mode for star extraction. This applies
only to the online solver. If you have smaller images, or are experiencing issues with getting a solution
returned, you may wish to try the “Extended” extraction mode.
The offline solver may be desired by users who do not have a reliable Internet connection. For this
option, the first step is to download the offline solver, a mirror of which is available from the Tycho
website via the Download page from: https://www.tycho-tracker.com/download
Click on the “[ZIP]” link next to the offline solver entry, and you will start downloading the software for
the offline solver. Once downloaded, extract the archive and run the setup executable. When the setup
has completed, be sure to check the box “Run the Astrometric Index Downloader”.
It is not necessary to “Start ansvr” at this time, so you can uncheck that box.
The Index Downloader is important because it will automatically download the index files required for
your field of view. Index files are used by the solver to perform the plate solve routine, and without
them the solver will not function.
16
Figure 13 - Index Manager
Click “Start” once you are satisfied with the settings for “Narrowest field” and “Widest field”. The Index
Downloader will then proceed to download the relevant index files. When it is finished, you can close
the window.
It is also recommended to install the 4100 series of index files. They are available here:
• http://broiler.astrometry.net/~dstn/4100/
• There are 13 .fits files totaling 340MB in size
• After downloading the files, place them into your index file directory (this will be similar to
C:\Users\<user>\AppData\Local\cygwin_ansvr\usr\share\astrometry\data)
Once the plate solver has been installed, along with the index files, launch Tycho and choose “Action-
>Plate Solve Images”. Provide the path to the cygwin_ansvr directory, this is usually going to reside
in your local AppData directory.
If you know the plate scale of your imaging chip, you can provide a lower- and upper-bound on the pixel
scale. For example, if your plate scale is 1.6, you may specify 1.4 as the lower bound and 1.8 as the
upper bound. If you are unsure, it is perfectly fine to specify a wider range such as 0.5 to 3.0.
“Downsample=2” will usually produce a good result. However, if you have a wide field or a large image
then “Downsample=4” is probably better, and a lot faster. If you are experiencing plate solve failures,
you might experiment with different values to see what works best for your images.
The option “Automatically perform second attempt with different source image” allows the plate solver
to automatically perform a second attempt if the first attempt fails. It will also select the middle image
in the sequence as the source image and, upon successful solve, copy its WCS information over to the
first image in the sequence. This can be a useful fallback if the first image fails to solve.
The option “Narrow search to RA/Dec in FITS header” is useful to prevent false matches from occurring.
It is very rare for the plate solver to produce a false match, but it has happened on at least one occasion.
Therefore, this option can be enabled to instruct the plate solver to search within a given radius of the
17
RA/Dec specified within the FITS header of the first image. If the RA/Dec is not found in the FITS header,
the plate solver will revert to conducting a “blind search”, which is the same behavior as if the option
were disabled. The default search radius is 15.00 degrees, meaning that the RA/Dec in the FITS header
can be off by that amount from the actual RA/Dec. Evaluation of numerous datasets has shown that
while most FITS headers will have the RA/Dec correct to within 5 arcmin, some can be off by several
degrees. Thus, to ensure that the plate solver is not overly constrained, it is advisable to have a
sufficient radius, which will still reduce the probability of an incorrect solution being returned.
Here are the steps to solve an image using the astrometry.net online service. Note again that you need
only solve the first image in the dataset.
Before uploading the file, click on the “Advanced Settings” text and scroll down to the following settings.
Once these Advanced Settings have been specified, proceed to upload the image and wait for the
service to return with a result. When the service has finished, you can download the plate solved image
by clicking on the “new-image.fits” link, as shown in Figure 15.
18
Figure 15 - Retrieving the Plate Solved Image
Once downloaded, you can replace the unsolved first image with “new-image.fits”, which will take the
place of the first image in the image sequence. As you can see, the astrometry.net service is a bit more
tedious than using the integrated solvers, but is one more option available should it be desired.
19
Acquiring an Observatory Code
The Minor Planet Center (MPC) is the official authority behind the process of requesting and acquiring
an observatory code. For the purpose of providing a tutorial, some steps of the process are outlined.
This page from the MPC website provides some details on acquiring an observatory code:
https://www.minorplanetcenter.net/iau/info/Astrometry.html
If your site does not have an observatory code, one will be assigned upon acceptance of your initial
submission. Your initial submission should contain at least six numbered minor planets each on pairs
of nearby nights as well as one numbered Near-Earth object observed on two distinct nights. If
weather interferes, the two nights can be some weeks apart. Report at least three observations of
each object from each night: do not report single positions per night. Batches that contain single
positions will be returned in their entirety to the submitter. We will check these positions and advise
you on their quality. As a general rule we advise you NOT to observe very low-numbered objects--e.g.,
(1), (2), (51) and very bright objects. In your initial batch please submit astrometry of objects fainter
than 14th magnitude. In addition, you should try and observe objects of various brightness.
Your first submission of measurements should contain XXX for observatory code for the MPC to
recognize it as a code request/application. Immediately after you make your first XXX submission, you
will get an email directing you to enter some information for your code application. That submission
and all other submissions you make until you get a code should only contain two-night measurements
on asteroids in the range identifier of 800-40,000.
After my initial submission was accepted (with observations of two different asteroids) I was asked to
submit more observations of other asteroids. The email also had a link to fill in coordinates of the
observatory and some other details. For the second set of observations, I used code XXX and sent
observations of 4 asteroids. Within a few days, I sent observations of one more asteroid with code
XXX. I waited for two weeks from the time I submitted my second set to get my observatory code.
The Tycho software makes it easy to generate a report in the format required by the MPC. This is
explained later as you work through the example datasets. It is also recommended to use the MPC1992
format for the initial submissions, and later the ADES format if desired. This is because ADES does not
yet support the “XXX” (new observatory) code.
Until you have a code, you want to make sure that the option “Applying for a new MPC code” is selected
as the “Observatory Status” (refer to the section “Configure Observatory Information”).
Note: The example dataset provided in this tutorial was taken from an observatory that already has a
code (Q62). When applying for a new code, you must use images taken from your own observatory.
20
Example #1: Measuring a Known Asteroid (using only 4 images)
The purpose of this first example is to demonstrate how to use Tycho with a minimum set of images for
basic measurement. Later examples will show how to use the synthetic tracker, which requires at least
11 images, enabling the detection of very faint asteroids.
Launch Tycho. From the “Image Manager”, choose List->Add Images, and load the images contained in
the example dataset labeled “ds1”. There should be exactly four images.
It is always good practice to verify the quality of the images. To do this, navigate to Action->View
Images from the main menu. This will open the “Image Viewer” window. Now, if you go back to the
“Image Manager” window, you can click on the different images and see them displayed in the “Image
Viewer” accordingly. You will note that they are not yet aligned as there is some noticeable shift from
one from image to the next. But the quality of the images is good, with stars having acceptable focus.
Now that you have visually inspected the images, it is time to prepare them for processing. The first
step in this procedure is calibration. Navigate to Action->Calibrate Images from the main menu and you
will see a new window appear for calibration settings.
Because these images have already been dark subtracted and flat fielded, it is not necessary to perform
those steps here. However, when you are calibrating your own images, be sure to apply the appropriate
dark frame and flat frame sources. For flat frame calibration, “pseudo flat” works quite well, especially
if you do not have a flat frame available. But for this dataset, the only calibration required is to
normalize the images. This is important when using the synthetic tracker (as shown in later examples).
So, choose the option “Normalize Images”. However, when doing sensitive photometry, it is better not
to use normalization for best results.
21
Figure 17 - Calibration Settings
Next, click “OK” to proceed with calibration. The resulting images will be saved in a new folder labeled
“ds1_c”. Navigate to that directory and load the now-calibrated images.
The next step is to align the images. Proceed to Action->Align Images and choose the desired alignment
option. If you have not already done so, navigate to the relevant tab and configure the settings. Click
“OK” to proceed. As before, the images will be saved to a new directory, this time labeled “ds1_c_a”.
22
Step 5: Plate Solve the Images
Navigate to the newly-aligned images, contained in directory “ds1_c_a”. Load them as before. Now go
to Action->Plate Solve Images.
The images have a known pixel scale of around 1.65”/pixel. However, you can choose a wide lower- and
upper-bound for the pixel scale, as shown in Figure 19. For more details, refer to the section labeled
“Configure the Plate Solver”. Proceed to plate solve the images by clicking the “Start” button.
When the solver has finished, the images will remain loaded in the “Image Manager” – no new output
directory is generated at this step. It is good practice to validate the plate solve by going to Action-
>View Images, and checking that the catalog stars (blue boxes) are overlaid on top of the actual stars.
To do this, choose File->Load Star Catalog from the “Image Viewer”.
If you do not see any stars, make sure Display->Catalog Stars is checked, and that you have configured
the Star Catalog settings. If you have not configured the star catalog, now is a good time to do so. Refer
to the section labeled “Configure the Star Catalog” for more details.
As you have observed, it can be rather tedious to perform each of the above steps manually. For this
reason, there is a feature called “Express Mode”, which streamlines the process. If you would like to try
23
“Express Mode”, load the original (uncalibrated, unaligned) images into the “Image Manager”, and then
navigate to Action->Express Mode from the main menu.
As you can see, “Express Mode” offers the ability to carry out each step in an automated and
streamlined fashion. Once you have the correct settings for each step, click the “Start” button and the
program will automatically perform each step. When it is finished, the results are stored in a single
output directory with the appropriate labeling.
Now that the images have been calibrated, aligned, and plate solved, it is time to start generating some
measurements (also known as “observations”). Load up the processed images, and then navigate to
Action->View Images from the main menu.
Important: Before you proceed, you will need to change your observatory settings to match those of the
observatory that acquired these images. In this example, the observatory that acquired these images
has Minor Planet Center (MPC) code “Q62”, located in Siding Spring, Australia. To make this change,
navigate to Settings->Observatory from the main menu and choose Action->Add Observatory from the
window that appears. Give the observatory a label such as “Siding Spring” and then choose “Already
have an MPC code” for the observatory status. Specify “Q62” for the MPC code, and click the button
“Apply location from MPC code” to automatically populate the location details. For the telescope
section, you can populate the details as shown in Figure 21. Then click the “Next” button and make sure
to use the same settings as shown in Figure 22. Then, click “Finished”.
24
Figure 21 - Adding Observatory, Page 1/2
Now that “Siding Spring” has been added as an observatory, proceed to make it the “Active
Observatory” by right-clicking on it in the list and choosing “Make Active”.
25
Step 7: Load Known Objects
Back at the “Image Viewer”, you can now proceed to have Tycho show known objects in the field by
going to File->Load Known Objects from the “Image Viewer” menu. This feature depends on having the
Find_Orb software installed and configured in order to precisely compute the positions of asteroids, so if
you have not yet configured the settings for Find_Orb, it is recommended to do so now. Refer to the
section labeled “Configure the Find_Orb Software” for more details.
At this point, a window should appear with a list of all known objects for this field. As you click on each
item in the list, the “Image Viewer” will automatically update to the location of the object. If the object
does not appear centered in the crosshairs, then you may need to verify either the observatory settings
as described earlier (this dataset was acquired with MPC code Q62), or the “Known Objects” settings
(Settings->Known Objects from the main menu). In rare situations, some cameras may specify a DATE-
OBS that is not in UTC time; in these scenarios, you can specify the time offset to correct for this.
As an example, right-click on object with “Number” (permanent ID) of “(38826)”, also known as “2000
RZ92” (its provisional ID). When you have right-clicked the object, choose “Add to Track Navigator”.
You can also do this with multiple objects at a time, but for now focus on just this object.
With the object added to the “Track Navigator”, you can either double-click it, or right-click and choose
“Verify Track”. An animation of the object should now be shown in the “Image Viewer”, showing the
movement of the asteroid.
The “Verify Track” window will limit to 3 observations by default. Generally, even if you had 60 images
loaded, it is good practice to limit to 3 observations. The reason for this is that Tycho can then use 20
images for each observation, resulting in a much higher signal-to-noise ratio (SNR) for each observation.
26
But if you want more observations, check the box “Advanced mode” and the drop-down list will allow
you to have as many observations as there are images. In this example, proceed to generate three
observations as shown in Figure 24.
Click the “Add Observations” button to continue. The “Object Designation” window will now appear,
prompting for the designation of the object. Since this is a known object, the fields should already be
populated.
Click “OK” to proceed. The measurements (observations) have now been generated for this object.
27
At this point, you will want to verify that the observations were correctly generated by clicking on each
measurement in the “Observations – All Targets” window.
As you click on each observation, the “Image Viewer” window is updated to show the centroid of the
observation. You will note that the first observation uses a stack of the last two images.
28
Step 10: Validating the Measurements
You can validate the measurements by selecting them, then right-click and choose “View with Existing
Observations” from the popup menu that appears. It may take a moment, as the observations from
other observatories are downloaded. When it is finished, a new window appears showing all of the
observations for this object, with the ones that you just created at the very bottom.
As measurements of this object were already submitted by Q62, you will want to remove those
observations from the list before doing the comparison. You will note the observations have a date of
2018 09 10, so scroll up in the list to around that timeframe and remove the observations that have Q62
in the far-right column. There should be about six observations to be removed.
When ready, click on “View in Find_Orb” (the button in the lower-right corner of the window), and the
Find_Orb software will show the residuals for these three measurements that you just generated.
29
As you can see, the measurements are quite good, with “0.31” being the highest residual. Generally,
any measurement with a residual below 1.50 is acceptable, but it is preferred to have residuals below
1.00. Several factors can influence the quality of measurements, including:
Now that you have validated the measurements, you can proceed to generate a report that could be
used for submission. Note that these measurements should not be submitted as they are only for
example purposes.
To generate the report, navigate back to the “Observations – All Targets” window. Then choose Report-
>Generate MPC1992 Report if you wish to generate an MPC1992 report. Otherwise, if you wish to
generate an “ADES” report, choose Report->Generate ADES Report.
COD Q62
CON D. Parrott
OBS D. Parrott
MEA D. Parrott
TEL 500mm Reflector + CCD
NUM 3
ACK MPCReport file updated 2021.01.03 18:26:22
NET Gaia DR2
38826 KC2018 09 10.58639 22 56 39.58 -07 50 40.8 17.3 G Q62
38826 C2018 09 10.61431 22 56 37.71 -07 50 43.4 17.4 G Q62
38826 C2018 09 10.63394 22 56 36.41 -07 50 45.3 17.4 G Q62
----- end -----
As you can see, the three observations are shown in an MPC1992 report. The first observation, being a
stack of two images, has the “K” attribute next to the date.
30
Example #2: Measuring an “Unknown” Asteroid (using only 4 images)
This example expands upon the first example in that it assumes you now know how to calibrate, align,
and plate solve images. If not, please consult the first example for details on how to carry out those
steps.
This example will show how to generate measurements of an “unknown” asteroid. In fact, the asteroid
is already known, but for this example we will pretend otherwise. The purpose of this example is to
show how to measure an asteroid without relying on the “Known Object” functionality.
As before, proceed to calibrate, align, and plate solve the images. The images are the same as that in
the first example, using dataset “ds1”. Once you have finished processing the images, load them up and
launch the “Image Viewer” by going to Action->View Images from the main menu.
From the “Image Viewer” menu, choose Location->Center on RA/Dec. A new window will appear,
prompting for RA/Dec coordinates. You may either input the RA/Dec in the sexagesimal format, or in
decimal format. For this object, its coordinates on the first image are as follows:
RA = 22 56 39.95
DE = -07 50 39.50 (note the “-07” is negative 07 degrees).
31
Click the “OK” button within the “Coordinates (Sexagesimal format)” section and the “Image Viewer”
will be updated to display the image at those coordinates. You will notice that this looks similar to the
asteroid measured in the previous example, and it is in fact the same one. But this time we will be
measuring it in a different fashion.
Again, pretending that this is an “unknown” asteroid, blink through the images to reveal the moving
object. You can either scroll through the images in the “Image Manager”, or you can have the images
blink in an automated fashion. If you wish to have them blink automatically, you can right-click inside
the “Image Viewer” and choose “Create Track – From Current Position”. In this particular scenario, it is
not necessary to worry about the “current position”, right-clicking anywhere inside the image should be
fine. Since no motion has been defined, the new track will have a motion of zero, which allows the
images to be blinked normally. Once the track has been added, double-click it to bring up the “Verify
Track” window. Since you are just using this to blink images, you do not need to worry about creating
observations yet. Also, in the “Animation” section, uncheck the box “Follow Target” and choose “4
stacks” so that each image is included separately in the blink animation. As you blink the images, you
will see the motion of the object. To stop the blinking, either click the “Pause” button or click on an
image in the “Image Manager”. New in v8: You can now animate from the Image Manager by choosing
“Animate->250 ms” (or another interval). To stop the animation, navigate to “Animate->None”.
32
Step 3: Create Markers
Proceed to click on the first image in the “Image Manager”, then double-click on the object in the
“Image Viewer” so that it is properly centered in the crosshairs. Now, right-click, and choose “Create
Marker 1”. Then, click on the last image in the “Image Manager”, and double-click on the object once
more. This time, right-click and choose “Create Marker 2”.
Having defined two markers to indicate the motion of the object, you can now create a track using these
markers. This track will use the markers to compute the speed and position angle of the object. To
create this track, right-click in the “Image Viewer” and choose “Create Track – From Markers”. You now
have a second track, this time with speed and position angle (PA) of the object populated.
As before, you can double-click on the track and the “Verify Track” window will appear. But this time,
the blinking animation will follow the actual object as it has now been programmed with its motion. So,
if you check the box “Follow Target”, the object should remain centered within the crosshairs. At this
point, you can proceed to create observations of the object, in a similar fashion to how you created
observations in the first example.
33
Figure 34 - Manually Created Tracks
With the images from the second example still open, go back to the “Image Manager” and click on the
first image. Now, with the first image shown, go to the “Image Viewer” and double-click on the asteroid
to center it.
Now choose Create->Observation from the “Image Viewer” menu, or right-click inside the “Image
Viewer” and choose “Create Observation” from the popup menu that appears. In either case, a new
observation will be created and shown in a new window, “Observations – Single Target”.
This approach allows you to manually create measurements without relying on the “Track Navigator”. It
also gives you more flexibility as you can choose what layer is used to generate the measurement:
“median”, “avg” (mean), or “Abv” (detection layer). When you create a stack, these layers will all be
different, with the “Abv” layer performing best at eliminating star interference and the “Avg” layer
showing star trails. By default, the “Track Navigator” uses the “Abv” layer as it is usually best for
automated generation of measurements and works well in crowded star fields; however, sometimes the
“Avg” layer might be better, especially when the object has little movement.
Since you have not stacked any images, the layers will appear identical, as a single exposure is shown.
You have just now manually created a measurement using a single exposure. Now let’s try creating a
measurement using several exposures. Right-click in the “Image Viewer” and choose “Create Stack -
Custom” from the popup menu that appears. This allows you to create a stack with a custom motion,
either in terms of “Speed/PA” or in terms of “X/Y” motion. For this example, we will specify the motion
of the asteroid with speed=0.7”/min and PA=265 degrees.
34
Figure 35 - Create Stack (Custom)
Now click the button “Create Stack (Speed/PA)”. You will note that the “Image Viewer” will be updated
and will display a stack using median combine, average (mean) combine, or “Abv” combine. If you want
to change the stack type (layer), then you can change the appropriate setting and click on “Create Stack
(Speed/PA)” again. An example of the “Abv” layer is shown in Figure 36.
If the object is not centered in the crosshairs, double-click on it to center it. Then, right-click and choose
“Create Observation”. You will now have a second observation listed, this time using all four exposures
(ImgStart=1, ImgStop=4). Again, this is just an example; in practice, you would never create a
measurement that reuses exposures from another measurement – ALWAYS use distinct and separate
exposures for each measurement. The measurements may be generated from multiple exposures, but
the exposures used by each measurement should be different from those used in other measurements.
35
Step 4: Create a Stack (subset of images)
As the previous step showed, if you create a stack with no images selected, it will create a stack using all
of the images. This can be useful in certain scenarios when you want to stack all of the images to get the
maximum SNR. But in this case, it also means that when you created the observation, you wound up
with a measurement that uses all of the exposures – which you might not want. So, you may be
wondering how to create a stack using only a subset of the images.
To do this, go back to the “Image Manager”, and select the last three images (the first image should not
be highlighted, while the last three should be highlighted).
Then, go back to the “Create Stack – Custom” window (simply labeled “Stack”), and click on the button
“Create Stack (Speed/PA)”. This time, when it creates the stack, it will do so using only the last three
images. As you can see in Figure 38, when the stack is created with “Avg” layer (not Abv), it is evident
that three images were stacked because each star leaves behind three “footprints” in the image.
36
Now that you have generated this stack of three images, you can create another observation. Double-
click on the asteroid to center it, and then right-click and choose “Create Observation”. This time, you
will note that “ImgStart=2” and “ImgStop=4”, meaning that images 2, 3, and 4 were used to generate
this measurement. Proceed to delete the earlier measurement that used all of the images, which should
leave you with two measurements total.
Tip: In a later example, I will also show how to create these “sub-stacks” using the “Track – Positions”
window, which is far more convenient than manually creating each stack.
At this point, you have created measurements of some object. It could be an asteroid, a comet, a
satellite, even just a star. The next step is to add these measurements of that object to the “Target List”,
which allows them to be treated alongside measurements of other objects. So, proceed to click the
“Add to Target List…” button. You will get a new window asking for the designation of the object. The
permanent ID (permID) is 38826. Since it is a numbered object, there is no need to specify the
provisional ID. Click “OK” to continue.
You will note the familiar window shown in the first example, “Observations – All Targets”. Here again,
you could validate the measurements and generate a report. You could also click on each observation
to see the green centroid indicating the exact center of the object. Generally speaking, it is not
worthwhile to publish just two measurements of an object (3 measurements are preferred), but the
purpose of this example was to show how to generate measurements in a manual fashion.
Before going on to the next example, let’s try one more task. Here, we will pretend that one of the
measurements had a poor centroid and requires manual correction. This is usually rare to occur, but if it
happens, it is worthwhile to know how to fix it manually.
On the “Observations – All Targets” window, click on the second observation of the object. You will see
the object centered with both the red crosshairs and the green centroid indicator. Again, let’s pretend
that the green centroid needs adjustment, so right-click on the observation and choose “Modify
Observation”. This will bring up a new window as shown in Figure 41.
37
Figure 40 - Green Centroid Indicator
From the “Modify Observation” window, there are two ways to adjust the centroid. One is to move the
centroid with fine adjustment (1/10th of a pixel). To do this, check the box “Move centroid with arrow
buttons”. Then click on the arrow buttons in the “Image Viewer” to move the centroid. When finished,
click “Apply centroid specified by green crosshairs”. You should see the “RA” and “DEC” of the
observation be updated in the “Observations – All Targets” window when the button is clicked.
38
The other method to adjust the centroid is by specifying an initial pixel location from which Tycho will
then compute a more accurate centroid. In other words, if the observation is “way off”, the pixel
location can be used to get it back in the “ballpark” and then Tycho can re-compute the correct centroid.
To use this method, uncheck the box “Move centroid with arrow buttons”, and proceed to pan the
image to where the object is located (even just double-clicking on the object). Then click the button
“Re-calculate centroid using current pixel location”. As with the other method, the “RA” and “DEC” of
the observation should be updated in the “Observations – All Targets” window.
You can also use the “Modify Observation” window to change which layer is used for the observation.
So, if you wanted to use the “Median” layer rather than “Avg” layer, you could open the “Modify
Observation” window, double-click the object, and click “Re-calculate centroid using current pixel
location”. The centroid (as well as magnitude information) will then be recomputed using the specified
layer.
Note: If you click on a different observation and the green centroid indicator does not follow it, that is
likely because the “Modify Observation” window was kept open. Close the “Modify Observation”
window when finished with it. It will also close by itself whenever you actually modify the observation,
or whenever you click “Cancel”.
This example will show how to generate measurements of a faint NEO that is not detectable on
individual frames. As such, unlike the previous examples that had a bright asteroid, this example makes
use of many exposures in order to produce a sufficient signal-to-noise ratio (SNR).
Load the dataset for this example, “ds2”, and proceed to perform calibration, alignment, and plate
solving. There should be 39 images in this dataset.
Navigate to Tools->Download Observations from the main menu. At the prompt, type in “2018 RB” for
the object name, and choose the option “From obs database (confirmed object)”. Then click “OK” to
proceed. After a moment, a new window will appear, “Text Form – Observations”. This window should
be populated with the observations for the NEO.
Click the button in the lower-right corner, labeled “View in FindOrb”. The Find_Orb program will launch
and compute the orbit for this object using the observations from the text form. Continue to leave
Find_Orb running in the background for the next step.
39
Figure 42 - Download Observations
With Find_Orb still in the background, navigate back to the “Image Manager” and choose Ephemeris-
>Attach to Dataset from the “Image Manager” menu. From the window that appears, double-click on
the appropriate instance of Find_Orb (if you have multiple instances running, choose the one with “2018
RB”). You will note that the “EPH_” columns in the “Image Manager” are now populated with
information about the object. If you scroll to the far-right, you can see the “EPH_IN_FOV” column which
indicates whether or not the object is expected to be in the field of view for each image. This can be
helpful as you typically want to exclude images where it is not in the field of view. For this dataset, the
object should be in the field of view of each image, so the column should indicate “Yes” for every image.
Now that the ephemeris information has been attached to the dataset, proceed to view the images by
going to Action->View Images from the main menu. Then, right-click inside the “Image Viewer” and
choose “Create Stack – Ephemeris” from the popup menu appears. Alternatively, you can also choose
the option by going to Create->Stack – Ephemeris from the “Image Viewer” menu. At this point, you will
note that the “Image Viewer” has been updated with a display of a stacked image according to the
computed motion of the object.
40
Figure 44 - Result of "Create Stack - Ephemeris"
In Figure 44, you can see the result of creating the stack. If your results look different, you may be using
a different layer such as “Median” or “Abv”. For this example, choose “Avg”, and then recreate the
stack to force an update of the display. Also, you can adjust the contrast to make the object stand out
better. I chose (164) for the contrast slider.
Double-click the object to ensure that it is centered in the crosshairs. Then right-click and choose
“Create Track – Current Position” from the popup menu that appears. This will add a new track to the
“Track Navigator”.
Double-click on the track and you can see the “Verify Track” window appear. Click the “Add
Observations” button. Another window appears, “Object Designation”, prompting for the designation
of the object. Specify “2018 RB” (without the quotes) for the “Provisional ID (provID)” field. The object
does not have a permanent designation, so leave (permID) blank. Click “OK” to continue.
As before, you can perform a visual inspection of each observation by clicking on them in the
“Observations – All Targets” window. On rare occasions you might also want to manually adjust the
41
centroid; if so, please refer to the section labeled “Step 6: Manually Adjusting the Centroid” in the
previous example. For this example, there should be no need to modify the centroid.
As described in the first example, you can validate the measurements by right-clicking on them and
choosing “View with Existing Observations”. This will bring up the “Text Form – Observations” window,
with the newly-created measurements at the very bottom. Again, the observatory that acquired these
images is “Siding Spring” in Australia, with MPC code “Q62”. So, if you are seeing a different MPC code
shown in the far-right of the observation text, you will need to make “Siding Spring” the active
observatory. Refer to the first example for details on how to do this.
Because Q62 already submitted observations of this object, you will want to remove those observations
from the list before comparing your newly-created observations with those from other observatories.
Scroll up the list until you reach 2018 09 10 and locate the observations by Q62. There should be
around six observations; delete them and leave the others.
Now click the button “View in Find_Orb” and you should see the residuals (errors) for the observations
you just created. From this instance of Find_Orb, it appears that the highest residual is “0.21”, which is
quite good. Again, any measurement with a residual under 1.50 is “acceptable”, but it is preferred to be
under 1.00 when possible.
42
Step 9: Generate Report
As described in the first example, you can now proceed to create either an MPC1992 report or an
“ADES” report by going to Report->Generate MPC1992 Report or Report->Generate ADES Report from
the “Observations – All Targets” window.
As before, do not submit these observations, as they are only for example purposes.
While the images are still loaded, try experimenting with the “Track – Positions” window. This window
should still be open from having created the track earlier. If not, you can go to Window – Track –
Positions from the main menu to bring it to the front. If you do not see the window in the list of
available windows, then you should try clicking on the track in the “Track Navigator”. Or, worst case
scenario, if the “Track Navigator” window is no longer open, proceed to re-create the track as described
in the previous step “Step 6: Create a Track”.
Now that you have the “Track – Positions” window in view, click on the first entry in the list. This will
update the “Image Viewer” to center on the object in the first image. You may want to reset contrast
back to “(0)” when examining individual images. With the first entry still highlighted in the “Track –
Positions” window, use the “Down” arrow key on the keyboard to rapidly move to the other entries.
You should now see the object appear to move in the “Image Viewer” as it follows the object on each
image. From this, you can see that the object is indeed quite faint on each individual exposure.
To create a sub-stack, click the first entry in the “Track – Positions” window, then hold down the “SHIFT”
key and click on the 13th entry. This selects entries 1-13. The “Image Viewer” will now display a sub-
stack generated from images 1-13. At this point, you can now double-click on the object in the “Image
Viewer” and create an observation by right-clicking and choosing “Create Observation” from the popup
menu that appears. Then, to create another observation using images 14-27, go back to the “Track –
Positions” window and click on entry 14, then hold down the shift key, and click on entry 27. Another
sub-stack will be created, this time using images 14-27. As before, you can double-click on the object in
the “Image Viewer” and create an observation by right-clicking, and choosing “Create Observation” from
the popup menu that appears. Repeat once more with images 28-39 to create a third observation, if
desired. As mentioned in a previous example, these observations are added to the “Observations –
Single Target” window. You need click on the “Add to Target List…” button to move them over to the
“Observations – All Targets” window.
Tip: If you are wondering what the “Add Animation Stack” button does on the “Track – Positions”
window, it simply adds another stack to the blink animation. The blink animation is controlled by the
“Blink Stacks” window, which is normally kept hidden. If you want to bring it to the front, you can go to
Window – Blink Stacks from the main menu.
Another feature of the “Track – Positions” window is that it enables you to create a sub-stack in real-
time by clicking on an entry in the list and holding down the “SHIFT” key while pressing the “Down”
arrow key on the keyboard. You should see the “Image Viewer” update in real-time as the images are
combined. This is usually quite fast if you have “GPU Acceleration” enabled.
43
Example #5: Measuring a Faint NEO (with synthetic tracker)
The purpose of this example is to show how you can detect and measure a faint NEO using the synthetic
tracker. Since the object is quite faint, many exposures are used. And as the synthetic tracker is used, a
minimum of 11 images are required.
This example uses the same dataset as the previous example, “ds2”. Proceed to load and process the
images (calibrate, align, and plate solve). Refer to the first example for details on how to perform these
steps.
Similar to the previous example, you will retrieve observations of the object and use those observations
to generate ephemeris information. Then, attach that ephemeris to the dataset. The object is again
“2018 RB”. Refer to the previous example for details on how to attach ephemeris information.
Navigate to Action->Synthetic Tracker from the main menu. A new window will appear, prompting for
the “Sensitivity Threshold”. A setting of 50% works well here, but if the object is extremely faint you
may want to increase the sensitivity. A lower sensitivity can also be specified, resulting in faster
searches at the tradeoff of sensitivity.
Proceed with the default of 50% sensitivity and click “OK” to continue.
44
On the next window, you are prompted for the search parameters. Since this is a search of a known
object, and since you have attached ephemeris information to the dataset, you can click the “Use
Dataset Ephemeris” button to automatically confine the search to the motion of the object. You should
see that the speed and PA have been limited as shown in Figure 47.
If GPU acceleration is enabled, the tracker should complete after a few seconds; otherwise, it may take a
minute or two.
When the tracker has finished, the “Track Navigator” window should appear with a list of candidate
detections (tracks). Normally, the target of interest should be in the top 10 tracks, as they are sorted by
“quality” by default. In this case, it is track #1. If a NEO you are searching for does not appear in the top
ten tracks, you can search for it in the list by going to Find Object->By Ephemeris from the “Track
Navigator” menu and it will sort the tracks by proximity to the expected location of the object as
computed by its ephemeris. Alternatively, you could also invoke Find Object->RA/Dec and input the
coordinates manually. In either case, the tracks will be sorted by proximity to an expected location.
Note however that just because a track appears to be close to where the object is expected, does not
mean that it is in fact the object. You will have to perform either visual inspection or generate
measurements that can be validated against other observations.
45
As the NEO was found in track #1, double-click track #1 to bring up the “Verify Track” window. You
should see the motion of the object in the “Image Viewer”. At this point, you can proceed to generate
observations, validate those observations, and generate a report, as described in previous examples.
The first example described how to use the “Known Objects” window to locate objects based on their
orbital elements. This makes use of the “MPCORB.DAT” file published by the Minor Planet Center.
Another way to find the NEO is to compute its orbital elements from the published observations, and
then add those elements to the “MPCORB.CUSTOM” file, which is included in the regular search of the
other asteroids.
To do this, either download observations of the object or copy and paste observations from another
source into the “Text Form – Observations” window. If you want to download the observations,
navigate to Tools->Download Observations from the main menu, specify “2018 RB” (without the
quotes), specify “From obs database (confirmed object)”, and click “OK”.
Once the “Text Form – Observations” window has been populated with observations of the object, you
can then generate the orbital elements of the object and store them into the “MPCORB.CUSTOM” file by
invoking Orbital Elements->Add to MPCORB.CUSTOM from the “Text Form – Observations” window.
This invokes the Find_Orb program to compute the orbit, and after it has finished a new window will
appear showing the objects stored in “MPCORB.CUSTOM”. You can then save the result by going to File-
>Save from the menu of this new window. It will present a message saying that the application must be
restarted for changes to take effect; however, a shortcut around this is to go to Settings->Known Objects
from the main menu and click the button labeled “Verify Database”, which will force a reload of the
“Known Objects” database. The reason this is not done automatically is because if you had previously
loaded the database to perform matching with tracks in the “Track Navigator”, those matches will
become invalidated upon a database reload.
Having updated the “MPCORB.CUSTOM” file, you can now go to File->Load Known Objects from the
“Image Viewer”. You should now see two instances of the object shown in the “Known Objects”
window. The first instance is from the official “MPCORB.DAT” file, and the second instance (at the
bottom of the list) is from the modified “MPCORB.CUSTOM” file.
At this point, you can click on the entry in the “Known Objects” window that pertains to the object and a
stack will automatically be created. From this stack, you can then double-click on the object to center it
in the crosshairs. Then, right-click inside the “Image Viewer” and choose “Create Track – From Current
Position”. This will add a new track to the “Track Navigator” window. As before, you can proceed to
generate observations using this track information.
If you want to remove the item from “MPCORB.CUSTOM”, go back to the “Text Form – Observations”
window and choose Orbital Elements->Modify MPCORB.CUSTOM. Then click on the item and press the
“Delete” key, or right-click and choose “Delete” from the popup menu. Then save the changes by going
to File->Save from the menu of the “Orbital Elements [MPCORB.CUSTOM” window.
46
Step 6: Adjusting the Search Parameters
By now you have learned how to find the NEO using several methods:
All of the above approaches require some knowledge of the motion of the object. However, the
synthetic tracker can be used to find an object, even if its motion has large uncertainty.
To try this, navigate back to Action->Synthetic Tracker and specify the same sensitivity threshold as you
did earlier. Then, on the last page concerning the “Synthetic Tracker Configuration”, try expanding the
search as follows:
NOTE: If you specify an upper bound on speed that is larger than the “Max object speed” constraint, you
will need to increase the “Max object speed” accordingly (using “Dataset ephemeris” automatically
raises the “max object speed” constraint when necessary, but manual input does not).
Click “OK” to start the synthetic tracker with this expanded search. It may take several minutes,
depending on your hardware configuration. On a system with an NVIDIA RTX 2080, it took 19 seconds.
When the tracker has finished, you will see the results shown in the “Track Navigator”. The object
should still be shown as track #1 as there are no other objects in this field with similar motion. As the
results indicate, the tracker was able to find the object even with a much wider search range. This can
be useful when the orbit of a NEO has very few observations, as you can open up the search parameters
to account for the increased uncertainty.
This example uses the same dataset as the previous example, dataset “ds2”. Proceed to load and
process the images, applying the steps for calibration, alignment, and plate solving. As usual, if you
need a refresher on how to perform these steps, consult the first example.
47
Once the images have been processed, navigate to Action->Synthetic Tracker from the main menu. The
window will prompt for a “Detection Sensitivity Threshold”. The setting you choose here depends on
how sensitive you want the tracker to be. A setting of 100% is the most sensitive and will generate a
large number of detections. Conversely, a setting of 0% will generate almost no detections at all, save
for the very brightest objects. It is usually a good idea to allow some false detections to be generated,
because that ensures you are detecting at a level that is sensitive enough to detect even the faintest
objects. To follow along with this example, use the setting of 50% and click “OK” to continue.
The first parameter, “Max object speed”, determines the overall constraint on the search space. By
default, it is computed by assuming an object could move as fast as four pixels per exposure (a slight
amount of streaking). In other words, if you had a 120 second exposure, and a plate scale of 1.65”/pixel,
it would set the default max speed to [1.65*60*(4/120)] = 3.3 arcsec/min. In general, the default setting
is usually adequate, but if you have a very fast object (or a very long exposure time), then you may need
to adjust this setting.
Under the “Advanced Settings” parameters you will find the ability to limit the search based on speed
and position angle. This is very useful if you already know the motion of the object. You can also adjust
the granularity of the motion vectors, with higher granularity resulting in more vectors to search. A
setting of 67% for granularity is almost always sufficient. The “minimum shift between images”
determines the threshold at which a shift is considered significant to warrant inclusion in the list of
search vectors. It acts as another level of granularity, with smaller values resulting in more vectors.
Usually, the default value of 0.5 is sufficient. Next, you have the ability to crop detection near the
edges, a value of 30 to 60 is usually ideal.
48
Finally, you may want to enable multithreading to speed up the processing. In CPU mode, this setting
overrides the setting in the Device Selector, and the threading works by dividing up each image for
processing. In GPU mode, this setting works by having each thread operate on its own motion vector,
and consequently there is some memory overhead as each thread allocates its own workspace. In
general, when in CPU mode, the number of threads should be set to the number of cores, whereas in
GPU mode the number of threads should be just enough to keep the GPU busy, which may be only 3 or
4 threads even on a large-core system. This is where you will have to experiment to identify optimal
settings for your particular system.
Make sure that your settings match those in Figure 48. Then click “OK” to begin the search.
Because we are doing a “blind” search (meaning no limits on speed or PA), the number of motion
vectors is rather high at 56,644. Consequently, this dataset may take some time to process, particularly
if GPU acceleration is not enabled. On a system using an NVIDIA RTX 2080 graphics card, the total time
to process was 242 seconds.
You can see the performance of your system by going to Metadata->View in the “Track Navigator”
window that appears after the processing has completed.
It is recommended that before you do anything else, go ahead and save the results by going to File-
>Save Tracks in the “Track Navigator” window. This way, you can easily revert back without having to
run the tracker again.
You will note that 1000 tracks were identified, as shown at the bottom of the “Track Navigator” window.
As you can see, sensitivity of 50% is sufficient to detect the faintest objects. If you were to re-run it with
a sensitivity of 0%, you would see that only 13 tracks are returned in total. Tracks at the top of the list
are most likely to be valid, while those ranked farther down the list are more likely to be false
detections.
49
Starting with v6.1, there is now an option to compute a “confidence” metric for each track, making it
much easier to determine which tracks are true detections. Navigate to Actions->Compute Confidence
from the “Track Navigator” menu to try out the feature. You can click “Cancel” at any time. The
confidence algorithm is very good at distinguishing real objects from random noise. However, camera
artifacts such as hot pixels can still appear as “real” objects due to their motion, so you will want to
ensure that you have removed such artifacts from the images during calibration.
Tip: If you still want to have high sensitivity, but do not want thousands of tracks returned, go to
Settings->Tracker from the main menu and specify the maximum number of tracks to be returned.
At this point you have a list of numerous tracks available to evaluate. It would be quite tedious to
examine them all in detail, so one task to carry out is to determine which tasks match up with an already
known object. To do this, go to File->Load Known Objects from the “Track Navigator”. You will now see
that most of the tracks in the first 20 entries are matched with a known object. One of the tracks --
number 16 -- is an erroneous match, having an “ObjDist” value exceeding 1.0 arcminute, while the other
matches have an “ObjDist” value under 0.3 arcminutes, indicating a good match. Again, this is a
configurable setting: you can set the match tolerance such that erroneous matches are less likely to
appear. However, some objects have higher uncertainty in their orbital elements, and so a higher
tolerance is desired. Finally, track #17 appears to be a potential discovery, as it does not match up with
any known object. So, in this scenario, you would proceed to create observations of that object by
double-clicking on its track entry (or right-clicking on it, and choosing “Verify Track” from the popup
menu that appears). With the “Verify Track” window open, you should now see an animation of the
track. You can visually inspect the object by examining the animation in the “Image Viewer”.
Tip: The animation is one way to verify that the object is real. Another way is to scroll through the
images in the “Track – Positions” window, which will present each image in the “Image Viewer” as you
scroll down using the “Down” arrow key. From this dialog you can also use the left and right arrow keys
50
to navigate to other tracks, which is much more convenient than going back and forth to the “Track
Navigator” window.
Proceed to create observations of this object by clicking the “Add Observations” button.
As this is an unknown object, leave both the permanent ID and the provisional ID fields blank. Only the
“Tracklet ID” field should be populated, with an identifier of your choice (however, the computer-
generated identifier should normally work fine).
At this point, you have created observations of a potential discovery. Now you will want to use the
“MPChecker” tool to see if these observations might still match up with an already known object. To do
this, navigate to the following webpage and input the observations of the object into the web form:
https://www.minorplanetcenter.net/cgi-bin/checkmp.cgi
Click the radio button “these observations” and then click “Produce List”. If the results come back with
“No Known Objects”, or if there are objects but the offsets are all greater than 0.1, then it may well be a
discovery. Note that the MPChecker tool requires observations in MPC1992 format.
As you look through the tracks in the list, you can see that the synthetic tracker does quite well at
detecting very faint asteroids. It even detected “2018 RB” in a fully blind fashion. However, there are
some limitations of the tracker to be aware of so that you can better understand how to optimize the
data for it.
51
For one, if your data has numerous “hot pixels” or other artifacts, then the tracker will produce subpar
results. This is because, although hot pixels may appear stationary on the un-aligned images, once the
images have been aligned, the hot pixels (and other artifacts) can now appear to have motion from one
image to the next. So, for best results, use a good dark frame, or some other mechanism to suppress
the hot pixels and other camera artifacts.
Second, be sure to take data that matches the motion of the object you wish to detect. If it is a very
fast-moving object, use short exposures of perhaps 10 seconds or even shorter. Otherwise, if the object
is slow-moving, you could use longer exposures such as 30 or 60 seconds. But most importantly, be sure
that the total exposure time is long enough so that the object exhibits sufficient motion. That is to say,
you could get away with using 10 second exposures even on a very slow-moving object: so long as the
total exposure time is long enough for the object to move at least 5 pixels, then the object should be
detectable. Generally, the first constraint for the tracker is the number of images, with a minimum of 11
required. And in fact, it is best to have at least 25 images, preferably 30-60 images (sometimes more).
With CMOS cameras having low readout noise, you can usually get away with shorter exposures, and
simply have more of them to reach the desired exposure count. If you are unsure of what exposure
times to use for a given object, navigate to Tools->Calculate Optimal Exposure Time from the main
menu. This window has its own “Help” file, which you can access by clicking on the “Help…” button.
Proceed to load and process the images, performing calibration, alignment, and plate solving. The
dataset to use is that of “ds3”.
Navigate to Action->Synthetic Tracker. Use sensitivity of 50%. For the tracker configuration, do not
apply any limit to speed or PA. There should be 121,104 vectors to be searched. Use crop of 60.
Granularity of 67% (default). Then click “OK” to start the tracker. With the total time increased from 1.4
hours to 2.2 hours, the tracker has to search a much larger number of trial vectors (from around 56k
vectors to 121k vectors), so the processing time will also be increased. On a machine equipped with an
NVIDIA RTX 2080 GPU, it took around 348 seconds to complete.
After the tracker has finished, you will note that it has found a total of 17 asteroids: the first 16 are rated
“high” confidence, then another “Med” (medium) confidence at track #21. Your track numbers may be
somewhat different if the images were processed with a different alignment option. Also, just because
a track is rated with “high” confidence does not automatically mean that it is a true target, but it does
help to narrow down which tracks need to be examined.
52
As you can see from these results, the additional dwell time and more exposures enabled the tracker to
identify more asteroids, including 2008 WY119 which is at magnitude 21. Note however that there are
diminishing returns to the longer dwell time. Especially with NEOs, where they will move out of the field
of view more quickly and therefore become undetectable, or eventually introduce curvature in their
motion. You will have to determine the optimal dwell time for the type of target you wish to detect.
Load the images from “ds2” and proceed to process them by performing calibration, alignment, and
plate solving.
Navigate to Action->Evaluate Thresholds from the main menu. Here you will see a new window appear
with settings for “FWHM”, “SNR”, “Sensitivity”, and “Granularity”, along with a few other options.
Also set FWHM to be in pixels, and enable the option “Compute magnitude of injected targets”. Then
click the “Start” button to start the process.
After a minute the module will finish. There should be three different magnitudes to examine since
three sets of targets were injected (SNR=0.6, 0.7, and 0.8). As you can see, detection of SNR=0.6 targets
is quite minimal as these are simply too faint to be detected in just 39 images. Detection of SNR=0.7
targets is improved, and as expected, targets with SNR=0.8 are detected the best.
You can hover the cursor over each grid element to see the exact detection performance for that
combination of sensitivity and granularity. At the lower-left corner, detection is worse due to having a
low sensitivity (20%) and granularity (also 20%). At the top-right corner, detection is best due to having
higher sensitivity (45%) and granularity (also 45%). But the trade-off in increased sensitivity is
processing time and number of false detections (which are partly mitigated via the “Compute
Confidence” routine).
53
Figure 52 - Detection with 39 Images
The previous step demonstrated that it is possible to detect 92 out of the 100 injected targets at
SNR=0.8, which corresponds to approximately magnitude 20.2 on these images. Now, re-run the
evaluation routine again, but this time use only the first 13 images. You should see a noticeable
reduction in detection, as shown in Figure 53:
With only 13 images, detection was reduced to 45 out of the 100 targets, using the same thresholds of
sensitivity=45% and granularity=45%. As you can see, there is indeed quite a difference in detection
capability with respect to the number of exposures.
54
Cluster Computing
A single computer (or graphics card) may take a few hours to conduct a full “blind search” of a dataset.
If it is desired to expedite the search process, Tycho offers the ability to divide the workload among
multiple compute nodes. In this hierarchy there is one primary node and one or more worker nodes.
The worker nodes can be configured by installing Tycho on each node and going to Network -> Manage
Worker Nodes for this Machine from the main menu.
Figure 54 shows the local configuration for a single machine that has four GPUs. Each GPU is assigned a
device index and port number. After adding the worker nodes to the list, you can then click the button
“View Command Line Syntax” to see an example batch file script that could be used to launch the
worker nodes from the command line. Alternatively, you could launch them from this dialog box by
clicking the “Launch Worker Nodes” button.
New in v7.4 is the ability to use CPU, rather than GPU, worker nodes. Simply leave the box for GPU
acceleration unchecked, and the worker node will instead rely solely on CPU performance. This may be
useful for those who do not have access to GPU hardware.
Once you have configured the desired worker nodes, you must instruct the primary node to use them.
This is achieved by going to Network -> Manage Worker Nodes for Cluster. Refer to Figure 55.
55
Figure 55 - Managing Worker Nodes
Initially there are no worker nodes. Click the “Add…” button (located in the lower-right corner) to add a
new node, and specify the hostname and port number. You should also specify a name for the node.
Then click “OK” and you will see the node appear in the list. In Figure 55 you can see that four nodes
were added, one for each of the worker nodes configured in the previous step. You can view
information on each node by clicking the “Ping Nodes” button.
If you need to clean up disk usage on a node you can click on “View Selected Node…” and a file browser
will be presented. You can delete files and folders here. However, this is generally not necessary as the
files are cleaned out at the start of each tracker run.
Having specified at least one worker node, Tycho will now display a cluster configuration screen when
you run the synthetic tracker. By default, it will show the primary node (Local machine) and also the
worker nodes that you added earlier. If you wish to exclude a node from being used, you may select it
and click “Deallocate Selected”. This will move the selected node to the list of “Unallocated Nodes”.
The tracker will only run on the nodes shown in the “Allocated Nodes” list. For example, if you
deallocate the primary (local machine) node, then the tracker will only run on the worker nodes.
56
Figure 56 - Cluster Configuration
Once you have configured the cluster as desired, click the “OK” button to proceed.
The next screen that appears is the “Cluster Status” screen, refer to Figure 57. On this screen you are
presented with the list of nodes on which the tracker will run (the allocated nodes from earlier). Be sure
that all nodes have returned a status of “Ready”, and then click the “Start” button to initiate the cluster
processing routine.
57
As each node processes the data, you will see the status of each node shown in the “Status” column.
Refer to Figure 58.
In this example, because each node is running an equivalent GPU, they each have almost identical
progress. Note that there are some circumstances in which it does not make sense to use multiple
GPUs, such as when one GPU is more than twice as fast as another. In that case, the other GPU would
simply cause the overall processing time to increase since the workload is distributed evenly between
the fast and slow GPU. In general, no single node should be more than N times as fast as any other
node, where N is the number of nodes.
58
Express Mode
Tycho can also combine the processing steps (calibration, alignment, and plate solving) into a single step
through the Express Mode feature.
Check the box next to each step to indicate whether or not to perform that particular step. Settings for
each step are applied by clicking the “Settings…” button next to the step and specifying the relevant
configuration. See Figure 59 for details.
59
Auto Run (Scripting)
Tycho offers the ability to process a set of files from the command line or through a batch script. This
feature is called “Auto Run” and operates on a set of pre-defined settings which can also be overridden
through the use of an “override” file.
In order to use the Auto Run feature, first navigate to Settings -> Auto Run from the main menu. You
will see a new screen appear as shown in Figure 60. The runtime settings determine the behavior of the
auto run module, such as whether or not it will perform the steps indicated by “Express Mode”. You can
also specify the contrast and intensity levels for the generated snapshot images. The “Advanced
Settings” are similar to those discussed in the earlier section covering the synthetic tracker.
60
Once you have configured the desired settings for Auto Run, click “OK” to save the settings. Then, you
can open a command window and issue a command to Tycho in the following format:
As an example:
"C:\Program Files\Tycho\Tycho.exe" 1 "C:\Users\Daniel\Desktop\iTelescope\data\pipeline\r1"
The above command will launch Tycho in auto run mode and process the files located in the ‘r1’
subdirectory.
Another way to use the Auto Run feature is to create a batch file, such as “auto_run.bat”, which
provides the path to Tycho and a default image directory. One might then simply replace this directory
whenever a new set of images are to be processed.
Finally, there is also the ability to create and use an override file. An override file will, as its name
implies, override the settings that you specified earlier. To create an override file, you can click “Create
Override File…” from the lower left corner of the window as shown in Figure 60. Then, copy and paste
the text into a new text file and save the file as “override.txt” adjacent to the input directory of images.
In other words, the override file should be placed in the same directory as the image directory, not
inside the image directory itself. In this fashion, you can then write a script to update the override file as
desired and the tracker will run accordingly.
Starting with version 6.2, it is now possible to specify the path to the override file as the last argument in
the command line invocation.
61
Pseudo-Flat Calibration
Version 3.0 of Tycho introduces a way to process raw images with a ‘pseudo-flat’ technique. The
resulting images are both flat and also normalized with a consistent background level. In other words, if
you perform pseudo-flat calibration, then you will not need to perform the ‘normalization’ step.
To perform this calibration, go to Action->Calibrate Images. For “Flat Frame”, specify “Use pseudo flat”,
and then click the “Settings…” button to adjust the settings as desired (usually the defaults are ideal).
By default, a window width of 41, with three passes (3), and an order statistic of 33% is ideal. You may
also specify a new background level or maintain the existing background level.
62
Dataset Ephemeris
Another new feature for v3.0 is the ability to directly attach object ephemeris to each image. This can
be useful for those performing NEO confirmation, as an initial starting point in determining what motion
vector(s) to use in finding the object.
First, go to Tools->Download Observations from the main menu. Then type in the object name, and
choose whether or not to retrieve the data from the NEOCP list or from the Observations database:
If the object has been confirmed, then it will no longer be on the NEOCP list, and you will have to choose
“From obs database (confirmed object)”.
Now click “OK” and the observations of the object will be shown (it may take a moment to retrieve the
data from the MPC server).
63
At this point, you can click “View in Find_Orb”, and the modified version of Find_Orb
(find_o64_modified.exe) will be invoked. If you do not have this modified version, please refer to the
downloads section on the Tycho website. Next, while keeping Find_Orb running in the background,
navigate back to the “Image Manager” and choose Ephemeris->Attach to Dataset. The ephemeris
information of the object is now applied to each image listed in the “Image Manager”.
At this point, assuming all went well, you should see the columns in the “Image Manager” populated
with ephemeris information for each image. Particularly useful is the “EPH_IN_FOV” column, which
indicates whether or not the object is expected to be within the field of view of the image.
For those images in which the object is not within the field of view, it is advised to remove them from
the dataset as they will simply degrade the resulting stacks and measurements. To do so, select the
images, and then choose List->Remove Selected from the “Image Manager” menu.
Another reason why the dataset ephemeris is helpful is that it can be used to provide an initial starting
point for conducting the search of an object. For example, in the configuration for the synthetic tracker,
you can click “Use Dataset Ephemeris” (located near the top-right), and it will then update the limits for
speed and position angle accordingly.
While this will work for 99% of objects, sometimes a very new discovery that has only a few
observations may not have a well-defined motion, so be careful when using the dataset ephemeris too
strictly. It may be necessary to open the search space, particularly for the speed. For example, on
object “2019 RC”, the dataset ephemeris suggested that the object was moving between 4.04”/min and
3.59”/min, when in truth, the correct motion was around 3.18”/min. Had the dataset ephemeris been
used directly, the object would not have been found. The solution is to widen the search space for such
objects where the orbit is not yet well-known.
64
Repositories
New in v5.0 is the concept of repositories, which provide a convenient way to store observations. For
example, one repository might be associated with ‘interesting’ objects for further follow-up, while
another repository might simply store all observations collected to-date. There are also two repositories
created for the purpose of storing “Near-Earth Object Confirmation Page” (NEOCP) objects and the
“Recently Confirmed” objects published by the Minor Planet Center (MPC).
One use case for the latter two repositories is to determine if an object you found matches up with an
object listed on the NEOCP or the “Recently Confirmed” page. In other words, while the “MPChecker”
tool (mentioned earlier) does a good job at identifying known objects from a set of observations, it does
not check recently confirmed objects (nor objects on the NEOCP page), so it is helpful to have another
tool that can do so. Searching for such a match is achieved through the use of the “Object Linker” tool,
accessible via Tools->Identify Linkages and covered in a later section.
Repositories can be accessed via Tools->Manage Repositories from the main menu.
Observations can be saved to the repositories through three different methods. For the
“NEOCP/Recently Confirmed” repositories, navigate to Actions->Download NEOCP/Recently Confirmed
from the “Repositories” menu. Another method is through the “Observations -- All Targets” window,
where it is possible to save the observations via File->Export to Repository. Doing this will group the
observations by object and save each object as a text file to the chosen repository. The third method is
through the “Text Form -- Observations" window, where the observations in the edit box can be saved
to a repository via File->Save to Repository. In this case, all of the observations in the edit box are saved
to a single text file in the chosen repository.
65
Clearing a Repository
For some repositories, it may be desirable to think of them as “temporary storage”. Thus it is desirable
to keep the repository itself, but not the items contained within it. To clear out a repository, right-click
on it and a context menu appears. From this pop-up menu, choose “Delete Contents”. The items in the
repository are then removed, while the repository itself remains available for future use.
Adding a Repository
A new repository can be added by choosing “Add…” from the Repositories window.
A repository can be removed from the list of repositories by selecting it from the list and clicking the
“Remove Selected” button from the Repositories window. Alternatively, one could also right-click the
repository and choose “Remove from List”. Note that removing a repository simply removes it from the
list – it does not delete the directory associated with the repository. To empty the contents of a
repository, follow the steps in “Clearing a Repository”. To delete the actual directory itself, choose
“Open in Explorer” and delete the directory.
Most actions, such as adding or removing a repository, will automatically refresh the list of repositories
as well as their associated object count. However, if one were to manipulate the objects of a repository
external to the Repository Manager (such as via Explorer), then the object count may be out of sync.
Simply click the “Refresh” button and all repositories along with the associated object count will be
refreshed.
There are two ways to view the contents of a repository. One is to simply choose “Open in Explorer”
which will reveal the standard directory window. The other method is to click the “Open…” button
while in the Repositories window, which will present a new window showing each item in the repository
along with the number of observations, the arc length, and the date of first and last observation for each
item. While in this window, you can right-click on an object and choose “View” or “View in Find_Orb”.
The first option, “View”, will copy the observations of the object to the text window (“Text Form –
Observations”). The latter option, “View in Find_Orb”, shows the observations in Find_Orb.
66
Figure 66 - Viewing Items in a Repository
Identify Linkages
Another new feature in v5.0 is the ability to identify linkages using a new “Object Linker” interface. This
module works alongside the new repository feature in that it allows one to simply specify a repository
that contains the desired objects for link detection.
As an example, consider the scenario of trying to determine whether or not a newly detected object is
already listed on the NEOCP or “Recently Confirmed” page. The first step is to update these repositories
(discussed earlier) by going to Actions->Download NEOCP/Recently Confirmed via the “Repositories”
window. Once these repositories have been populated, they can then be used in the Object Linker tool.
The next step is to then choose these two repositories as the “A” search path, and then choose the
repository containing the newly detected object as the “B” search path. Refer to Figure 67.
Once the link process has completed, the results are shown in the “Link Results” window. Up to 5 links
are shown per each object, depending on the setting “Links per object”. In this case, since there is only
one object in the “B” search path, there are exactly five results shown for applied setting. The results
are sorted by median residual. A median residual of one arcsecond or less (<1.00) is usually indicative of
a possible link. As shown in Figure 68, the object “DJP1001” links up with NEOCP object “P10XEUM”. By
right-clicking on the link, one can view each object as well the result of combining the observations of
each object. It is also possible to save the combined result to its own separate repository.
Another scenario for the Object Linker tool is to determine what links, if any, exist between two nights
of data from the same field. For example, you might have wondered if an object you detected on the
first night could really be found on the second night. Normally, you would use ephemeris information
and recover the object by setting the tracking parameters around that information. But in the case
67
where you have perhaps dozens or more objects to confirm between the two nights, it can be easier to
use the Object Linker tool.
68
Continuing with this example, you would first proceed to create the relevant observations for the first
night and store them in their own repository (e.g., “Night1”). Then, do the same for the second night
and store them in a repository, “Night2”. Next, use the Object Linker tool (Tools->Identify Linkages) and
specify “Night1” repository as Set A, and the “Night2” repository as Set B. Run the linker, and examine
the results. For each link having an acceptable median residual (typically < 1.00), keep it in the list.
Otherwise, if the link is not acceptable, delete it (right-click on the link(s) and choose “Delete”). Once
you have eliminated all invalid links, go back to the “Observations -- All Targets” window (or go to File-
>Load Observations if it is not currently available) and merge both nights of observations. For example,
if the Observations window is currently showing the observations from Night2, choose “File->Load
Observations (Append to Existing)” and choose Night1 observations to be appended to the list. Once
the Observations window is showing the combined observations of both nights, and you have the “Link
Results” window showing only the valid links between those two nights, you can then proceed to choose
Observations->Apply Confirmed Links from the Observations window and this will give each object that
has an associated link a shared designation. Finally, if you want to eliminate the observations for which
there is no confirmed link, you can choose Observations->Remove Unconfirmed.
Image Statistics
Another new feature for v5.0 is the ability to generate statistics for a given image, be it a single exposure
or a stack of exposures. These statistics can be generated by choosing File->Generate Stats for Current
Image… from the “Image Viewer”. It will prompt for the max number of stars to use, with 2000 being
the default. The stars are selected at random from the loaded catalog. It is recommended to use the
Gaia DR2 catalog to ensure reasonable depth of detection for images that reach past magnitude 18.
Once you have specified the max number of stars, click “Start” and the tool will begin collecting statistics
about the current image shown in the Image Viewer. Again, this could be a stacked image – for
example, by choosing “Selection->All” from the Image Manager, you would create a stack of all images.
Or it could be a single exposure. Either way, once the statistics have been generated, the results are
shown in the Image Statistics window. Refer to Figure 69.
Note: Be sure that the image is not derived from tracked motion. In other words, it must either be a
single image, or a stack of images with zero motion applied (the stars should not be streaked).
69
A number of fields are collected for each star in the image, including RA and Declination residuals, true
magnitude versus calculated magnitude, flux, FWHM, and SNR. Clicking on a row in the list will
automatically navigate to the associated star in the Image Viewer. It is also possible to generate plots
for some of these fields from the “Plot” menu. As an example, the “MaxRes vs Mag” plot will show a
graph indicating the relationship between magnitude and max residual, with the fainter magnitude stars
typically having a higher maximum residual (as expected). Using this graph, it is also possible to get an
idea of the limiting magnitude of the image, with the text in the lower-right corner indicating the % of
data points satisfying the threshold at a given magnitude. As an example, a single exposure from the
dataset “ds2” is shown in Figure 70.
It is also possible to export the data to a CSV file by choosing File->Save to CSV from the “Image
Statistics” window. This enables additional work to be done on the data through other programs such
as Excel.
One particularly useful feature of the “Image Statistics” tool is the ability to easily determine if the
image has a good plate solution attached to it, or has some other issue that would result in higher than
acceptable residuals. This can be accessed by going to Plot->Median Residual from the “Image
Statistics” window. From here, you have the ability to choose the number of divisions that comprise the
grid. In the dropdown labeled “Num divisions:”, choose “4” as the setting and you can see the image
divided up into a 4x4 grid, which each cell indicating the residual for that region of the image. An
example of a dataset that has excellent residuals across the entire image is shown in Figure 71, whereas
an example of a dataset with poor residuals is shown in Figure 72.
70
Figure 71 - Example of Dataset with Excellent Residuals
In Figure 72, the grid indicates that the dataset tends to have acceptable residuals in the inner portion of
the image, but poor residuals at the corners. When inspecting the images of this dataset, the stars at
the corners are shown to have very soft focus, while the stars at the inner region have sharp focus. This
matches well with the results shown in the grid. In summary, you can use this tool to help validate both
the quality of the images as well as the quality of the plate solution. If either one has subpar quality,
then that should show up in the grid display.
71
Constructing a Lightcurve
Tycho also offers the ability to construct lightcurves and determine rotation periods.
The datasets used by this example were captured by Platanus Observatory, which has MPC code “K80”.
Navigate to Settings->Observatory from the main menu. Then choose Action->Add Observatory from
the menu of the “Observatory Configuration” window. It will prompt for the observatory details.
Specify “K80” (without quotes) for the “Label” field. Choose “Already have an MPC code” for the
observatory status. Then specify “K80” (again without quotes) for the MPC code. Click the button
“Apply location from MPC code” to automatically populate the location information. The “Telescope”
field is not important for this example, but you can use the same settings as shown in Figure 74. Then
click the “Next…” button to continue to the next page.
On the second page, make sure your settings match those shown in Figure 75. Then click “Finished” to
add the new observatory.
Find the new observatory in the list. Then right-click on it and choose “Make Active” from the popup
menu that appears.
72
Figure 74 - Configuring Observatory 1/2
73
Step 2: Load the “Ivar Night 1” Dataset
Launch Tycho and navigate to List->Add Images from the “Image Manager”. The images for this
example are located in the “n1” subdirectory of the dataset labeled “Ivar Lightcurve”. There should be a
total of 123 images in this dataset, which is the first of three nights of data collected for this object.
Navigate to Action->Express Mode and click the “Settings…” button located to the left of “Align”. As
there are a lot of images, you may want to choose the “Internal” option since it is very fast to process
the 123 images. Then, navigate to the “Internal” tab to configure the settings. Ensure that the “Mode”
is set to “Normal”. Distortion correction is not required for these datasets (and would only increase the
processing time), so leave it unchecked. Then click “Save Settings” to continue.
74
Figure 78 - Plate Solve Settings
Finally, back at the “Express Mode” window, click the “Settings…” button located to the left of “Plate
Solve”. If you have not yet configured the plate solver, proceed to do so now. Refer to the section
labeled “Configure the Plate Solver” for details.
Then, verify that your “Express Mode” settings match those shown in Figure 79.
75
At this point, you should be ready to process the images for the first night (n1). Click the “Start” button
on the “Express Mode” window to proceed. After a minute, the images should be aligned and plate
solved.
From the “Image Manager”, navigate to List->Add Images and load the images from the output
directory, “n1_a”. You should once again have approximately 120 images loaded, except this time they
are now processed and ready for measurements to be created. Before moving onto the next step,
navigate to Action->View Images from the main menu.
The default photometry apertures are 4.0 pixels for the inner annulus, 2.0 pixels for the dead-zone
(region between inner and outer annulus) and 9.0 pixels for the outer annulus. To adjust the apertures,
choose Photometry->Modify Aperture Settings from the “Image Viewer” menu. Here a new window will
appear, where you can adjust the aperture settings. You will also note that the crosshairs have changed
to indicate the current aperture. An optimal inner annulus will include most of the light from the target
and a minor amount from the background sky. When satisfied with the setting, click “Close”.
76
As shown in Figure 80, I have adjusted the radius to be 5.8 pixels for the inner aperture and 2.9 pixels for
the Dead zone. It is also a good idea to click the button “Copy Target to Comp Star”, so that the
comparison stars use the same aperture as that of the target object. However, this is not necessary if
the box labeled “Force comp stars to use same aperture as target” is checked. Again, the optimal
aperture should be determined by the target. If you are working on a known asteroid, you can find it in
the image by selecting File->Load Known Objects from the “Image Viewer”. For variable stars, you can
choose Photometry->Variable Stars from the “Image Viewer”.
New in v8.0 is the ability to manually specify which stars are used as comparison stars (comp stars) for
the photometry measurements. If you wish to have Tycho automatically choose comp stars, then you
can skip this step. Otherwise, proceed to navigate to Photometry->Find Comp Stars from the menu of
the “Image Viewer”. You should see a new window appear that resembles the one shown in Figure 81.
On the right half of the window there is a graph showing a trend line. This indicates the relationship
between instrument magnitude and true magnitude for each star that meets the filter specified in the
left half of the window. Ideally, the slope of this line would be 1.00 and the standard deviation (Std)
would be 0.00, indicating a perfect fit of the data.
One common reason for a larger deviation is if you have the “Max magnitude” filter set too high. These
exposures are only 2 seconds, so the default max of 20.0 includes a lot of very faint stars. To remedy
this, specify a lower value for “Max Magnitude” (such as 16.0) and then click the “Refresh” button. The
graph will update accordingly.
You can also filter stars by solar temperature, specifying a desired lower- and upper-bound for (B-V).
The Sun has a (B-V) value of around 0.6, and it is usually common to set the min and max to 0.5 and 0.9
77
respectively. Alternatively, if you are working in (V-R), you could instead apply a filter for that range of
temperatures. The other filters work in a similar fashion with a min and max setting.
The radius filter is a new option introduced in v8.1. It allows one to filter the comparison stars by
proximity to the marker position(s). As an example, this might be useful if you wanted to select
comparison stars that reside near the object. To apply the filter, first create a marker by going to
Create->Marker 1 from the “Image Viewer” menu, or right-clicking inside the image and choosing Create
Marker 1 from the popup menu. The marker will be created at the current location of the crosshairs.
Next, click on the “Radius” checkbox to enable it, and then adjust the slider to set the desired radius
from the marker. If you create both marker 1 and marker 2, then the center of the circle will be defined
as the midpoint of the two markers. As an example, you might define marker 1 as being the first
position of the object, and marker 2 as the last position of the object as it moves across the field. As
with the other options, click the “Refresh” button to update the filter.
Each star that “survives” the resulting filter is then shown on the trend line as a red circle. You can click
on a red circle and Tycho will then center the star in the “Image Viewer”. If you want to use the given
star as a comparison star for photometry, you can then right-click in the graph and choose “Add to
Active Comp Stars” from the popup menu that appears. Alternatively, you could double-click on the star
in the “Image Viewer”, right-click, and choose “Add to Active Comp Stars” from that popup menu. Both
approaches accomplish the same result.
If you want to see more information about a star, double-click on it in the “Image Viewer” to center it,
then right-click and choose “View Star Information” from the popup menu that appears. This will
present a new window as shown in Figure 82.
Once you have an initial set of active comparison stars, you can navigate to Graph->Generate Data from
the menu of the “Active Comparison Stars” window. This will measure each comp star across all of the
images and generate graph information for each one as shown in Figure 83.
Be sure that “Graph->Computed Mag vs Time” is the current graph setting. If not, navigate to Graph-
>Computed Mag vs Time to set the option. For each comparison star, the graph shown on the right-half
of the window should present a mostly flat, horizontal line of data points. This indicates that the star
has a consistent measured magnitude throughout all the images in the dataset. If you see variability in
the measured magnitude, then it is likely a good idea to discard it from the list. This can be done by
78
right-clicking on the star in the list, and choosing “Remove Comp Star” from the popup menu that
appears.
It is usually common to choose around 5 to 7 comparison stars. Once you are satisfied with the list of
active comparison stars, then you are ready to make photometry measurements. If you decide that you
want to revert back to the “automatic” comp star selection, simply select all of the stars in the list, right-
click, and choose “Remove Comp Star”. This will result in an empty list, and Tycho will assume that it
therefore needs to identify its own set of comparison stars.
The most straightforward approach to generating the measurements is to define two markers indicating
the motion of the object. For this example, go to the “Image Manager” and click on the first image in
the list, so that the first image is shown in the “Image Viewer”. Then, locate the asteroid in the view and
double-click on it to center it. If you are not sure where the asteroid is located, you could animate the
frames, or you could attach ephemeris information and create a stack from ephemeris (refer to Example
#4 earlier in this document). A third option is to invoke File->Load Known Objects from the “Image
Viewer” menu. Be sure to click back on the first image if it is not selected. Then, once the object is
centered (by double-clicking on it), right-click and choose “Create Marker 1” from the popup menu that
appears. Next, choose the final image in the list (at the “Image Manager”), then locate the object in this
last image. Once again, double-click the object to center it, and then right-click and choose “Create
Marker 2” from the popup menu. At this point, you should now have two markers defined, indicating
the motion of the object. For objects that have no motion (such as stars), you would simply define both
markers at the same location.
Now that the markers have been defined, right-click in the “Image Viewer” and choose “Generate
Photometry Set”. Depending on the number of images, this can take a moment to generate the
measurements. Once finished, the set of measurements will be added to a new window, “Photometry
Sets”. It is also a good idea at this point to save your work, so proceed to File->Save to Repository from
the “Photometry Sets” menu. You will be prompted to specify a name for the entry. In this example I
chose “ivar_test” (without the quotes) for the name. Then click the “Save” button to save the data.
79
From the “Photometry Sets” menu, navigate to Graph->Plot all Sets and you will see a new window
appear with the raw plot of the data you have taken.
In Figure 84, you can see the raw plot of the first night of data for Ivar. If desired, navigate to Data-
>Settings from the menu of the “Lightcurve” window and validate that the settings are as you want
them to be (such as Exclude Outliers). If you ever need to delete data points, you can click and drag a
rectangle selection around them, then right-click and choose “Delete” from the popup menu that
appears. Or, you can right-click on them in the “Photometry Measurements” list and choose “Delete”
from that popup menu.
If you made any changes to the data, you can save the photometry set again by going to File->Save to
Repository from the menu of the “Photometry Sets” window. You can overwrite the previous entry or
create a separate entry.
If you were to conduct a period search with just this first night of data, you might get lucky and find the
correct period. If you want to try, navigate to Period->Find Period from the menu of the “Lightcurve”
window. A new window, “Period Search” appears. Make sure your settings match those in Figure 85
and then click the “Find Period” button to proceed.
You will note that from just this first night of data, the first candidate period is 2.36 hours, and the
phased plot does not quite resemble a “bi-modal” curve (two valleys and two peaks). If you click on the
second candidate period, 4.74 hours, then the phased plot resembles a bi-modal period, which suggests
80
we are closer to finding the correct period. Using additional data (from nights 2 and 3) you will see that
the correct period of 4.795 hours will be found with no issue.
As mentioned earlier, you can click on the different “candidate periods” to automatically refresh the
phased plot display. These candidate periods are shown in the “Period List” window as indicated in
Figure 86.
At this point you will want to include additional data for the period search. You will also want to use
lighttime correction (LTC) and (H-G) correction. These steps are explained below.
The previous steps showed how to process the data for the first night. Now we want to do similar and
include nights 2 and 3 as additional photometry sets for this repository. The data for these nights are
located in “ivar_n2” and “ivar_n3”. Go ahead and create observations of the asteroid for night 2. If the
81
resulting photometry set window contains only night 2, you can append night 1 by going to File->Load
From Repository and choosing the repository you created earlier.
Proceed to save your progress by going to File->Save to Repository from the “Photometry Sets” menu.
As before, you can overwrite the previous entry.
Now, as you did for night 2, do the same for night 3, so that you have three photometry sets.
Once you have the three photometry sets shown in the “Photometry Sets” window, you will want to
apply object data to them. What this does is compute the Phase, Altitude, PABL, PABB, and Absolute
Magnitude for every single observation. To do this, select the three sets, then right-click and choose
“Apply object data” from the popup menu that appears. If you are not working with a minor planet,
then you can skip this step.
A new window will appear, “Apply Object Data”. Here you can specify the number and name of the
object. If the orbital elements of the object are not yet established (such as a newly discovered object)
then you can choose the option “Apply from observations” and click “OK”. In this example, the object
82
has number 1627, so you can specify that in the “Object Number” field and then click “Search”. Then,
click on the returned result and choose “Apply from selected object”, and then click “OK” to proceed.
In the case where you might instead choose “Apply from observations”, you will be prompted for the
Find_Orb instance associated with the object. If you do not already have such an instance loaded, go to
Tools->Download Observations from the main menu, and specify the object. Then click “OK” to
download the observations; a new window with the observations will appear. Then click on “View in
FindOrb”. Navigate back to the “Select FindOrb Instance” window, and click the “Refresh” button to see
the new instance appear in the list. Select it and then click “OK” to proceed.
After a moment, you should see the object data applied to each of the three photometry sets. Your
“Photometry Sets” window should now be similar to that shown in Figure 87. Once again, save your
progress by going to File->Save to Repository. As before, you can save over the previous entry.
Note: If you take several nights of data and find that a given night requires some sort of “offset”
adjustment to match up with another night, you can either apply an automatic offset or a custom offset.
For automatic offset, select the three photometry sets, right-click and choose “Auto offset (absolute)”
from the popup menu that appears. For a custom offset, select the set of interest, right-click and
choose “Custom mag offset”. For these three nights, no offset is required.
Now, from the “Photometry Sets” window, navigate to Graph->Plot all Sets. You will see a raw plot as
shown in Figure 89. Because object data has been attached to these sets, both lighttime correction
(LTC) and (H-G) correction are applied by default. You can check this by navigating to either the “LTC”
menu (for lighttime correction) or the “Magnitude” menu (for “H-G” correction). Using (H-G) correction
is typically important when performing period analysis, as it normalizes the measurements across phase
angle and distance. Refer to https://www.britastro.org/asteroids/dymock4.pdf for more details on (H-
G) correction.
83
Step 9: Final Period Search
Navigate to Period->Find Period from the “Lightcurve” menu. Use the settings as shown in Figure 90.
Click the “Find Period” button and you will notice that this time, with all three nights of data available,
Tycho is able to find the correct period (4.795 hours) and also lists it as the first candidate. It also
displays a period spectrum, or “periodogram”, which is a graph showing the other possible periods
throughout the search interval of 1-12 hours. If you want, you can also re-run the period search using a
different Fit order. Figure 92 shows an example of a 9th order fit to the data. Usually, 4th order is a good
starting point, and you want to avoid “overfitting” the data.
84
Figure 92 - Phased Plot using a 9th Order Fit
You can also choose different styles for the graph. As an experiment, navigate to Style->Classic from the
“Lightcurve” window.
85
Figure 94 - Phased Plot using the Classic Style
As this is a known asteroid with several published rotation periods, it should be possible to determine if
the period you identified is correct. To do this, navigate to Tools->Lightcurve Database from the main
menu. Then, type “1627” (without the quotes) into the field next to “Search for”, and also check the
box labeled “Whole word only”. Then click the “Search” button. It may take a moment as it has to
access the online database.
When the search has completed, there should be one result returned. From this result you can
determine several characteristics of the object, including its diameter, absolute magnitude (H), slope
(G), albedo, period, and amplitude. From this result it should indicate a period of 4.795 hours, matching
the photometry result that was generated earlier.
86
Step 11: Generate Observing Circumstances Table
If you wish to publish your results in the Minor Planet Bulletin, you may need to generate the values for
the “Observing Circumstances” table. New in v9.0.6 is the ability to do so directly from the “Lightcurve”
window.
As shown in Figure 96, the phase, PABL, PABB, and other relevant values for the observing
circumstances table are computed and displayed for publication. To access this window, navigate to
File->Obs. Circumstances from the “Lightcurve” window. Note that you need to have conducted a
period search in order for the period, period error (P.E.), and other associated values to be computed.
At some point you will probably want to share your photometry data with others. The ALCDEF format
provides a standard way to do so. Navigate to File->Export ALCDEF from the “Photometry Sets” window
and you will be shown a window prompting for details on the observations. When ready, click the “OK”
button and the data will be exported to a text file. Alternatively, you could also export the data via File-
>Export ALCDEF (use current metadata). This option makes use of the metadata attached to each
photometry set, which you will want to verify before using. To verify the metadata, select a photometry
set and then right-click and choose “View/Edit Metadata”.
Also note that the orbit information returned by Find_Orb will be associated with that of the
observatory referred to by the “MPCCode” column. If the code is 247 (indicating roving observer), then
it will use the “ObsLon” and “ObsLat” columns. These columns are populated automatically when
creating photometry sets from observations, but should you need to change them, you can edit the
metadata by choosing “View/Edit Metadata” from the context menu that appears when right-clicking
the sets. The relevant keywords are shown in Table 1.
For more information on the ALCDEF keywords, and the ALCDEF format in particular, visit
www.alcdef.org.
87
Step 13: Importing ALCDEF Data
To import ALCDEF data, navigate to File->Import ALCDEF from the “Photometry Sets” window. If the
“Photometry Sets” window is not open, you can access it by navigating to File->Photometry Analysis
from the main menu.
Once you have imported data, you will note that it has no object data attached to it. To apply object
data, select the sets that are in the list and then right-click and choose “Apply object data”. As before,
you will be prompted for the Find_Orb instance that has computed the orbit for your object. Once
object data has been applied, you will then be able to use the various attributes such as Absolute
Magnitude, PABL, PABB, and phase.
New in v9 of Tycho is the ability to more easily adjust the magnitude offsets associated with each
photometry set. Magnitude offsets can sometimes be required when working with data taken several
nights apart. To experiment with this capability, load two or more photometry sets into the
“Photometry Sets” window (see previous section) and then choose Graph->Plot All Sets from the menu.
Hold down the left mouse button and then drag a rectangle around the data points to be adjusted.
Upon releasing the left mouse button, the enclosed data points inside the rectangle will be highlighted
with a red circle. Next, right-click inside the plot area and a popup menu will appear. From this menu
you can choose to adjust the magnitude offset in increments of 0.1, 0.01, and 0.001 magnitude.
Alternatively, you can instead use the keyboard shortcuts: key up, key down, along with holding down
the SHIFT key (0.01 increment) or CTRL key (0.001 increment). Refer to Figure 97.
88
Generate Transformation Coefficients
The Tycho software can be used to generate transformation coefficients. These are useful if you wish to
transform photometry data to the “Standard” system. The primary motivation in doing so would be to
compensate for differences in the spectral response of equipment between observers.
First, you will need to supply a special set of images to Tycho. These images should capture a “Standard
Field”, such as M67 or NGC 7790. A list of standard fields is available from the AAVSO website:
https://app.aavso.org/vsd/stdfields
Furthermore, at least two different filters should be used throughout the image set. In this example,
five filters are used: UBVRI. The images should be taken such that the filters are switched out from one
image to the next. For example, one capture of UBVRI images, followed by another capture of UBVRI
images. For the ultraviolet (U) images, you may need to use a longer exposure.
89
“Min SNR” constraint (default of which is 50.0). The other possibility is that there were
no magnitude pairs found (such as B and V).
b. If you see outlier data points in the plot, you can simply click and draw a rectangle
around the data point(s) to form a selection. Once you have selected the outlier
point(s), right-click in the plot and choose “Delete”. If you accidently deleted the wrong
data point(s), you can restore them by clicking the button “Restore Deleted”. Note that
this will restore every deleted data point.
c. To view different coefficient plots, adjust the selection shown in the “Horizontal” and
“Vertical” dropdowns at the bottom-left of the window. For example, the “Horizontal”
dropdown allows one to specify a different magnitude pair (such as B-V or V-R).
Meanwhile, the “Vertical” dropdown allows one to specify the coefficient for that pair.
You can explore the different combinations, removing outliers as needed.
11. Once you are satisfied with the data, you can then click the button labeled “Generate Transform
Coefficients”. This will produce a report containing the numbers for your transformation
coefficients. The text from this report can then either be copied and pasted into another view
or, you can navigate to File->Save to save the report as a text file. Refer to Figure 101.
90
Figure 99 - Create Measurements
91
Figure 101 - Computed Transformation Coefficients
Additional notes:
For the (U-B) pair, it can be necessary to adjust the “Min SNR” filter to 25 (from the default of 50) in
order to include a wider range of star colors. This can be observed by the horizontal axis. With SNR=50,
it has a range from -0.5 to 0.3. But with minimum SNR lowered to 25 (allowing more stars), the
horizontal axis now ranges from -0.5 to 1.2 and results in a more comprehensive trendline.
Alternatively, it could have been more optimal to take a longer exposure for the U filter, as 300 seconds
was not quite sufficient.
Measurements are created using the current aperture. The aperture can be modified by navigating to
Photometry->Modify Aperture Settings from the “Image Viewer” menu.
While not shown in this example, it is also possible to use multiple exposures of each filter. The process
would involve capturing one set of exposures for each filter, followed by another set, repeating until the
desired number of sets is acquired. This can produce a trendline with more data points to work with.
An example dataset can be downloaded here:
https://storage.googleapis.com/tycho_data-1/2/NGC7790_iTelescope_T11.zip
Session Planner
Another new feature in v9 of Tycho is the Session Planner module. This module permits one to easily
identify when a given object will be visible and its corresponding location in the sky. But more
interesting is that it also works with both Find_Orb as well as the JPL Horizons interface. As one
92
example, you could generate a session plan to determine when and where to look for the James Webb
Space Telescope (JWST) from your particular observing location.
To activate the Session Planner, navigate to Tools->Session Planner from the main menu. Note that you
may need to have the Pro license for this feature to work. Next, navigate to Ephemeris->Attach from JPL
Horizons from the menu of the Session Planner. This will bring up the JPL Horizons interface, refer to
Figure 102. Here you can specify a spacecraft (such as JWST), an asteroid or comet, or any other object
given by its Two-Line Element (TLE).
In this example, we want to generate ephemeris for the James Webb Space Telescope. So, choose
“Major-body (including spacecraft)” from the dropdown menu located next to “Lookup Type”. Then
input the value “-170” (without quotes) into the Target ID field. If you are unsure of the identifier
associated with the major body that you wish to work with, you can navigate to Search->Major-body
Lookup from the JPL Horizons Interface menu. Refer to Figure 103.
This will bring up a new window initially populated with every single major-body listed (482 at the time
of this writing). To narrow it down to the object of interest, you can filter by “Name contains” or “Alias
contains” in the two edit boxes at the bottom of the window. For example, you could type “James”
(without quotes) into the “Name contains” field and it would reduce the list to just that of the James
Webb Space Telescope. You will then notice that the “Ident” column is equal to -170 for this particular
object. Now that you have the identifier, you can specify it in the “Target ID” field in the interface
window.
93
Figure 103 - Major-body Lookup for JPL Horizons Interface
At this point, you have specified the “Lookup Type” to be that of Major-body, and the “Target ID” to be
that of -170. You would next proceed to navigate to Ephemeris->Attach to Session Planner from the “JPL
94
Horizons Interface” menu, but before doing so, you will want to update the “Start Date”, “Stop Date”,
and “Step Size” fields located at the bottom of the Session Planner window. Refer to Figure 104 for an
example.
Here you can see that the “Start Date” is March 7, 2022 and the “Stop Date” is March 9, 2022. The
“Step Size” is 10 minutes. The dates are also in UTC time as indicated by the checkbox. If you want, you
can also specify the “Local time offset”, associated with your observing location. If you unchecked the
box indicating that the dates are in UTC time, then that offset will be applied to the start and stop dates
for the request. It will also be shown in the “Date (Local)” column. Note that the time offset does not
take into account Daylight Savings Time (DST) – it is just a simple time offset for convenience purposes.
Once you are satisfied with the “Start Date”, “Stop Date”, and “Step Size” parameters, navigate back to
the JPL Horizons Interface window and proceed to choose Ephemeris->Attach to Session Planner from its
menu. If all goes well, your planner window should resemble that as shown in Figure 104, with the list
showing the coordinates of the object for each particular time and date. You can also choose to enable
a filter to reduce the results such that the list will only show coordinates whenever the object is above a
certain altitude, and/or whenever the moon and sun are below a certain altitude.
The Session Planner also works with Find_Orb, so if you have an object that is not available from the JPL
Horizons Interface (perhaps a newly-discovered object), then you can still generate a session plan by
choosing Ephemeris->Attach from Find_Orb from the Session Planner menu.
AutoRun
AutoRun requires three command line arguments, with an optional fourth argument
Usage: <tycho> <mode> <path to image directory> [override file]
<tycho> = Full path to Tycho executable
<mode> = 1 (for regular autorun) or 101 (for image subset autorun)
<path> = path to input directory
[over] = path to override file (will use 'override.txt' if not specified)
Image Preview
Image preview requires three arguments
Usage: <tycho> <mode> <path>
<tycho> = Full path to Tycho executable
<mode> = 3
<path> = path to image
Debayer
Debayer requires 5 arguments
Usage: <tycho> <mode> <cpu> <input dir> <output dir>
<tycho> = Full path to Tycho executable
<mode> = 12
<cpu> 0=use existing settings, 1=force CPU mode
<input dir>
<output dir>
95
Calibration
Calibration requires 9 arguments
Usage: <tycho> <mode> <cpu> <dark_frame> <flat_frame> <normalize> <fix_pixels> <input
dir> <output dir>
<tycho> = Full path to Tycho executable
<mode> = 7
<cpu> 0=use existing settings, 1=force CPU mode
<dark_frame> 0=no dark, path is file=use that file, path is dir=select from dir
<flat_frame> 0=no flat, 1=use pseudo flat, path is file=use that file
<normalize> 0=no normalization, 1=perform normalization
<fix_pixels> 0=do not fix hot pixels, 1=fix hot pixels
<input dir>
<output dir>
Resize
Resize requires 12 arguments
Usage: <tycho> <mode> <cpu> <width> <height> <hcrop> <vcrop> <bin> <hdiv> <vdiv> <input
dir> <output dir>
<tycho> = Full path to Tycho executable
<mode> = 8
<cpu> 0=use existing settings, 1=force CPU mode
<width> 0=keep width unchanged; otherwise, specifies desired width
<height> 0=keep height unchanged; otherwise, specifies desired height
<hcrop> 0=no cropping in horizontal; otherwise, specifies desired horizontal cropping
<vcrop> 0=no cropping in vertical; otherwise, specifies desired vertical cropping
<bin> 1=1x1 (no binning), 2=2x2 binning, etc
<hdiv> 1=no divisions, 2=divide by 2 in horizontal, etc
<vdiv> 1=no divisions, 2=divide by 2 in vertical, etc
<input dir>
<output dir>
Note: Desired dimension overrides crop amount.
Align
Alignment requires 9 arguments, with an optional reference index
Usage: <tycho> <mode> <cpu> <num_threads> <interpolate> <align_mode> <dist_corr>
[idx_ref] <input dir> <output dir>
<tycho> = Full path to Tycho executable
<mode> = 9
<cpu> 0=use existing settings, 1=force CPU mode
<num_threads> = Number of threads to use for the alignment process
<interpolate> 0=bilinear, 1=bicubic
<align_mode> 0=fastest, 1=normal (do not use 'fastest' unless images are already mostly
aligned)
<dist_corr> = Whether or not to apply distortion correction (0=no, 1=yes; only
available if align_mode=normal)
[idx_ref] = Index (range of 0 to N-1) of the reference image (optional)
<input dir>
<output dir>
Merge
Merge requires 6 arguments
Usage: <tycho> <mode> <num_threads> <max_delta_time> <input dir> <output dir>
<tycho> = Full path to Tycho executable
<mode> = 10
96
<num_threads> = Number of threads to use for the merge process
<max_delta_time> = Max amount of time (in seconds) between images to be considered a
match
<input dir>
<output dir>
Cross-Match
Cross-match requires 5 arguments
Usage: <tycho> <mode> <create_snapshots> <path_a> <path_b>
<tycho> = Full path to Tycho executable
<mode> = 11
<create_snapshots> 0=do not create snapshot images; 1=create snapshot images
<path_a> = Full path to the root directory of the 'A' camera track files
<path_b> = Full path to the root directory of the 'B' camera track files
Object Linker
Object Linker interface requires 7 arguments
Usage: <tycho> <mode> <link_timeout> <num_threads> <dirs_set_a> <dirs_set_b> <path_out>
<tycho> = Full path to Tycho executable
<mode> = 14
<link_timeout> = Timeout, in seconds, for each link
<num_threads> = Number of threads to operate during linkage
<dirs_set_a> = Full path to file listing the directories for Set 'A'
<dirs_set_b> = Full path to file listing the directories for Set 'B'
<path_out> = Full path to output linker result
Star Extractor
Star Extractor interface requires 6 arguments
Usage: <tycho> <mode> <downsample> <extract_mode> <path_in> <path_out>
<tycho> = Full path to Tycho executable
<mode> = 15
<downsample> = Downsample, from 1 to 10 (default of 2).
<extract_mode> = 1=Standard, 2=Extended
<path_in> = Full path to the directory containing subdirectories of .fits image files
<path_out> = Full path to the output directory
97
Troubleshooting
If you find that a window has an incorrect size, restart Tycho and navigate to Window->Reset Window
Positions from the main menu. Be sure to do this on a fresh launch of Tycho, prior to opening any new
windows. This will reset any previously saved window position information.
Additional Resources
This guide has covered the basics of how to use the Tycho software. There are also tutorial videos on
the website at https://www.tycho-tracker.com
Finally, if you run into any issues or have questions or comments, please feel free to contact me using
the “Contact” page on the website, or try out the new forum:
https://groups.google.com/forum/#!forum/tycho-tracker
98