{"id":11722,"date":"2021-02-08T16:40:59","date_gmt":"2021-02-09T02:40:59","guid":{"rendered":"http:\/\/www.eaobservatory.org\/jcmt\/?page_id=11722"},"modified":"2026-05-05T11:58:36","modified_gmt":"2026-05-05T21:58:36","slug":"wvm","status":"publish","type":"page","link":"https:\/\/www.eaobservatory.org\/jcmt\/instrumentation\/wvm\/","title":{"rendered":"WVM"},"content":{"rendered":"<p style=\"text-align: justify\">The JCMT relies on its in-cabin line-of-sight 183 GHz radiometer, the WVM (Water Vapour Monitor) to measure the PWV (Precipitable Water Vapour) and report the sky opacity at (the historically used) 225 GHz. The WVM is critical for both <a href=\"https:\/\/www.eaobservatory.org\/jcmt\/instrumentation\/continuum\/scuba-2\/\">SCUBA-2<\/a> observations (see the note about <a href=\"https:\/\/www.eaobservatory.org\/jcmt\/instrumentation\/continuum\/scuba-2\/calibration\/#Extinction_Correction\">extinction correction<\/a>) and also for use by <a href=\"https:\/\/www.eaobservatory.org\/jcmt\/instrumentation\/heterodyne\/namakanui\/\">N\u0101makanui<\/a>, as well as determining the current <a href=\"https:\/\/www.eaobservatory.org\/jcmt\/observing\/weather-bands\/\">weather conditions<\/a> for programs to observe under, according to the JCMT&#8217;s <a href=\"https:\/\/www.eaobservatory.org\/jcmt\/observing\/guidelines-for-flexible-observing\/\">Flexible Observing<\/a> Guidelines.<\/p>\n<p><a href=\"http:\/\/www.eaobservatory.org\/jcmt\/wp-content\/uploads\/sites\/2\/2021\/02\/black-wvm-in-cabin.jpg\"><img loading=\"lazy\" class=\"aligncenter wp-image-11723\" src=\"http:\/\/www.eaobservatory.org\/jcmt\/wp-content\/uploads\/sites\/2\/2021\/02\/black-wvm-in-cabin-286x300.jpg\" alt=\"\" width=\"400\" height=\"419\" srcset=\"https:\/\/www.eaobservatory.org\/jcmt\/wp-content\/uploads\/sites\/2\/2021\/02\/black-wvm-in-cabin-286x300.jpg 286w, https:\/\/www.eaobservatory.org\/jcmt\/wp-content\/uploads\/sites\/2\/2021\/02\/black-wvm-in-cabin-143x150.jpg 143w, https:\/\/www.eaobservatory.org\/jcmt\/wp-content\/uploads\/sites\/2\/2021\/02\/black-wvm-in-cabin.jpg 720w\" sizes=\"(max-width: 400px) 100vw, 400px\" \/><\/a><\/p>\n<p>The WVM works by obtaining measurements of the 183 GHz water line in a number of channels.<\/p>\n<div id=\"attachment_11724\" style=\"width: 610px\" class=\"wp-caption aligncenter\"><a href=\"http:\/\/www.eaobservatory.org\/jcmt\/wp-content\/uploads\/sites\/2\/2021\/02\/water-line-frequency-brightness-wvm-channels-graph.png\"><img aria-describedby=\"caption-attachment-11724\" loading=\"lazy\" class=\"wp-image-11724\" src=\"http:\/\/www.eaobservatory.org\/jcmt\/wp-content\/uploads\/sites\/2\/2021\/02\/water-line-frequency-brightness-wvm-channels-graph-300x213.png\" alt=\"\" width=\"600\" height=\"426\" srcset=\"https:\/\/www.eaobservatory.org\/jcmt\/wp-content\/uploads\/sites\/2\/2021\/02\/water-line-frequency-brightness-wvm-channels-graph-300x213.png 300w, https:\/\/www.eaobservatory.org\/jcmt\/wp-content\/uploads\/sites\/2\/2021\/02\/water-line-frequency-brightness-wvm-channels-graph-768x545.png 768w, https:\/\/www.eaobservatory.org\/jcmt\/wp-content\/uploads\/sites\/2\/2021\/02\/water-line-frequency-brightness-wvm-channels-graph-150x106.png 150w, https:\/\/www.eaobservatory.org\/jcmt\/wp-content\/uploads\/sites\/2\/2021\/02\/water-line-frequency-brightness-wvm-channels-graph.png 978w\" sizes=\"(max-width: 600px) 100vw, 600px\" \/><\/a><p id=\"caption-attachment-11724\" class=\"wp-caption-text\">The three double side band frequency channels of the water vapour monitor super imposed on the spectrum of the water line for 0.5, 1 and 1.5 mm of PWV (image taken from <a href=\"http:\/\/docs.eao.hawaii.edu\/newJCMT\/instruments\/WVM\/01\/m_wiedner_thesis.pdf\">Atmospheric Water Vapour and Astronomical Millimetre Interferometry by Martina Corinna Wiedner<\/a>)<\/p><\/div>\n<p>&nbsp;<\/p>\n<div id=\"attachment_11732\" style=\"width: 610px\" class=\"wp-caption aligncenter\"><a href=\"http:\/\/www.eaobservatory.org\/jcmt\/wp-content\/uploads\/sites\/2\/2021\/02\/wvm-silver-in-detail.jpg\"><img aria-describedby=\"caption-attachment-11732\" loading=\"lazy\" class=\"wp-image-11732\" src=\"http:\/\/www.eaobservatory.org\/jcmt\/wp-content\/uploads\/sites\/2\/2021\/02\/wvm-silver-in-detail-300x196.jpg\" alt=\"\" width=\"600\" height=\"391\" srcset=\"https:\/\/www.eaobservatory.org\/jcmt\/wp-content\/uploads\/sites\/2\/2021\/02\/wvm-silver-in-detail-300x196.jpg 300w, https:\/\/www.eaobservatory.org\/jcmt\/wp-content\/uploads\/sites\/2\/2021\/02\/wvm-silver-in-detail-1024x668.jpg 1024w, https:\/\/www.eaobservatory.org\/jcmt\/wp-content\/uploads\/sites\/2\/2021\/02\/wvm-silver-in-detail-768x501.jpg 768w, https:\/\/www.eaobservatory.org\/jcmt\/wp-content\/uploads\/sites\/2\/2021\/02\/wvm-silver-in-detail-150x98.jpg 150w, https:\/\/www.eaobservatory.org\/jcmt\/wp-content\/uploads\/sites\/2\/2021\/02\/wvm-silver-in-detail-308x201.jpg 308w, https:\/\/www.eaobservatory.org\/jcmt\/wp-content\/uploads\/sites\/2\/2021\/02\/wvm-silver-in-detail.jpg 1132w\" sizes=\"(max-width: 600px) 100vw, 600px\" \/><\/a><p id=\"caption-attachment-11732\" class=\"wp-caption-text\">The WVM box with the two electronics plates. The upper plate is the RF plate. The horn and mixer are in the centre of the RF plate the horn is pointing away from the photographer to the flip mirror. The lower plate contains the IF electronics. The warm and cold loads are circled. (image taken from <a href=\"http:\/\/docs.eao.hawaii.edu\/newJCMT\/instruments\/WVM\/01\/m_wiedner_thesis.pdf\">Atmospheric Water Vapour and Astronomical Millimetre Interferometry by Martina Corinna Wiedner<\/a>).<\/p><\/div>\n<h2>Obtaining JCMT WVM data<\/h2>\n<h3>Local archive interface<\/h3>\n<p>For archival values of the WVM you can visit: <a href=\"https:\/\/www.eao.hawaii.edu\/eao-bin\/wvm.pl\">WVM Archive Interface<\/a>.<\/p>\n<h3 id=\"cadc\">Archived data files at CADC<\/h3>\n<p>To obtain WVM data files visit the <a href=\"https:\/\/www.cadc-ccda.hia-iha.nrc-cnrc.gc.ca\/en\/search\/?collection=JCMT&amp;noexec=true\">CADC Advanced Search<\/a> page and search the &ldquo;JCMT&rdquo; collection using the selected instrument &ldquo;WVM&rdquo;.<\/p>\n<p>Alternatively you can attempt to construct the file name for WVM data for a given night and download it directly from the CADC data web service.  WVM file names contain the date in <tt>YYYYMMDD<\/tt> format, so for example, data from the 1st of April, 2021 should be in a file named <tt>20210401.wvm<\/tt>, and could be retrieved as follows:<\/p>\n<pre>wget https:\/\/ws.cadc-ccda.hia-iha.nrc-cnrc.gc.ca\/data\/pub\/JCMT\/20210401.wvm<\/pre>\n<p>&nbsp;<\/p>\n<h2>Correcting WVM issues in SCUBA-2 data<\/h2>\n<h3>Missing WVM data<\/h3>\n<p style=\"text-align: justify\">If WVM data are missing from raw files, but the full data from the WVM are available on disk at CADC, the Wesley recipe can be used to copy the WVM data into the raw files.  The pre-processed files can then be reduced as normal.  First download the WVM files for the relevant dates as described <a href=\"#cadc\">above<\/a>, then run up <a href=\"http:\/\/starlink.eao.hawaii.edu\/starlink\/Releases\">Starlink&#8217;s<\/a> ORAC-DR<\/p>\n<pre>oracdr_scuba2_850 \r\n<\/pre>\n<p>then run:<\/p>\n<pre>wesley --files files.list INSERT_JCMT_WVM_DATA -verbose -log sf -nodisplay\r\n -recpars=\"JCMT_WVM_FILE=20200217.wvm\"\r\n<\/pre>\n<p>ensuring 20200217.wvm is in cwd\/ORAC_DATA_OUT and where files.list are the raw files you wish to reduce.<\/p>\n<p>For more information about this Wesley recipe, please see its entry in <a href=\"https:\/\/starlink.eao.hawaii.edu\/docs\/sun271.htx\/sun271.html\">SUN\/271<\/a>.<\/p>\n<p>These are the information written into the WVM .wvm files:<\/p>\n<p>1) isoTime Time and date string<br \/>\n2) airMass Air Mass<br \/>\n3) tAmb Ambient temperature (kelvin)<br \/>\n4) tSky[0] Sky temperature 0 (kelvin)<br \/>\n5) tSky[1] Sky temperature 1 (kelvin)<br \/>\n6) tSky[2] Sky temperature 2 (kelvin)<br \/>\n7) tWat The effective temperature<br \/>\n8) tOff The line of site opacity<br \/>\n9) mmH2O_a The line-of sight water density in mm<br \/>\n10) mmH2O_z The water density at zenith in mm<br \/>\n11) finalTau The Tau at zenith<br \/>\n12) tSys[0] The system temperature of receiver 0<br \/>\n13 tSys[1] The system temperature of receiver 1<br \/>\n14) tSys[2] The system temperature of receiver 2<br \/>\n15) azimuthDeg Antenna azimuth in degrees<\/p>\n<p>Older data may omit the last 4 columns and give the time as decimal hours rather than a formatted string.<\/p>\n<p>&nbsp;<\/p>\n<h3>Data taken on 2021-01-28<\/h3>\n<p>On UT 20210128 an adjustment was made to the WVM method that was in place for a day and impacts SCUBA-2 data taken on that date. Users that had data taken will need to follow the method outlines above, running the welsley command on raw SCUBA-2 data prior to reducing data. the .wvm file that should be used on that date is found at the following link: <a href=\"https:\/\/www.eao.hawaii.edu\/files\/etisMonitoring\/wvm\/tau\/data\/20210128_OLD.wvm\">20210128_OLD.wvm<\/a><\/p>\n<p>Note that when using a recent release of Starlink (2021A or later), a correction may automatically be applied for this date.  (And so it might not be a good idea to use the file mentioned above lest the correction be applied twice.)<\/p>\n","protected":false},"excerpt":{"rendered":"<p>The JCMT relies on its in-cabin line-of-sight 183 GHz radiometer, the WVM (Water Vapour Monitor) to measure the PWV (Precipitable Water Vapour) and report the sky opacity at (the historically used) 225 GHz. The WVM is critical for both SCUBA-2 observations (see the note about extinction correction) and also for\u2026 <a class=\"continue-reading-link\" href=\"https:\/\/www.eaobservatory.org\/jcmt\/instrumentation\/wvm\/\">Continue reading<\/a><\/p>\n","protected":false},"author":5,"featured_media":0,"parent":134,"menu_order":0,"comment_status":"closed","ping_status":"closed","template":"","meta":[],"_links":{"self":[{"href":"https:\/\/www.eaobservatory.org\/jcmt\/wp-json\/wp\/v2\/pages\/11722"}],"collection":[{"href":"https:\/\/www.eaobservatory.org\/jcmt\/wp-json\/wp\/v2\/pages"}],"about":[{"href":"https:\/\/www.eaobservatory.org\/jcmt\/wp-json\/wp\/v2\/types\/page"}],"author":[{"embeddable":true,"href":"https:\/\/www.eaobservatory.org\/jcmt\/wp-json\/wp\/v2\/users\/5"}],"replies":[{"embeddable":true,"href":"https:\/\/www.eaobservatory.org\/jcmt\/wp-json\/wp\/v2\/comments?post=11722"}],"version-history":[{"count":21,"href":"https:\/\/www.eaobservatory.org\/jcmt\/wp-json\/wp\/v2\/pages\/11722\/revisions"}],"predecessor-version":[{"id":13530,"href":"https:\/\/www.eaobservatory.org\/jcmt\/wp-json\/wp\/v2\/pages\/11722\/revisions\/13530"}],"up":[{"embeddable":true,"href":"https:\/\/www.eaobservatory.org\/jcmt\/wp-json\/wp\/v2\/pages\/134"}],"wp:attachment":[{"href":"https:\/\/www.eaobservatory.org\/jcmt\/wp-json\/wp\/v2\/media?parent=11722"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}