diff --git a/Tutorials/AAAR-2026-ACT-Tutorial/ACT-Basics-DUSTIEAIM.ipynb b/Tutorials/AAAR-2026-ACT-Tutorial/ACT-Basics-DUSTIEAIM.ipynb index 406d556e..e59aa774 100644 --- a/Tutorials/AAAR-2026-ACT-Tutorial/ACT-Basics-DUSTIEAIM.ipynb +++ b/Tutorials/AAAR-2026-ACT-Tutorial/ACT-Basics-DUSTIEAIM.ipynb @@ -17,6 +17,14 @@ "---" ] }, + { + "cell_type": "markdown", + "id": "aee337ae", + "metadata": {}, + "source": [ + "\"Open" + ] + }, { "cell_type": "markdown", "id": "926d344e", @@ -101,6 +109,15 @@ " - matplotlib" ] }, + { + "cell_type": "markdown", + "id": "f28dadd0", + "metadata": {}, + "source": [ + "## AI Disclosure\n", + "Claude Code (v2.3.310) and Opus 5 assisted with generating this notebook" + ] + }, { "cell_type": "markdown", "id": "f89921ee-514a-4e11-859a-4858ed7354ab", @@ -197,7 +214,13 @@ "## Instrument Overview\n", "\n", "### Aerodynamic Particle Sizer (APS)\n", - "The [aerodynamic particle sizer (APS)](https://arm.gov/capabilities/instruments/aps) is a particle size spectrometer that measures both the particle aerodynamic diameter based on particle time of flight and optical diameter based on scattered light intensity. The APS provides the number size distribution for particles with aerodynamic diameters from 0.5 to 20 micrometers and with optical diameters from 0.3 to 20 micrometers.\n" + "The [aerodynamic particle sizer (APS)](https://arm.gov/capabilities/instruments/aps) is a particle size spectrometer that measures both the particle aerodynamic diameter based on particle time of flight and optical diameter based on scattered light intensity. The APS provides the number size distribution for particles with aerodynamic diameters from 0.5 to 20 micrometers and with optical diameters from 0.3 to 20 micrometers.\n", + "\n", + "### Surface Meteorological Instrumentation (MET)\n", + "The [surface meteorological instrumentation (MET)](https://arm.gov/capabilities/instruments/met) is a suite of sensors mounted on a 10 m tower that records the basic near-surface state of the atmosphere: temperature, relative humidity, barometric pressure, wind speed and direction from a propeller-vane anemometer, and precipitation from a tipping-bucket rain gauge. These are the variables that put every other measurement in context, and for a dust case they are what tell you whether a particle spike arrived with a gust front.\n", + "\n", + "### Doppler Lidar (DL)\n", + "The [Doppler lidar (DL)](https://arm.gov/capabilities/instruments/dl) is a scanning coherent lidar that measures the radial velocity of aerosol particles carried along by the wind. When the beam is pointed straight up (the fixed-point, or vertical-stare, scan mode), the radial velocity is the vertical air motion, making the DL a good tool for seeing boundary-layer turbulence, convective plumes, and the strong downdrafts and outflow that accompany a haboob.\n" ] }, { @@ -209,11 +232,47 @@ "Let's get started with some data! But first, we need to import some libraries." ] }, + { + "cell_type": "markdown", + "id": "b3e7da99", + "metadata": {}, + "source": [ + "
\n", + "

If Running these Notebooks on Google CoLab

\n", + " You will need to include the Atmospheric data Community Toolkit (ACT) within the python environment.\n", + " Uncomment the next line prior to importing the python libraries.\n", + "
" + ] + }, + { + "cell_type": "code", + "execution_count": 26, + "id": "09deec04", + "metadata": { + "execution": { + "iopub.execute_input": "2026-10-26T19:25:57.683117Z", + "iopub.status.busy": "2026-10-26T19:25:57.682914Z", + "iopub.status.idle": "2026-10-26T19:25:57.687898Z", + "shell.execute_reply": "2026-10-26T19:25:57.687179Z" + } + }, + "outputs": [], + "source": [ + "# Uncomment if running on CoLab\n", + "##!pip install act-atmos>=2.2.23" + ] + }, { "cell_type": "code", - "execution_count": 56, + "execution_count": 27, "id": "a5b00201-8c78-4ef5-b02f-57e55021f5d6", "metadata": { + "execution": { + "iopub.execute_input": "2026-10-26T19:25:57.689977Z", + "iopub.status.busy": "2026-10-26T19:25:57.689813Z", + "iopub.status.idle": "2026-10-26T19:25:59.524828Z", + "shell.execute_reply": "2026-10-26T19:25:59.524317Z" + }, "tags": [] }, "outputs": [], @@ -241,9 +300,15 @@ }, { "cell_type": "code", - "execution_count": 57, + "execution_count": 28, "id": "6dc01deb-8e97-4e45-9efb-196b37ca7386", "metadata": { + "execution": { + "iopub.execute_input": "2026-10-26T19:25:59.526952Z", + "iopub.status.busy": "2026-10-26T19:25:59.526716Z", + "iopub.status.idle": "2026-10-26T19:32:12.471214Z", + "shell.execute_reply": "2026-10-26T19:32:12.469760Z" + }, "tags": [] }, "outputs": [ @@ -268,6 +333,18 @@ "(MET), 2026-08-04 to 2026-08-04, ARM Mobile Facility (DST), Phoenix, AZ: AMF1\n", "(Main Site for DUSTIEAIM) (M1). Atmospheric Radiation Measurement (ARM) User\n", "Facility. https://doi.org/10.5439/1786358\n", + "\n", + "[DOWNLOADING] dstdlfptM1.b1.20260804.050018.cdf\n", + "[DOWNLOADING] dstdlfptM1.b1.20260804.060018.cdf\n", + "[DOWNLOADING] dstdlfptM1.b1.20260804.070018.cdf\n", + "[DOWNLOADING] dstdlfptM1.b1.20260804.080017.cdf\n", + "\n", + "If you use these data to prepare a publication, please cite:\n", + "\n", + "Newsom, R., Shi, Y., & Krishnamurthy, R. Doppler Lidar (DLFPT), 2026-08-04 to\n", + "2026-08-04, ARM Mobile Facility (DST), Phoenix, AZ: AMF1 (Main Site for\n", + "DUSTIEAIM) (M1). Atmospheric Radiation Measurement (ARM) User Facility.\n", + "https://doi.org/10.5439/1025185\n", "\n" ] } @@ -288,14 +365,23 @@ "# Set the datastream and start/enddates\n", "aps_datastream = 'dstaosapsM1.b1'\n", "met_datastream = \"dstmetM1.b1\"\n", + "dl_datastream = \"dstdlfptM1.b1\"\n", "\n", "startdate = '2026-08-04'\n", "enddate = '2026-08-04'\n", "\n", + "# The Doppler lidar files are hourly and large, so rather than pulling the whole\n", + "# day we narrow to the window around the dust event. ACT's downloader accepts a\n", + "# time on the start/end dates, which the ARM Live webservice uses to filter files\n", + "dl_startdate = '2026-08-04T05:00:00'\n", + "dl_enddate = '2026-08-04T09:00:00'\n", + "\n", "# Use ACT to easily download the data. Watch for the data citation! Show some support\n", "# for ARM's instrument experts and cite their data if you use it in a publication\n", "result_aps = act.discovery.download_arm_data(arm_username, arm_token, aps_datastream, startdate, enddate)\n", - "result_met = act.discovery.download_arm_data(arm_username, arm_token, met_datastream, startdate, enddate)" + "result_met = act.discovery.download_arm_data(arm_username, arm_token, met_datastream, startdate, enddate)\n", + "\n", + "result_dl = act.discovery.download_arm_data(arm_username, arm_token, dl_datastream, dl_startdate, dl_enddate)" ] }, { @@ -311,9 +397,15 @@ }, { "cell_type": "code", - "execution_count": 58, + "execution_count": 29, "id": "acdaa696-ebb5-4bbe-8d1e-a4c66f524964", "metadata": { + "execution": { + "iopub.execute_input": "2026-10-26T19:32:12.474173Z", + "iopub.status.busy": "2026-10-26T19:32:12.473970Z", + "iopub.status.idle": "2026-10-26T19:32:13.976918Z", + "shell.execute_reply": "2026-10-26T19:32:13.976499Z" + }, "tags": [] }, "outputs": [ @@ -896,19 +988,19 @@ " _file_dates: ['20260804']\n", " _file_times: ['000000']\n", " _datastream: dstaosapsM1.b1\n", - " _arm_standards_flag: 1