HMI_Logo HMI Ring Diagrams
Pipeline Module Specifications

rdvinv

Module Version
	0.8	5 XII 2011

General Description
	rdvinv performs an OLA inversion on a set of ring-fit parameters Ux and Uy
	for transverse velocity functions of depth.

	If output is to a named DRMS series, the module combines the output files
	corresponding to the input records selected into a single SUMS directory
	or a pair of directories, depending whether the output data series has
	one or two segments defined. If the output series has a single segment,
	all output files will be placed in its SUMS directory; otherwise, separate
	subdirectories for the uxseg and uyseg parameters will be created.
	In either case, the ouput inversion files will be named with extensions
	.Ux and .Uy. The filenames are constructed from the Carrington time,
	latitude and (Stonyhurst) longitude information for the records, e.g.
	2099:060.0_15.0E45.0S.Ux

	If values are provided for any combination of parameters cr, clon, lon, and
	lat, the module will select all records from the input record set or series
	matching the selected values.

Status
	Included in JSOC release 6.1

	The source code and Makefile are in the JSOC CVS repository

	rdvinv_v08 is a compiled standalone DRMS binary built with NetDRMS 6.1
	to run in the JSOC configuration. Versions are in:
		~rick/bin/linux_x86_64/rdvinv_v08
		~rick/bin/rick/rdvinv_v08
	The source code and Makefile is in ~rick/src/rdvinv

Usage
	rdvinv [-v] [param= val ...]
	
Flags
	-v	run verbose

Parameters
	in		Name of an input data series or dataset (record selection);
			No Default
	seg		Name of the input segment; Default: fit.out
	out		Output filename or data series name; Default: fort.10.hmixy
	uxseg		Output data segment name for Ux inversions; Default: Ux
	uyseg		Output data segment name for Uy inversions; Default: Uy
	cr		Carrington rotation number common to all regions;
			Default: Not Specified
	clon		Central meridian longitude common to all regions;
			Default: Not Specified
	lon		Carrington longitude common to all regions;
			Default: Not Specified
	lat		Heliographic latitude common to all regions;
			Default: Not Specified
	amu		Error trade-off parameter; Default: 0.005
	ob		Lower frequency limit (mHz); Default: 1.0
	oe		Upper frequency limit (mHz); Default: 5.2
	rb		Lower radius limit; Default: 0.97
	re		Upper radius limit; Default: 1.00
	num		Number of target inversion points; Default: 40
	kernel		Kernel filename; No Default
	ave		Output filename for averaging kernels; if unspecified,
			kernels are not written. Default: Not Specified
	coef		Output filename for inversion coefficients;  if unspecified,
			coefficients are not written. Default: Not Specified

Input Data series class:
	ring diagram mode fits

Sample input series:
	hmi_test.rdVfitsc_fd30
	mdi.rdVfitsc_dp

Output Data series class:
	ring diagram mode fits

Sample output series:
	hmi_test.rdVflows_fd30_frame

Changes from Previous Version
	Fixed bug in output file naming originally introduced in Version 0.6

Bugs in current version:
	When writing output to a file, rather than a drms record set, only one
	set of files can be specified — if the input data set contains more
	than one record, each inversion will overwrite the last.

	The current version includes code from ola_xy.c that generates compiler
	warnings, but this code is not actually used.

Valid HTML 4.01 Transitional HMI Ring Diagrams 1 Feb 2012, 10:41-0800