sdbsort
NAME
sdbsort - sort a sdb flow with pointed key entries.
SYNOPSIS
sdbsort
[ -lb | -bl | -radec | -decra ]
[ -file_length ]
[ -header_length ]
[ -format_id ]
[ -version ]
[ -data_type ]
[ -history_step ]
[ -history_line ]
[ -original_scan_number ]
[ -backup_version ]
[ -composed_scans ]
[ -project ]
[ -scd_name ]
[ -scd_line_number ]
[ -sw_mode ]
[ -observed_mjd ]
[ -observed_start_time ]
[ -observed_stop_time ]
[ -integration_on_time ]
[ -integration_off_time ]
[ -observer ]
[ -observer1 ]
[ -observer2 ]
[ -observer3 ]
[ -observer4 ]
[ -object ]
[ -coordinates | -coord_sys ]
[ -l | -on_l ]
[ -b | -on_b ]
[ -ra | -on_ra ]
[ -dec | -on_dec ]
[ -az | -on_az ]
[ -el | -on_el ]
[ -off_l ]
[ -off_b ]
[ -off_ra ]
[ -off_dec ]
[ -orig_x ]
[ -orig_y ]
[ -position_angle | -grid_pa ]
[ -x | -on_x ]
[ -y | -on_y ]
[ -telescope | -telescope_name ]
[ -ap_eff ]
[ -mb_eff ]
[ -fss_eff ]
[ -beamsize | -hpbw ]
[ -receiver | -rx_name ]
[ -sideband | -sb_mode ]
[ -v_lsr ]
[ -v_off ]
[ -rest_freq ]
[ -obs_freq ]
[ -local_freq ]
[ -if_freq ]
[ -local_multiplier_order ]
[ -T_sys | -system_temperature ]
[ -T_rx | -receiver_temperature ]
[ -data_rms ]
[ -calibrator_temperature ]
[ -data_weight ]
[ -data_scale_factor ]
[ -backend ]
[ -backend_channel_number | -backend_totel_channel ]
[ -backend_basis_ch ]
[ -backend_ch_sign ]
[ -present_data_channel_number | -data_ch ]
[ -be_center_ch ]
[ -be_center_freq ]
[ -be_disp0 ]
[ -be_disp1 ]
[ -be_disp2 ]
[ -be_disp3 ]
[ -be_disp4 ]
[ -be_freq_resolution ]
[ -be_ch_width ]
[ -be_ch_origin ]
[ -site_name ]
[ -atm_temp | -atmospheric_temperature ]
[ -atm_water | -atmospheric_water_pressure ]
[ -atm_press | -atmospheric_pressure ]
[ -optical_depth_at_zenith | -tau0_at_observation ]
[ -observation_memo ]
[ -observation_comment ]
DESCRIPTION
This command sorts sdb entries with the values in the header
assigned by option keywords.
If the data value is in text,
the command sorts in order of the ASCII code.
FILTER TYPE
.sdb | sdsort | .sdb
OPTIONS
- -lb | -bl | -radec | -decra
- coordinate position of the on point in sky.
The keyword -lb is galactic longitude and latitude.
The keyword -bl is galactic latitude and longitude.
The keyword -radec is right ascension and declination.
The keyword -decra is declination and right ascension.
- -file_length
- Total file length of the .scn file in bytes.
If the .scn file is the latest version,
this value should be the same as the result of "ls -l".
- -header_length
- Total header length in bytes.
- -format_id spectrum
- The basic structure of file. The file of ".sdb" is "spectrum".
- -version
- The version number of the file.
- -data_type
- The type of the data in physical meaning.
- Ta - in antenna temperature (K)
- frequency_switch - unfolded frequency switch output in antenna temperature
(K)
- Tmb - in mainbeam brightness temperature (K)
- Integ_Ta - in integrated antenna temperature (K km/s)
- Integ_Tmb - in integrated mainbeam brightness temperature (K km/s)
- RawLong - in raw output (total power)
- RawFloat - in raw output (total power) but convert to float formally.
- -history_step
- The number of the history steps ("end" step is not counted).
- -history_line
- The number of lines in the history.
- -original_scan_number
- An original sequencial number of the scans (.scn).
This number should be given by ASTROS, an observation program.
- -backup_version
- The version number for backup, which is valid at using the command "save".
The created backup file will have a name with this number.
- -composed_scans
- The number of the original scans (.scn). This number should increase
after "integ" process.
- -project
- Name of the project. Less than or 16 characters.
- -scd_name
- Name of the original .scd file which was used by ASTROS.
Less than or 8 characters.
- -scd_line_number
- The line number in the .scd file which was used by ASTROS.
- -sw_mode
- Switching mode to obtain the data.
- total_power - total power mode. Direct output of a recevier.
- onoff - after on-off switching.
- freqency_sw - after frequency switching
- Dicke - after Dicke switching
- -observed_mjd
- The observed date in the modified Julian day.
- -observed_start_time
- The observation start time for the profile.
The time is given by sec from 1970/1/1
0:0:0 UTC. (The UNIX/Linux standard).
- -observed_stop_time
- The observation stop time for the profile.
The time is given by sec from 1970/1/1
0:0:0 UTC. (The UNIX/Linux standard).
- -integration_on_time
- Total integration time as the on-position in seconds.
- -integration_off_time
- Total integration time as the off-position in seconds.
- -observer
- The name of primary observer. Less than or 8 charcters.
- -observer1
- The name of primary observer. Less than or 8 charcters.
- -observer2
- The name of secondary observer. Less than or 8 charcters.
- -observer3
- The name of another observer. Less than or 8 charcters.
- -observer4
- The name of another observer or data processor. Less than or 8 charcters.
- -object
- The name of object. Less than or 15 charcters.
- -coordinates | -coord_sys lb
- The basic coordinate to use. The local xy coordinate is also defined
by referring the coordinate assigned this selection.
- lb - the Galactic coordinate. Some refers as l(II) and b(II).
- radec - the equitorial coordinate at the epoch B1950.0.
The mean poisiton.
- radec-app - the equitorila coordinate
at the present epoch of the observations. The appearent position.
- -l | -on_l
- The galactic longitude position of the on point.
If angle_value is given only the number,
the command takes it as in degrees.
- -b | -on_b
- The galactic latitude position of the on point.
If angle_value is given only the number,
the command takes it as in degrees.
- -ra | -on_ra
- The equitorial longitude (B1950.0) mean positon of the on point.
If angle_value is given only the number,
the command takes it as in degrees.
- -dec | -on_dec
- The equitorial latitude (B1950.0) mean positon of the on point.
If angle_value is given only the number,
the command takes it as in degrees.
- -az | -on_az
- The azimath positon of the on point.
If angle_value is given only the number,
the command takes it as in degrees.
- -el | -on_el
- The elevation positon of the on point.
If angle_value is given only the number,
the command takes it as in degrees.
- -off_l
- The galacitc longitude positon of the off point.
If angle_value is given only the number,
the command takes it as in degrees.
- -off_b
- The galacitc latitude positon of the off point.
If angle_value is given only the number,
the command takes it as in degrees.
- -off_ra
- The equitorial longitude (B1950.0) mean positon of the off point.
If angle_value is given only the number,
the command takes it as in degrees.
- -off_dec
- The equitorial longitude (B1950.0) mean positon of the off point.
If angle_value is given only the number,
the command takes it as in degrees.
- -orig_x
- The longitude positon of the origin of the local XY coordinate.
If angle_value is given only the number,
the command takes it as in degrees.
The referring coordinate is assigned by the keyword "-coordinates".
- -orig_y
- The latitude positon of the origin of the local XY coordinate.
If angle_value is given only the number,
the command takes it as in degrees.
The referring coordinate is assigned by the keyword "-coordinates".
- -position_angle | -grid_pa
- The positon angle of the local XY coordinate at the origin.
The value is in degree. The value 0 means the X and Y axes are parallel to the
longitude and latitude line of the referring coordinate, respectively.
The value 90 means the Y axis is parallel to the longitude line.
The referring coordinate is assigned by the keyword "-coordinates".
- -x | -on_x
- The longitud positon of the on poing in the local XY coordinate.
If angle_value is given only the number,
the command takes it as in degrees.
The referring coordinate is assigned by the keyword "-coordinates".
- -y | -on_y
- The latitude positon of the on point in the local XY coordinate.
If angle_value is given only the number,
the command takes it as in degrees.
The referring coordinate is assigned by the keyword "-coordinates".
- -telescope | -telescope_name
- The name of telescope used to get the profile. Less than or 8 characters.
- -ap_eff
- The appature efficiency of the telescope.
In absorute value between 0.0 and 1.0, not in percent.
- -mb_eff
- The main beam efficiency of the telescope.
In absorute value between 0.0 and 1.0, not in percent.
- -fss_eff
- The forward scattering and spilover efficiency of the telescope.
In absorute value between 0.0 and 1.0, not in percent.
- -beamsize | -hpbw
- The full width at the maximum of the antenna power beam in arcmin.
- -receiver | -rx_name
- The name of receiver used. Less than or 7 characters
- -sideband | -sb_mode lsb_ssb
- The observation sideband mode and signal sideband.
- lsb_ssb - Signal in LSB and observation made in SSB.
- lsb_dsb - Signal in LSB and observation made in DSB.
- usb_ssb - Signal in USB and observation made in SSB.
- usb_dsb - Signal in USB and observation made in DSB.
- -v_lsr
- The "center velocity" of the profile in km/s respect to the Local
Standard of the Rest. The "center velocity" means the standard referring
velocity for the profile. In most cases this should be the same as
that of the main targetting object.
In some cases the actual center of the profile may be different.
- -v_off
- The "center velocity" of the profile in km/s respect to the Local
Standard of the Rest for the off point.
This is almost meaningless if the data is not taken in frequency switching.
The "center velocity" means the standard referring
velocity for the profile. In most cases this should be the same as
that of the main targetting object.
In some cases the actual center of the profile may be different.
- -rest_freq
- The rest frequency of the emission/absorption line to observe in GHz.
- -obs_freq
- The observation frequency of the receiver in GHz.
- -local_freq
- The frequency of the local oscilator in GHz.
- -if_freq
- The frequency of the first IF line in GHz.
- -local_multiplier_order
- The order of the multiplier attached to LO. Doubler is 2 and tripler is 3.
- -T_sys | -system_temperature
- The system noise temperature including the atmospheric extinction
in Kelvin.
- -T_rx | -receiver_temperature
- The receiver noise temperature in Kelvin.
- -data_rms
- The rms noise level of the profile in Kelvin.
- -calibrator_temperature
- The brightness temperature of the thermal calibrator.
- -data_weight
- The weight of the profile. Usually it is caliculated based upon
the value of the rms noise level.
This is used by the command integ and others.
- -data_scale_factor
- The scaling factor of the data to adjust in Kelvin.
The value should be multiply to the floating value of "profile.data[ch-1]"
to get intensity in K.
- -backend | -be_name
- Name of the backend spectrometer. Less than or 8 characters.
- -backend_channel_number | -backend_totel_channel
- The total number of channels in the backend used. Less than or 2048.
- -backend_basis_ch
- After version 3 it is meaningless. It was the same meaning of "-be_center_ch".
- -backend_ch_sign
- Backend channel polarity. Positive means the RF frequency increases
when the backend frequency increases.
Negative means the RF frequency decreases.
- -present_data_channel_number | -data_ch
- The number of data channel. Originally it should be the same as
the number of channel in the backend used but may change by processing
such as smooth.
- -be_center_ch
- The "center channel" of the backend used.
The "center channel" means the standard referring
channel for the profile to estimate
the relation between channel number and frequency on the spectrometer.
In some cases the "central channel" may be half of the
"-backend_channel_number".
- -be_center_freq
- The "center frequency" of the backend in MHz.
The "center frequency" means the standard referring
frequency for the profile to estimate
the relation between channel number and frequency on the spectrometer.
In some cases the "central frequency" may be the actual center of
the full span of the profile.
- -be_disp0
- The 0th order coefficient of the despersion function of the spectrometer.
The unit is MHz.
- -be_disp1
- The 1st order coefficient of the despersion function of the spectrometer.
The unit is MHz per channel. The channel means present data channel for ver.3
and later data.
- -be_disp2
- The 2nd order coefficient of the despersion function of the spectrometer.
The unit is MHz per square-channel
- -be_disp3
- The 3rd order coefficient of the despersion function of the spectrometer.
The unit is MHz per cubic-channel
- -be_disp4
- The 4th order coefficient of the despersion function of the spectrometer.
The unit is MHz per 4th-powers-of-(channel)
- -be_freq_resolution
- The frequency resolution of the backend in MHz.
This is the original but not for the present effective resolution.
- -be_ch_width
- The binning width of the original channel. For the ver.3 and later data
this parameter is meaningless.
- -be_ch_origin
- The binning start position on the original. For the ver.3 and later data
this parameter is meaningless.
- -site_name
- Name of the observation site location. Less than or 8 characters.
- -atm_temp | -atmospheric_temperature
- The atmospheric temperature in Centigrade
when the observations are done.
- -atm_water | -atmospheric_water_pressure
- The partial pressure of water vaper in mbar or hecto-Pascal
when the obervations are done.
- -atm_press | -atmospheric_pressure
- The atmospheric pressure in mbar or hecto-Pascal
when the observations are done.
- -optical_depth_at_zenith | -tau0_at_observation
-
- -observation_memo
- Free memorundom in ASCII code. Less than or 64 characters.
- -observation_comment
- Free comment in ASCII code. Less than or 64 characters
DEFAULTS
- -prm sdbsort.prm
- All flags are off.
SEE ALSO
headcorr,headlist, sdbselect, sdblist, .scn, .sdb
BUGS
- The sort key values are not shown in sdb. Use sdblist.
HISTORY
- ver.3.00
- 2000/2/11 T.Handa
MANUAL VERSION
2001/1/10 T.Handa