Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Mapping between keys in README and keys in the interface doc #1

Open
ygrange opened this issue Mar 15, 2018 · 8 comments
Open

Mapping between keys in README and keys in the interface doc #1

ygrange opened this issue Mar 15, 2018 · 8 comments
Assignees

Comments

@ygrange
Copy link

ygrange commented Mar 15, 2018

I took the table from the README from this repo and tried mapping the keys for the start_observation command from table 1 in the Interface Specification from MAC to SC3+4. Looks like there is some difference between the two. Since Markdown pasting in Slack doesn't work, I just put it in an issue over here. I don't really mind where we discuss it further, as long as we are consistent in doing so :).

Interface fields in bold are implemented by APERTIF but do not appear in the interface document.

DADA header key Interface Field Type Qpid cfg
NCHAN arts.survey.nrChannels int
MIN_FREQUENCY arts.survey.frequencyChannel0 float
CHANNEL_BANDWIDTH arts.survey.channelBandwidth float
BW
TSAMP
RA task.beamSet.0.compoundBeam.X.phaseCenter [0] float
DEC task.beamSet.0.compoundBeam.X.phaseCenter [1] float
SOURCE task.source.name str X
AZ_START
ZA_START
MJD_START
NBIT
FILE_SIZE
SAMPLES_PER_BATCH
UTC_START task.startTime
RESOLUTION
BYTES_PER_SECOND
task.taskID str X
(N/A) arts.survey.mode str X
arts.survey.zappedChannels int []
arts.survey.nrChunks int
arts.survey.nrSamplesPerChunk int
arts.survey.DMs float []
arts.survey.integrationSteps int []
arts.survey.threshold float
@isazi
Copy link

isazi commented Mar 15, 2018

I did add @jiskattema to this issue, as I don't think he reads slack.

@ygrange
Copy link
Author

ygrange commented Mar 16, 2018

Also good that you're involved in the convo as aythor of the interface doc :).

RA and DEC are input parameters for the script. Those are defined per beam and dish in the parset. What should I assume we can take?

@loostrum
Copy link
Member

loostrum commented Mar 16, 2018 via email

@ygrange
Copy link
Author

ygrange commented Mar 16, 2018

So I guess the question is what we want to do. We could configure the CB covered by a node in an external config file. The advantage is that you can simply change the beam to be covered by a node at the cfg file level. This also means that each node in essence gets the same parset file.
Is there anything in the processing strategy that would make this a bad idea?

@loostrum
Copy link
Member

loostrum commented Mar 16, 2018 via email

@ygrange
Copy link
Author

ygrange commented Mar 16, 2018

Can anybody explain to me what the following parameters are supposed to mean?

BW - bandwidth of what? Full bandwidth of the observation? Does this mean channel width * number of channels? Do we expect the case where we have a few missing channels; what would that mean for the BW, etc.
AZ_START - This is in eseence calculable from RA/DEC, telescope positions and UTC: correct?
ZA_START - This is in eseence calculable from RA/DEC, telescope positions and UTC: correct?
MJD_START - This is in essence another way of writing UTC_START; correct?

  • NBIT* - bits per sample; task.nrChannelsPerSubband is the number of channels per subband (yeah; pretty descriptive key). Maybe configuring number of bits per channel via external cfg, or do we want it from MAC?
    FILE_SIZE - Probably calculable from some of the already used parameters. What is common practise?
    RESOLUTION - (frequency resolution I assume; if not, ignore the rest of this sentence) I guess this may be calculable from a few of the originally defined parameters (arts.survey.nrSamplesPerChunk, arts.survey.zappedChannels and maybe arts.survey.nrChunks). Correct?
    BYTES_PER_SECOND - Comparable to FILE_SIZE; should be calculable based on telescope properties and a few observation settings.

AZ_START and ZA_START is defined per telescope. Or is it precision-wise ok to assume the average location?

Maybe some of these parameters are fixed and should be configured in a .cfg file (see also the README on this page). I would propose to pull anything out of the parset that's already in there and discuss for the other paramters whether we still want the MAC to provide those (for example if we expect telescope properties to change when a system upgrade happens; I'd rather get those data from MAC than from a local cfg file that we have to remember updating).

@ygrange
Copy link
Author

ygrange commented Mar 16, 2018

And the next question is: what about the parameters that have been defined in the interface doc and not used. Are those only relevant for the other use case (sorry; I keep mixing up 3 and 4 so I forgot which one this script applies to)

@loostrum
Copy link
Member

loostrum commented Mar 16, 2018 via email

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

No branches or pull requests

4 participants