The McDonald Observatory High Spectral Resolving Power Observations of Comets Liens =================================================================================== Documentation ============= file: 'survey.pdf' --> Because PDS4 is functionally different from PDS3 in how data will be accessed (users accessing products via the PDS4 database/search tools will not see the directory structure), Section 2 of this document would better serve the user if it described the files rather than the directory organization. - Suggested rewrite for the first paragraph of Section 2: "This archive collection is comprised of 'Data' and 'Documentation'. The data are spectra in '.fits' files with PDS4 '.xml' labels. The documentation gives context to the data, its acquisition at the telescope, and its processing. The user should start with this document, 'survey.pdf', which describes the data collection." - Suggested rewrite for the beginning of each paragraph in Section 2.1: "Every comet data filename has a unique prefix to indicate a particular comet. Some comets are observed on multiple nights but will all have the same prefix. Stars that were observed for calibration purposes can be identified by their filename prefix, listed by type (e.g. sol for solar, flx for flux standards and hot for rapidly rotating hot stars) and date of observation." --> Filename is 'survey.pdf', but in Section 2 it is referred to as "survey_overview.pdf" / "Survey_overview.pdf". Please correct. --> In line 2 / 1st paragraph, capitalize "coudé" since it is part of the instrument name ("McDonald Observatory Tull Coudé Spectrograph"). --> In the last paragraph of Section 5, fix typo: "list incudes" => "list includes". --> Missing indent on the first paragraph of each section (likely a LaTeX formatting issue). --> Stylistic suggestion: Check whether "V" in "V sin i" should be lowercase or written as one word ("vsini"), consistent with 'starlist.pdf'. --> In the data reduction description, note that the user will also need to account for the heliocentric velocity of the comet (not just the geocentric velocity) when subtracting the solar continuum, since the reflected solar spectrum reflects both the heliocentric and geocentric velocity. Additionally, for cases where the solar standard is not the solar port, state that the user will need the radial velocity of the star to properly align the spectra (and ensure those stellar radial velocities are included). --> The document mentions that some spectra had cosmic rays removed by hand and the user should be cautious of those, but there is no indication of which spectra/nights these are. Please specify which nights/spectra include hand removals of cosmic rays. --> Add clarification explaining the difference/inconsistency between exposure time and dark time in the headers (when end times are not able to be specified). file: 'log.pdf' --> Add a footnote stating what the geometry variables represent (heliocentric distance and velocity, geocentric distance and velocity). --> Reconcile date discrepancies between 'log.pdf' and 'weather.pdf' (see 'weather.pdf' below for the specific date additions/removals). Note: for 31 Jul 2022, C/2017 K2 data is listed in the log and weather on 31 Jul 2022, yet the actual K2 data files were on UT 01 Aug 2022. --> Fix the following typos: - 46P/Wirtanen first line filename is truncated: "irt0001" => "wirt0001" (or "wir0001") - 71P/Clark dates: "13May20175" => "13May2017" and "15May20175" => "15May2017" - Prefix typo: "wirt*" => "wir*" --> Update prefix capitalization and spelling in 'log.pdf' to match the actual data filenames: - "TemTut*" => "temtut*" - "67CG*" => "67cg*" - "KUS*" => "kus*" - "RL*" => "rl*" - "linA2*" => "lina2*" - "2001Q4*" => "2001q4*" - "2002V1*" => "2002v1*" - "gar*" => "garr*" - "panL4*" => "panl4*" - "ISON*" => "ison*" - "linX1*" => "linx1*" - "loveR1*" => "lover1*" - "panX1*" => "panx1*" - "loveQ2*" => "loveq2*" - "panS2*" => "pans2*" - "panER61*" => "paner61*" - "panR2*" => "panr2*" - "panK2*" => "pank2*" - "panT2*" => "pant2*" - "ATLASL3*" => "atlasl3*" - "ATLASY4*" => "atlasy4*" - "ATLASM3*" => "atlasm3*" - "ATLASR4*" => "atlasr4*" - "ztfV2*" => "ztfv2*" - "panS3*" => "pans3*" - "ztfE32*" => "ztfe3*" - "ATLASU2*" => "atlasu2*" - "ATLASE1*" => "atlase1*" - "lemH2*" => "lemh2*" file: 'starlist.pdf' --> Fix typo: "109 Vir" should be "108 Vir" (also check the corresponding data labels 'flx21Feb2017_[123].xml' and 'flx26May2004.xml' which list "109 Virginis"). --> Stylistic suggestion: Write "v sin i" as "vsini" (consistent with 'survey.pdf'). --> If a non-solar-port star is used as a solar standard, ensure the radial velocity of the star is included so users can properly align the spectra. --> There are several stars included in the data files as flux standards or hot stars that do not show up in Tables 1 & 2 of 'starlist.pdf', even though 'survey.pdf' indicates their information should be in the tables. Either add these missing stars to the tables or add documentation explaining why they are omitted: - Missing from Flux list: HR 718, HR 7586, HR 8634, HR 9087, HR 9097 - Missing from Hot list: HR 26, HR 128, HR 189, HR 455, HR 533, HR 664, HR 718, HR 847, HR 1126, HR 1140, HR 1307, HR 1660, HR 1776, HR 2231, HR 2659, HR 3067, HR 3197, HR 3589, HR 3690, HR 3885, HR 4197, HR 4357, HR 4684, HR 5191, HR 5392, HR 5770, HR 6410, HR 6502, HR 6571, HR 6664, HR 6723, HR 6984, HR 7301, HR 8634 file: 'weather.pdf' --> Reconcile dates between 'weather.pdf', 'log.pdf', and the actual data in the collection: - 20 Aug 2018: No 38P data included for 20 Aug; remove 38P from weather for this date. - 03 Oct 2018: No 64P data included for 03 Oct; remove this date from weather. - 28 Jan 2018: C/2016 R2 data is in log, but date is not in weather; please add date to weather. - 22 Feb 2018: C/2016 R2 data is in log, but date is not in weather; please add date to weather. - 31 Jul 2022: C/2017 K2 data is in log and weather on 31 Jul 2022, yet the K2 data were on UT 01 Aug 2022. - 23 Sep 2023: No C/2023 E1 data included for 23 Sep (also typed as E3 => E1); remove E1 from weather for this date. - 16 Nov 2023: C/2017 K2 data is in log, but date is not in weather; please add date to weather. --> The Jan dates for 2023 are repeated and out of chronological order. Please remove extraneous info and combine weather conditions as needed (e.g., "Light cirrus" vs. "Clear then cloudy" and "Clear"). --> Fix comet designation typos: - 08 Jan 2019: "64P" => "46P" - 09 Jan 2019: "64P" => "46P" - 24 Jul 2020: "E3" => "F3" - 29 Jul 2020: "E3" => "F3" - 11 Aug 2020: "E3" => "F3" Data ==== --> No issues found. Labels ====== All Labels ('collection.xml' and 'data/*/*.xml') --> Missing/Updated Context Objects & Observing_System fixes: - Telescope: The LID 'urn:nasa:pds:context:telescope:mcdonald.smith2m7' was made obsolete in 2021. Update to 'urn:nasa:pds:context:telescope:mcdonald.harlanjsmith_2m7' and expand from "2.7m Telescope" to "Harlan J. Smith 2.7m Telescope" in all labels. - Instrument: Create the new instrument context product for 'urn:nasa:pds:context:instrument:mcdonald.harlanjsmith_2m7.tull_coude_spectrograph' (SBN/data provider to coordinate with EN). In all labels, fix the for the Tull Coudé Spectrograph from "is_telescope" to "is_instrument". - Note on Observatory: Keeping Host for McDonald Observatory is correct as Facility/Observatory are deprecated. --> Suggest adding a entry for Small Bodies Gas Study in 'collection.xml' and all data '.xml' files: Small Bodies Gas Study --> Credit and Funding Acknowledgements: - Add a object to in 'collection.xml' (for the grant supporting this dataset compilation, as well as NASA grants noted at the end of 'survey.pdf') and in individual product labels where applicable. - Add other data providers/observers as contributors (or authors/editors) in 'collection.xml' and in the individual data labels they contributed to. --> Action for SBN (Context Object Updates): - Add alternate name "103P/1986 E2 (Hartley 2)" to 'urn:nasa:pds:context:target:comet.103p_hartley_2' (or update the data labels to use the context product name). - Add alternate name "19P/1904 Y2 (Borrelly 1)" to 'urn:nasa:pds:context:target:comet.19p_borrelly' (or update the data labels to use the context product name). - Add alternate name "67P/1969 R1 (Churyumov-Gerasimenko 1)" to 'urn:nasa:pds:context:target:comet.67p_churyumov-gerasimenko' (or update the data labels to use the context product name). - Coordinate with EN to create new context objects for any comets and stars in this collection that do not already have one, and include their s in the labels. file: 'collection.xml' --> SBN to coordinate and create DOI for collection. --> In : - is rounded up due to loss of precision; update from "1995-10-03T11:37:30Z" to "1995-10-03T11:37:29.600Z". - is incorrect ("1995-10-04T11:42:21Z"); update to "2024-11-01T03:35:50.350Z" (matching the stop time of the last data file collected, star HR 8634 on the 01 Nov 2024 observing night). --> No target is listed in 'collection.xml'. Please add lid_references to all targets referenced in this collection (or include appropriate target identification). --> In , add s to 'log', 'starlist', and 'weather' (in addition to 'survey') so they are linked to the collection in the PDS4 database. files: 'survey.xml', 'log.xml', 'starlist.xml', 'weather.xml' --> Add a block in the for all four document XML labels (e.g., version_id 1.0, initial version). --> In 'survey.xml', add s linking to the other document files ('log', 'starlist', and 'weather') via their LIDs. files: 'data/*/*.xml' --> The collection overview document 'urn:nasa:pds:gbo-mcdonald:comet_echelle_survey:survey::1.0' is currently referenced as 'urn:nasa:pds:gbo-mcdonald:comet_echelle_survey:overview' (which does not exist). Please update the reference to the correct LIDVID ('urn:nasa:pds:gbo-mcdonald:comet_echelle_survey:survey::1.0') and add a explaining what the document is / how it relates to the data file (e.g., description of instrument, data reduction, etc.). Also consider referencing 'log', 'starlist', and 'weather' in the data label Reference_List as appropriate. --> Suggest adding RA, DEC (using the starting or average RA/DEC with a comment noting when exposures are hours long), airmass, and JD from the FITS headers into the XML labels, as the XML labels are the primary source of searchable metadata in PDS4. --> Include existing target context s for stars (including PSA LIDs where applicable if not created in PDS, e.g., HD 93521, HR 153, HR 1544, HR 4468, HR 7001, HR 718; see EN Liens below for the full list of PDS target LIDs). EN Liens ======== *.xml - URLs should start with https:// not http://. The latter happens 1104 times for .xsd and 3313 times for .sch, e.g. data/103P_Hartley2/hart0001.xml: ... http://pds.nasa.gov/pds4/disp/v1/PDS4_DISP_1O00_1510.xsd collection.xml: of the telescope from 2.7m Telescope to Harlan J. Smith 2.7m Telescope - This LID is new. Please provide Engineering Node its context product urn:nasa:pds:context:instrument:mcdonald.harlanjsmith_2m7.tull_coude_spectrograph - Citation_Information/doi is missing - Ideally, add lid_references to all targets referenced in this collection. data/.../*.xml - All have urn:nasa:pds:gbo-mcdonald:comet_echelle_survey:overview but no label in this collection has that LID - the extraneous namespace specification pds: is given a few times per label: ... Suggestion: remove it, e.g. ... - Only the labels in 19P_Borrelly/, 67P_*/, and 103P_* have lid_references to their targets. Of those, these context products already exist, so please add lid_references to them and possibly change urn:nasa:pds:context:target:comet.2p_encke 2P/Encke urn:nasa:pds:context:target:comet.8p_tuttle 8P/Tuttle urn:nasa:pds:context:target:comet.17p_holmes 17P/Holmes urn:nasa:pds:context:target:comet.19p_borrelly 19P/Borrelly urn:nasa:pds:context:target:comet.21p_giacobini-zinner 21P/Giacobini-Zinner urn:nasa:pds:context:target:comet.24p_schaumasse 24P/Schaumasse urn:nasa:pds:context:target:comet.38p_stephan-oterma 38P/Stephan-Oterma urn:nasa:pds:context:target:comet.41p_tuttle-giacobini-kresak 41P/Tuttle-Giacobini-Kresak urn:nasa:pds:context:target:comet.45p_honda-mrkos-pajdusakova 45P/Honda-Mrkos-Pajdusakova urn:nasa:pds:context:target:comet.46p_wirtanen 46P/Wirtanen urn:nasa:pds:context:target:comet.55p_tempel-tuttle 55P/Tempel-Tuttle urn:nasa:pds:context:target:comet.62p_tsuchinshan_1 62P/Tsuchinshan 1 urn:nasa:pds:context:target:comet.64p_swift-gehrels 64P/Swift-Gehrels urn:nasa:pds:context:target:comet.67p_churyumov-gerasimenko 67P/Churyumov-Gerasimenko urn:nasa:pds:context:target:comet.71p_clark 71P/Clark urn:nasa:pds:context:target:comet.73p_schwassmann-wachmann_3-b 73P/Schwassmann-Wachmann 3 B urn:nasa:pds:context:target:comet.73p_schwassmann-wachmann_3-c 73P/Schwassmann-Wachmann 3 C urn:nasa:pds:context:target:comet.88p_howell 88P/Howell urn:nasa:pds:context:target:comet.103p_hartley_2 103P/Hartley 2 urn:nasa:pds:context:target:comet.141p_machholz_2 141P/Machholz 2 urn:nasa:pds:context:target:comet.144p_kushida 144P/Kushida urn:nasa:pds:context:target:comet.c1999_h1_lee C/1999 H1 (Lee) urn:nasa:pds:context:target:comet.c1999_s4_linear C/1999 S4 (LINEAR) urn:nasa:pds:context:target:comet.c1999_t1_mcnaught-hartley C/1999 T1 (McNaught-Hartley) urn:nasa:pds:context:target:comet.c2001_a2_linear C/2001 A2 (LINEAR) urn:nasa:pds:context:target:comet.c2001_q4_neat C/2001 Q4 (NEAT) urn:nasa:pds:context:target:comet.c2002_v1_neat C/2002 V1 (NEAT) urn:nasa:pds:context:target:comet.c2007_n3_lulin C/2007 N3 (Lulin) urn:nasa:pds:context:target:comet.c2009_p1_garradd C/2009 P1 (Garradd) urn:nasa:pds:context:target:comet.153p_ikeya-zhang 153P/Ikeya-Zhang urn:nasa:pds:context:target:comet.c2011_l4_panstarrs C/2011 L4 (PANSTARRS) urn:nasa:pds:context:target:comet.c2012_s1_ison C/2012 S1 (ISON) urn:nasa:pds:context:target:comet.c2013_r1_lovejoy C/2013 R1 (Lovejoy) urn:nasa:pds:context:target:comet.c2013_us10_catalina C/2013 US10 (Catalina) urn:nasa:pds:context:target:comet.c2013_x1_panstarrs C/2013 X1 (PANSTARRS) urn:nasa:pds:context:target:comet.c2014_q2_lovejoy C/2014 Q2 (Lovejoy) urn:nasa:pds:context:target:star.sun Sun If desired, EN will make context products for those used in 12P_Pons-Brooks/ 13P_Olbers/ 122P_deVico/ 156P_Russell-LINEAR/ C_2000WM1_LINEAR-Hartley/ C_2006WM_SWAN/ C_2014S2_PanSTARRS/ C_2015ER61_PanSTARRS/ C_2015V2_Johnson/ C_2016R2_PanSTARRS/ C_2017K2_PanSTARRS/ C_2017O1_ASASSN/ C_2017T2_PanSTARRS/ C_2018Y1_Iwamoto/ C_2019L3_ATLAS/ C_2019Y4_ATLAS/ C_2020F3_NEOWISE/ C_2020M3_ATLAS/ C_2020R4_ATLAS/ C_2020V2_ZTF/ C_2021S3_PanSTARRS/ C_2022E3_ZTF/ data/19P_Borrelly/borr0001.xml (urn:nasa:pds:gbo-mcdonald:comet_echelle_survey:borr0001.fits::1.0) NAIF ID - Regarding target 19P 19P/1904 Y2 (Borrelly 1) please use the name in the context product, 19P/Borrelly or alias NAIF ID 1000005 would also work. Alternatively, ask for your string to be added as an alias. data/67P_Churyumov-Gerasimenko/*.xml - Regarding target 67P 67P/1969 R1 (Churyumov-Gerasimenko 1) please use the name in the context product, 67P/Churyumov-Gerasimenko or alias "NAIF ID 1000012" would also work. Alternatively, ask for the alias data/103P_Hartley2/*.xml - Regarding target 103P 103P/1986 E2 (Hartley 2) please use the name in the context product, 103P/Hartley 2 or alias NAIF ID 1000041 would also work. Alternatively, ask for the alias. data/C_2000WM1_LINEAR-Hartley/*.xml - The directory name implies a 2000 comet, but all have Target_Identification/name C/2001 WM1 (LINEAR-Hartley) EN already has a context product with LID and name urn:nasa:pds:context:target:comet.c2000_wm1_linear C/2000 WM1 (LINEAR) but not for C/2001. data/C_2002C1_Ikeya-Zhang/*.xml - do you want to change this directory name to 153P_Ikeya-Zhang? data/stars/*.xml - Add lid_references for existing star context products, and request EN to create context products for any not written yet (see full file-by-file mapping in EN review notes). data/stars/flx01Aug2018_[123].xml data/stars/flx03Feb2012_1.xml + 10 more - The top 3 have Target_Identification/name of "HR 7001" while the other 11 have "alpha Lyrae". Perhaps converge