ADES Astrometry Parser        Great Shefford Observatory

ADES Astrometry Parser Contents

ADES Astrometry Parser Overview        2

Installation:        2

Quick start guide:        3

Registration        3

Initial settings        4

Screen Controls:        5

Summary of ADES data entry methods        5

Main functional screen areas        6

Target Type        6

Edit Areas        8

Other screen controls        10

Submitting ADES data to the MPC        11

Local use file copies        11

ModifyACK        11

Toolstrip        12

Settings        14

Astrometrica        14

cURL        14

File paths        14

MPES        14

NEOCP        14

Settings        14

User settings        14


ADES Astrometry Parser Overview

ADES Astrometry Parser is a 32-bit Windows program that

Astrometry converted to the old MPC1992 format by the Astrometry Parser can be used in various MPC web pages where ADES astrometry is still not accepted, e.g., the MPChecker. It should NOT be used to convert ADES astrometry to MPC1992 format to then submit to the MPC in the old format. If you have ADES formatted astrometry it should be submitted to the MPC directly, without conversion.

Note: The Astrometry Parser is designed to operate on text containing a single batch of astrometry, of one type i.e., there must be only one set of ADES headers and the astrometry should relate to a single MPC observatory code and a single type of object selected (e.g., NEOCP, MBA, Comet etc.), see the section on Target Type.

Installation:

Unzip the installation files (setup.exe and setup.msi) into a local temporary folder

Run setup.exe.

A standard Windows setup dialogue will be displayed, acceptance of the license agreement is required.

The program requires the .Net Framework 4.6.1 or later to be installed.

The setup creates a program group called “J95Soft” and adds an icon for “Astrometry Parser”

After successful installation the zip file, setup.exe and setup.msi can be deleted.

The program can be uninstalled from Programs and Features in Control Panel.


Quick start guide:

Registration

The program requires registering and will display a registration screen for the first 100 days.

During that time, please request a license key to register the program.

After registration this screen will no longer display (but is accessible from the Help / About screen, see Toolstrip)  

The registration details should be retained, as they may be needed again in case the program is re-installed.


Initial settings

When the program is run for the first time it will require a few settings before normal use and will prompt the user with the Settings window:

Values for the following settings should be entered before continuing:

In the User Settings category:

Please see the Settings section for a complete description of all settings.

Press OK when settings have been entered. The main Astrometry Parser window will now display.


Screen Controls:

The Astrometry Parser before any data is loaded:

Summary of ADES data entry methods

If conversion of existing ADES text to MPC1992 format text is all that is required, then either drag/drop .psv files from Windows Explorer onto the upper edit area, or manually copy/paste ADES psv text to the upper edit area, then press Parse and convert to generate MPC1992 formatted text into the lower edit area.


Main functional screen areas

Here the main functional areas of the screen are highlighted. See later sections for more detailed descriptions.

Please note that the program is best run maximised due to the length of ADES text lines

Target Type

Astrometry Parser is designed to handle astrometry for objects of one type at a time.e.g. Objects on the NEOCP should not be mixed with measurements of already known NEOs or Main Belt Asteroids etc.

The selection of Target type modifies the default file name if the files are subsequently saved. In the example above, type Comet is selected and the “Next file name” has been automatically changed to have a suffix of “Comet.psv”, intended as an aid to identifying archived astrometry batches.

Target type is also used to categorise the ADES data if the Astrometry Parser is used to submit the astrometry directly to the MPC. If “NEO” or “Comet” are selected a checkbox labelled “discovery?” is displayed, allowing the user to indicate that the observer thinks the object being reported is a new, previously undiscovered object and so is reporting it as a new NEO candidate, or a new comet. Other objects that the observer thinks may be new should be reported using the TempID type and do not need to be flagged as potentially new objects, this will be determined by the MPC.

The Astrometry Parser uses more types than are defined by the MPC, purely as a convenience to the observer. The table shows the mapping of Target types in the Astrometry Parser to MPC object types on the ADES submission form at https://minorplanetcenter.net/submit_psv. The Valid IDs column indicates the types that can be used depending on the IDs used in the ADES astrometry lines (permID, provID, trkSub, artSat).

Target Type

New object?

MPC unusual object Type

Valid IDs

Description

NEOCP

neocp

trkSub

Object currently on the NEOCP

PCCP

neocp

trkSub

Object currently on the PCCP

NEO

Yes

neo candidate

trkSub

Possible new NEO candidate (not on NEOCP)

NEO

neo

permID,

provID

Known NEO

NEO_VI

neo

permID,

provID

Known NEO currently listed as a virtual impactor

Comet

Yes

new comet

trkSub

Possible new comet (not on PCCP)

Comet

comet

permID,

provID

Known comet

TNO

tno

permID,

provID

Known Trans-Neptunian Object

Unusual

unclassified

permID,

provID

Known object not covered by neo, comet or tno types and not a Main Belt Asteroid (MBA)

MBA

unclassified

permID,

provID

Known object not covered by types listed above (mainly Main Belt Asteroids)

TempID

unclassified

trkSub

Possible new non-neo, non-comet object (possible new asteroidal objects with a NEO rating not high enough to reach the NEOCP)

ARTSAT

artsat

artSat

Artificial satellite

GPS

artsat

artSat

Artificial satellite (used for timing calibration, including satellites from GPS, Galileo, GLONASS, BeiDou and JXSS systems)


Edit Areas

The upper and lower edit areas are text boxes that can be edited by the user but are also manipulated by the Astrometry Parser.

The section Summary of ADES data entry methods highlights the three methods to get astrometry into the upper edit area

Pressing the Parse and convert button will attempt to convert the ADES text in the upper area into MPC1992 formatted text in the lower area.

IMPORTANT: The ADES text MUST include the column heading line, (see example below) as well as the astrometry lines for the MPC1992 conversion to work.

Example ADES column headings:

permID |provID     |trkSub  |artSat      |mode|stn |obsTime                |ra         |dec        | …

Including all ADES heading lines will also allow the conversion to create most or all of the equivalent MPC1992 format headings in the lower edit area.

The user can manually edit the ADES text (e.g. to add Observing notes in the ADES notes column), or can right-click on a specific  astrometry line to use context menu options to manipulate the text. These context menu options are:

Exclude by ID (adds a single line or all lines for the same ID if Ctrl pressed to the “Exclude submitted” list), see Submission History / Exclude submitted description for further information)

After manual editing is complete, use Parse and convert to refresh the changes to the lower edit area in MPC1992 format.


Other screen controls


Submitting ADES data to the MPC

ADES data has to be saved in a text file before it can be submitted to the MPC. The FilePath setting must contain an existing folder name where these files can be stored. The ADES text in the upper edit area is saved as a file with the  Save text as file toolstrip button and the name of the file saved is shown in the File to submit field. The folder containing saved files can be opened in Windows Explorer by clicking the  Open MPC Reports path with Explorer toolstrip button.

Local use file copies

Additionally, if the   Add private ADES skeleton comment line (not transmitted to MPC) toolstrip button is used to add “# localuse comment” and “! localuse line” lines for manual editing to the ADES text, then an extra file suffixed “_localuse” will be automatically saved, to hold a version of the ADES data containing the private comments, along with the original file name holding the ADES text without the private comments. In the previous screen example, if the ADES text contained private comments, then two files would be saved,

MPC20210121D_NEO_VI.psv                (No private comments, file for submission to MPC)

MPC20210121D_NEO_VI_localuse.psv        (including private comments, NOT to be submitted to MPC)

ModifyACK setting

The acknowledgement (MPC ACK keyword) line generated by Astrometrica is formatted as:

MPCReport file updated <yyyy.mm.dd hh:mm:ss>

where <yyyy.mm.dd hh:mm:ss> is the date and time that Astrometrica generated the batch.

The MPC has recommended that observers should make their ACK lines more informative (see MPEC 2018-W60). Setting ModifyACK to True generates an enhanced ACK line from the information available to the Astrometry Parser:

<MPC Observatory code> <object type> <object name (or number of objects if more than 1)> <yyyy.mm.dd hh:mm:ss> <File ID>

where <yyyy.mm.dd hh:mm:ss> is the time the program last parsed the ADES text.

Examples of generated ACK lines:

ACK J95 NEO VI (2021 AY5) file updated 2021.01.23 01:53:59 B

ACK J95 MBA (5 objects) file updated 2020.11.19 00:28:38 K


Toolstrip

Icon

Description

Open astrometry from Astrometrica    F5. Loads the upper edit area with the astrometry from the Astrometrica output file ADESReport.psv. Same as pressing function key F5.   If “Exclude submitted” is selected, only astrometry that has not already been submitted to the MPC from this program will appear in the upper edit area, otherwise, all astrometry in the file will be shown.

Only enabled if AstrometricaLogsPath setting is a valid folder.

Parse and convert. Any ADES astrometry in the upper edit area is converted to 80-column MPC1992 format astrometry and placed in the lower edit area. This button can be used any time, to re-convert if for instance the ADES lines have been changed (e.g., if photometry has been removed, or observing notes codes added to a line). The converted MPC1992 text is automatically copied to the clipboard.

Save text as file. The text in the upper edit area is saved as a text file in the folder named in Settings, FilePath. Before saving, the file name to be used is shown in the “Next File Name” area. This name is constructed as “MPC<yyyymmdd><letter>_<type>.psv, where:

<yyyymmdd> is the session date = the local date when the local time was last 12 noon (i.e. yyyymmdd does not change during the night)

<letter> is a sequential single character, ranging from A-Z, then 0-9, incremented each time a file is saved

<type> is the currently selected type (NEOCP, NEO, MBA, Comet etc.). This is included in the file name to allow the user identify files of a specific object type quickly.

Only enabled if FilePath setting is a valid folder.

 

Submit ADES astrometry file to the MPC. After ADES astrometry is saved using Save text to file this button is enabled allowing the user to select “submit” to send the batch to the live MPC server, or to select “validate” to validate the structure of the ADES text using the MPC’s “Validating ADES-2017 PSV Formatted Observation” service.

Only enabled if “File to submit” is an existing .psv file in the folder named in the FilePath setting.

Find next unused File ID. Searches the current session date’s text files in the folder named in Settings, FilePath for the next unused <letter>, see Save text as file.

Only enabled if FilePath setting is a valid folder.

Add ADES skeleton comment line. Adds a “# comment” line followed by an empty “! line” line to the ADES text to allow the user to easily add manual comment line(s) to be sent to the MPC. A valid comment might appear as:

   # comment

   ! line This is text to send to the MPC with this batch

If multiple lines are required, manually copy and paste extra “! line” lines. There should only be a maximum of one “# comment” line in a batch.

Add private ADES skeleton comment line (not transmitted to MPC). Similar to “Add ADES skeleton comment line” but constructs a “# localuse comment” line followed by an empty “! localuse line” line to the ADES text to allow the user to easily add manual comment line(s) that will NOT be sent to the MPC. Use if there is a need to save information about the batch that is not relevant to the MPC. If multiple lines are required, copy and paste extra “! localuse line” lines.  There should only be a maximum of one “# localuse comment” line in a batch. See also Local Use file copies.

Undo. Attempts to undo changes made to the ADES text.

Clear. Clears all text from the upper edit area.

Add all unsubmitted lines in current ADESReport.psv to Submission history. Works in conjunction with the “Exclude submitted?” check box. Use when all astrometry intended to be sent to the MPC has been sent, leaving some lines that should not be sent. This option adds all unsubmitted lines to the submission history. If Exclude submitted? is ticked then this will stop them from being added back into the upper edit area if Open astrometry from Astrometrica    F5 is pressed. See also context menu option “Exclude by ID”.

Only enabled if AstrometricaLogsPath setting is a valid folder.

Cancel long running http operation. Only displayed during http operations. If there are network issues during downloading of data from the internet, press this button to abandon the http operation.

Open copy of submission history .csv file. Hold Ctrl+Shift to open original file. The submission history is a text file with .csv extension that can be opened with a text editor e.g., Notepad, or a spreadsheet program e.g., Microsoft Excel. This button will invoke the program associated by the operating system to .csv files to open the file. Note: a copy of the file is used unless Ctrl+Shift are held down while clicking the button. If the actual file is opened with Excel, be aware that this will lock the file from being written to the next time an ADES batch is submitted to the MPC.

Only enabled if FilePath setting is a valid folder.

Rename current Astrometrica log files. Appends the LastWriteTimeUtc of the ADESReport.psv file, in yyyymmddhhmmss format to the three Astrometrica log files if they exist. So, if the .psv file was last changed on 2021-Jan-18 19:38:48 UTC then the ADESReport.psv, Astrometrica.log and PhotReport.txt files would be renamed to ADESReport20210118193848.psv, Astrometrica20210118193848.log and PhotReport20210118193848.txt. If there is no .psv file and the 80-column MPC1992 format file MPCReport.txt exists, the LastWriteTimeUtc of that file will be used instead.

Only enabled if AstrometricaLogsPath setting is a valid folder.

Open MPC Reports path with Explorer.  Windows Explorer is used to open the folder defined by the FilePath setting, where saved MPC astrometry batches (ADES .psv files and converted MPC1992 .txt files) are stored by the Astrometry Parser.

Only enabled if FilePath setting is a valid folder.

Open Astrometrica logs path with Explorer. Windows Explorer is used to open the Astrometrica Output directory, configured in Astrometrica’s Environment settings tab and stored in the AstrometricaLogsPath setting here.

Only enabled if AstrometricaLogsPath setting is a valid folder.

Refresh Astrometrica log folder via Astrometrica.ini (Ctrl = prompt for location of Astrometrica.ini). Resets the AstrometricaLogsPath setting by using the Astrometrica.ini file to locate the current Astrometrica Program settings (configuration) file and within it the OutDir setting for the Astrometrica Logs path. On Win7 and Win10 PCs the Astrometrica.ini file is located as standard in C:\Users\<user>\AppData\Local\Astrometrica where <user> is the current Windows user name and this will be used as a default to locate Astrometrica.ini. Hold Ctrl when clicking the button to allow the path to be entered directly if required. Alternatively use the Settings dialogue to Browse to the AstrometricaINIPath folder.

Settings. Display the Astrometry Parser Settings window to allow editing all program settings. See Settings section.

Help / About. Display program version details, contact information and registration.

Exit program.

Settings  

Category

Setting

Description

Astrometrica

AstrometricaCFGFile

Name automatically detected if not explicitly set. Used to warn user if a different configuration file is currently in use by Astrometrica

AstrometricaModuleName

Used to detect if Astrometrica is running. Default = Astrometrica.exe

cURL

cURLCMD

Full name (path and file name) to curl executable. E.g. C:\Windows\System32\curl.exe

Used to submit ADES batches to the MPC

cURLURLProd

URL to submit ADES batches to MPC, default = https://minorplanetcenter.net/submit_psv

cURLURLTest

URL to validate ADES batches, default = https://minorplanetcenter.net/submit_psv_test

File paths

AstrometricaLogsPath

Automatically extracted from current Astrometrica configuration file

AstrometricaINIPath

Astrometrica INI file (path and file name). If not set will be defaulted to "C:\Users\<user>\AppData\Local\Astrometrica", where <user> is the current Windows user name

FilePath

Name of folder where MPC astrometry batches (.psv and .txt versions) are stored

MPES

MPCRoot

Used during extraction of astrometry from MPES. Default =  https://minorplanetcenter.net

MPESURLAstrometry

URL to retrieve astrometry from MPES. Object name is substituted for <mpesobject>. Default = https://minorplanetcenter.net/db_search/show_object?utf8=%E2%9C%93&object_id=<mpesobject>

NEOCP

NEOCPURLAstrometry

URL to retrieve astrometry from NEOCP. Object name is substituted for <neocpobject>. Default = https://cgi.minorplanetcenter.net/cgi-bin/showobsorbs.cgi?Obj=<neocpobject>&obs=y

Settings

SettingsExportFolder

Folder to export application settings text files into

User settings

AC2

MPC AC2 keyword containing a valid email address

ModifyACK

Use enhanced formatting of ACK line for ADES submissions and MPC1992 conversions

TargetTypeDefault

Target type selected when program starts, used during validation of ADES submission to MPC. Select from drop-down list, default = NEOCP

Software version 1.1.43                 27/01/2021 19:37:00

ADES Astrometry Parser © Peter Birtwhistle 2017-2021         Great Shefford Observatory