SAMURAI - Revision history

Jcdehart: /* Center File */

2024-05-14T16:24:07Z

Center File

Jcdehart: /* Installation */

2024-05-14T16:21:54Z

Installation

Jcdehart: /* Spline Analysis at Mesoscale Utilizing Radar and Aircraft Instrumentation */

2024-05-14T16:17:48Z

Spline Analysis at Mesoscale Utilizing Radar and Aircraft Instrumentation

Jcdehart: /* Input Directory */

2024-05-14T16:07:01Z

Input Directory

Jcdehart: /* Input Directory */

2024-05-14T16:06:21Z

Input Directory

Jcdehart: /* Input Directory */

2024-05-14T16:05:41Z

Input Directory

Jcdehart: /* Running SAMURAI */

2024-05-14T16:03:39Z

Running SAMURAI

Jcdehart: /* References */

2024-05-14T16:01:20Z

References

Jcdehart: /* References */

2024-05-14T16:01:01Z

References

Jcdehart: /* References */

2024-05-14T15:59:32Z

References

@@ Line 109: / Line 109: @@
 |}
-Times are in UTC, and exceed 240000 when crossing over to the following day. ''Note that V and U follow latitude and longitude (not U then V)''. Only data that falls between the first time to last time in the file will be used in the analysis, so this file sets both the time limits and analysis location. A simple linear track can be generated using the supplied <code>samurai_lineartrack.pl</code> script in the util directory.
+Times are in UTC, and exceed 240000 when crossing over to the following day. ''Note that V and U follow latitude and longitude (not U then V)''. Only data that falls between the first time to last time in the file will be used in the analysis, so this file sets both the time limits and analysis location. A simple linear track can be generated using the supplied <code>samurai_lineartrack.pl</code> script in the [https://github.com/mmbell/samurai/tree/main/util util] directory.
 ===== '''Background File''' =====

@@ Line 63: / Line 63: @@
 SAMURAI is available to install through GitHub. In most cases, users should install SAMURAI from the main [https://github.com/NCAR/lrose-core/releases LROSE repository]. Instructions on how to install via [https://github.com/NCAR/lrose-core/blob/master/docs/download/install_using_homebrew.mac_osx.md Homebrew] and [https://github.com/NCAR/lrose-core/blob/master/docs/build/build_samurai.md Cmake] are available on the LROSE repository.
-SAMURAI is also available through its own [https://github.com/mmbell/samurai repository], which has its own compilation [https://github.com/mmbell/samurai?tab=readme-ov-file#compilation instructions].
+Some advanced users may want intermediate updates to SAMURAI in between the lower-frequency LROSE releases. SAMURAI is also available through its own [https://github.com/mmbell/samurai repository], which has its own compilation [https://github.com/mmbell/samurai?tab=readme-ov-file#compilation instructions].
 === '''Running SAMURAI''' ===

@@ Line 3: / Line 3: @@
 === '''Spline Analysis at Mesoscale Utilizing Radar and Aircraft Instrumentation''' ===
-SAMURAI is a variational analysis technique developed based primarily on the work of Ooyama (1987), Ooyama (2002) and Gao et al.(2004). The SAMURAI analysis yields a maximum likelihood estimate of the atmospheric state for a given set of observations and error estimates by minimizing a variational cost function.
+SAMURAI is a variational analysis technique developed based primarily on the work of Ooyama (1987), Ooyama (2002) and Gao et al. (2004). The SAMURAI analysis yields a maximum likelihood estimate of the atmospheric state for a given set of observations and error estimates by minimizing a variational cost function.
 The technique has several advantages over traditional objective analysis techniques, including:

@@ Line 109: / Line 109: @@
 |}
-Times are in UTC, and exceed 240000 when crossing over to the following day. Note that V and U follow latitude and longitude (not U then V). Only data from the first time to last time in the file will be used in the analysis, so this file sets both the time limits and analysis location. A simple linear track can be generated using the supplied <code>samurai_lineartrack.pl</code> script in the util directory.
+Times are in UTC, and exceed 240000 when crossing over to the following day. ''Note that V and U follow latitude and longitude (not U then V)''. Only data that falls between the first time to last time in the file will be used in the analysis, so this file sets both the time limits and analysis location. A simple linear track can be generated using the supplied <code>samurai_lineartrack.pl</code> script in the util directory.
 ===== '''Background File''' =====

@@ Line 97: / Line 97: @@
 ===== '''Center File''' =====
-The only requirement for doing an analysis is a frame-of-reference file, also referred to as the center file, in the input directory. This file contains 1 second positions of a lat/lon reference point for the domain, and the motion of the frame. For tropical cyclone (TC) analyses this is usually the center of circulation, but can be any arbitrary reference point. The filename is ''YYYYMMDD.cen'' where the date refers to the first line of the file. The file structure is multiple lines consisting of the following:
+The only requirement for doing an analysis is a frame-of-reference file, also referred to as the center file, in the input directory. This file contains 1 second positions of a lat/lon reference point for the domain, and the motion of the frame. For tropical cyclone (TC) analyses this is usually the center of circulation, but can be any arbitrary reference point. The filename is ''YYYYMMDD.cen'' where the date refers to the first line of the file. The file structure consists of the following columns:
 {| class="wikitable" style="margin:auto"

← Older revision		Revision as of 16:05, 14 May 2024
Line 100:		Line 100:

	''HHMMSS Latitude Longitude V-speed U-speed''.		''HHMMSS Latitude Longitude V-speed U-speed''.
		+
		+	{\| class="wikitable" style="margin:auto"
		+	\|+ Center File Columns
		+	\|-
		+	! #1 !! #2 !! #3 !! #4 !! #5
		+	\|-
		+	\| Time (UTC) \|\| Latitude \|\| Longitude \|\| V-speed \|\| U-speed
		+	\|-
		+	\| HHMMSS \|\| degrees \|\| degrees \|\| m/s \|\| m/s
		+	\|}

	Times are in UTC, and exceed 240000 when crossing over to the following day. Note that V and U follow latitude and longitude (not U then V). Only data from the first time to last time in the file will be used in the analysis, so this file sets both the time limits and analysis location. A simple linear track can be generated using the supplied <code>samurai_lineartrack.pl</code> script in the util directory.		Times are in UTC, and exceed 240000 when crossing over to the following day. Note that V and U follow latitude and longitude (not U then V). Only data from the first time to last time in the file will be used in the analysis, so this file sets both the time limits and analysis location. A simple linear track can be generated using the supplied <code>samurai_lineartrack.pl</code> script in the util directory.

@@ Line 89: / Line 89: @@
 Several utility scripts are included in the [https://github.com/mmbell/samurai/tree/main/util util] subdirectory, and more will be added as available.
-This documentation covers the configuration and interface for the 1.x release series. There are no plans to change the mandatory elements of the XML configuration structure through the 1.x releases. Optional elements may be added, but no changes would be required for existing analysis configurations.
+Example XML files for Cartesian and cylindrical analyses are included in the [https://github.com/mmbell/samurai/tree/main/bin bin] subdirectory and are described below. These will be converted to TDRP parameter files soon.
 ==== '''Input Directory''' ====

@@ Line 43: / Line 43: @@
 === '''References''' ===
-Bell, M. M., M. T. Montgomery, and K. A. Emanuel, 2012: Air-sea enthalpy and momentum exchange at major hurricane wind speeds observed during CBLAST. ''J. Atmos. Sci.'', , 69, 3197–3222, [https://doi.org/10.1175/JAS-D-11-0276.1 doi:10.1175/JAS-D-11-0276.1].
+Bell, M. M., M. T. Montgomery, and K. A. Emanuel, 2012: Air-sea enthalpy and momentum exchange at major hurricane wind speeds observed during CBLAST. ''J. Atmos. Sci.'', 69, 3197–3222, [https://doi.org/10.1175/JAS-D-11-0276.1 doi:10.1175/JAS-D-11-0276.1].
 Cha, T., and M. M. Bell, 2023: Three-Dimensional Variational Multi-Doppler Wind Retrieval over Complex Terrain. ''J. Atmos. Oceanic Technol.'', 40, 1381–1405, [https://doi.org/10.1175/JTECH-D-23-0019.1 doi:10.1175/JTECH-D-23-0019.1].

@@ Line 43: / Line 43: @@
 === '''References''' ===
-Bell, M. M., M. T. Montgomery, and K. A. Emanuel, 2012: Air-sea enthalpy and momentum exchange at major hurricane wind speeds observed during CBLAST. ''J. Atmos. Sci.'', ''in press''.
+Bell, M. M., M. T. Montgomery, and K. A. Emanuel, 2012: Air-sea enthalpy and momentum exchange at major hurricane wind speeds observed during CBLAST. ''J. Atmos. Sci.'', , 69, 3197–3222, [https://doi.org/10.1175/JAS-D-11-0276.1 doi:10.1175/JAS-D-11-0276.1].
-Cha, T., and M. M. Bell, 2023: Three-Dimensional Variational Multi-Doppler Wind Retrieval over Complex Terrain. J. Atmos. Oceanic Technol., 40, 1381–1405, [https://doi.org/10.1175/JTECH-D-23-0019.1 doi:10.1175/JTECH-D-23-0019.1].
+Cha, T., and M. M. Bell, 2023: Three-Dimensional Variational Multi-Doppler Wind Retrieval over Complex Terrain. ''J. Atmos. Oceanic Technol.'', 40, 1381–1405, [https://doi.org/10.1175/JTECH-D-23-0019.1 doi:10.1175/JTECH-D-23-0019.1].
-Dennis J. M., A. H. Baker, B. Dobbins, M. M. Bell, J. Sun, Y. Kim, T.-Y. Cha, 2022: Enabling efficient execution of a variational data assimilation application. International Journal of High Performance Computing Applications, [https://doi.org/0.1177/10943420221119801 doi:10.1177/10943420221119801].
+Dennis J. M., A. H. Baker, B. Dobbins, M. M. Bell, J. Sun, Y. Kim, T.-Y. Cha, 2022: Enabling efficient execution of a variational data assimilation application. ''International Journal of High Performance Computing Applications'', [https://doi.org/0.1177/10943420221119801 doi:10.1177/10943420221119801].
-Foerster, A., and M. M. Bell, 2017: Thermodynamic Retrieval in Rapidly Rotating Vortices from Multiple-Doppler Radar. J. Atmospheric Ocean. Technol., 34, 2353-2374, [https://doi.org/10.1175/JTECH-D-17-0073.1 doi:10.1175/JTECH-D-17-0073.1].
+Foerster, A., and M. M. Bell, 2017: Thermodynamic Retrieval in Rapidly Rotating Vortices from Multiple-Doppler Radar. ''J. Atmospheric Ocean. Technol.'', 34, 2353-2374, [https://doi.org/10.1175/JTECH-D-17-0073.1 doi:10.1175/JTECH-D-17-0073.1].
 Gao, J., M. Xue, K. Brewster, and K. K. Droegemeier, 2004: A three-dimensional variational data analysis method with recursive filter for Doppler radars. ''J. Atmos. Oceanic Technol.'', '''21''', 457–469.

← Older revision		Revision as of 15:59, 14 May 2024
Line 44:		Line 44:

	Bell, M. M., M. T. Montgomery, and K. A. Emanuel, 2012: Air-sea enthalpy and momentum exchange at major hurricane wind speeds observed during CBLAST. ''J. Atmos. Sci.'', ''in press''.		Bell, M. M., M. T. Montgomery, and K. A. Emanuel, 2012: Air-sea enthalpy and momentum exchange at major hurricane wind speeds observed during CBLAST. ''J. Atmos. Sci.'', ''in press''.
		+
		+	Cha, T., and M. M. Bell, 2023: Three-Dimensional Variational Multi-Doppler Wind Retrieval over Complex Terrain. J. Atmos. Oceanic Technol., 40, 1381–1405, [https://doi.org/10.1175/JTECH-D-23-0019.1 doi:10.1175/JTECH-D-23-0019.1].
		+
		+	Dennis J. M., A. H. Baker, B. Dobbins, M. M. Bell, J. Sun, Y. Kim, T.-Y. Cha, 2022: Enabling efficient execution of a variational data assimilation application. International Journal of High Performance Computing Applications, [https://doi.org/0.1177/10943420221119801 doi:10.1177/10943420221119801].
		+
		+	Foerster, A., and M. M. Bell, 2017: Thermodynamic Retrieval in Rapidly Rotating Vortices from Multiple-Doppler Radar. J. Atmospheric Ocean. Technol., 34, 2353-2374, [https://doi.org/10.1175/JTECH-D-17-0073.1 doi:10.1175/JTECH-D-17-0073.1].

	Gao, J., M. Xue, K. Brewster, and K. K. Droegemeier, 2004: A three-dimensional variational data analysis method with recursive filter for Doppler radars. ''J. Atmos. Oceanic Technol.'', '''21''', 457–469.		Gao, J., M. Xue, K. Brewster, and K. K. Droegemeier, 2004: A three-dimensional variational data analysis method with recursive filter for Doppler radars. ''J. Atmos. Oceanic Technol.'', '''21''', 457–469.