HMI_Logo HMI Ring Diagrams
Pipeline Module Specifications

pspec3

Module Version
	0.7	14 VII 2009

General Description
	pspec3 is designed to calculate the full 3-dimensional power spectrum of
	a time series of 2-dimensional images. The input data are optionally
	apodized by a (1-x^2)^2 taper operating between specified inner and
	outer radii of the images and a similar taper operating on the time axis
	(image number). The input data series must consist of 3-dimensional
	data cubes (such as those produced by mtrack), each treated as a
	separate data record. 

Status
	This version has been superseded by Version 0.8

	Included in JSOC release 5.6
	Never used for ring-diagram pipelines
	The source code and Makefile are in the JSOC CVS repository

Usage
	pspec3_v07 [-lvx] in= InputDescriptor pspec= OutputDescriptor
	    [param= val ...]
	
Flags
	-l	output direct power spectrum rather than scaled log
	-v	run verbose
	-x	use double-precision calculation internally

Parameters
	in		The name of an input dataset (record selection); Default:
			mdi.rdVtrack_dp[?CarrRot=1988 and LonHG=180.0 and LatHG=0.0?]

	pspec		The name of the output data series, which must already
			exist; record specification is based on the input data record(s)
			and the series prime keywords. Default: mdi.rdVpspec_dp

	mask_in		Inner radial edge of spatial taper; Default: 0.9375

	mask_ex		Outer radial edge of spatial taper; Default: 1.0

	apodize		Inner edge of temporal taper; Default: 0.96875

	fbin		Output frequency binning; 0 -> no binning; Default: 0

Input Data series class:
	tracked mapped data cubes from solar image data

Input keys used or inspected:
	MapScale, T_STOP, T_START, CDELT3

Sample input series:
	mdi.rdVtrack_dp

Output Data series class:
	power spectra of data cubes

Output keys set (if possible):
	CRPIX1, CRPIX2, CRPIX3, CRVAL1, CRVAL2, CRVAL3, CTYPE1, CTYPE2, CTYPE2,
	CDELT1, CDELT2, Delta_k, Delta_kx, Delta_ky, CDELT3, Delta_nu, D_OMEGA,
	apode_k_min, apode_k_max, apode_f, ReqTime, Requestor, RequestID, Notify,
	Log_Base, DataMin, DataMax

Input keys propagated to output (if possible):
	CarrTime, CarrRot, CarrLon, LonHG, LatHG, CMLon, MidTime, Duration, LonSpan,
	T_START, T_STOP, Coverage, ZonalTrk, MeridTrk, MapScale, MapProj, PosAng, MAI

Sample output series:
	mdi.rdVpspec_dp

Bugs in current version
	Rejects an input dataset containing more than one record.

	Unable to build a working linux_ia32 binary - fails in the first call to
	drms_segment_read()


Valid HTML 4.01 Transitional HMI Ring Diagrams 7 Mar 2018, 10:41-0800