OT tutorial SISS: Difference between revisions

From CASA Guides
Jump to navigationJump to search
Aremijan (talk | contribs)
Amoullet (talk | contribs)
No edit summary
 
(23 intermediate revisions by 3 users not shown)
Line 1: Line 1:




The objective of this tutorial is that you understand the key observation parameters which you would need to define to propose for ALMA observations (spatial resolution, sensitivity, spectral setup), and play extensively with the parameters and options in the OT so that you feel comfortable enough to craft your own proposal for the next Call for Proposals.
The objective of this tutorial is to describe the key observational parameters which you would need to define to propose for ALMA observations (spatial resolution, sensitivity, spectral setup), and to let you play with the ALMA OT so that you feel comfortable enough to craft your own proposal for the next Call for Proposals (next spring!).
This worksheet is intended as a step-by-step guide on how to prepare a mock proposal for the last ALMA Call for Proposals, by using the ALMA proposal preparation and submission tool ('Observing Tool' or OT).  Please feel free to skip any of the proposed steps which you consider not useful or irrelevant for your own training. Many special modes are not described in this basic tutorial. We recommend the [https://almascience.nrao.edu/documents-and-tools/cycle-2/alma-ot-refmanual OT User Manual] for further reference.  Sentences in brackets describe things which you would do in the case of a real proposal, and which are not relevant for this tutorial.  


== Sources characteristics ==
This worksheet is intended as a step-by-step guide on how to prepare a mock proposal for the last ALMA Call for Proposals (Cycle 4), by using the ALMA proposal preparation and submission tool ('Observing Tool' or OT).  Feel free to skip any of the proposed steps which are not applicable to the science of your practice proposal, and note that many special modes are not described in this basic tutorial. We recommend the [https://almascience.nrao.edu/documents-and-tools/cycle4/alma-ot-usermanual OT User Manual] for further reference. 


Before starting the proposal, you should have handy the sources' characteristics (or at least estimates) which will be necessary to define the proposal. These include (but are not limited to):
== Source characteristics ==


* The coordinates of the source(s), their velocity towards the observer (in km/s or redshift)
Before starting to craft a proposal, you should have an estimate of some characteristics of your source (or at least estimates). These include (but are not limited to):
* The extent or size of the emission/absorption regions for your source(s) (in arcseconds "), if they are not point-sources
* Whether the sources' emits continuum emission in the mm-range, and, if it is possible, an estimation of their continuum emission based on your own models or previous observations (in Jy at a given frequency, or in brightness temperature).
* What molecular species which can observed by ALMA are present (or expected) in the sources. You can use the [http://www.cv.nrao.edu/php/splat/ Splatalogue] to determine which lines of interest are encompassed within the ALMA bands. Be careful to include the sources' redshift/velocity when you do your line search.


If you already have a preferred source (or a set of sources) in mind, please use those for this tutorial. Otherwise, you could consider that you are interested in mapping the mm-wave emission from G0.253+0.016, a galactic molecular cloud. This source has already been observed by at submm-wavelengths with the JCMT (Di Francesco et al., 2008), the MALT90 survey (Foster et al., 2011) and Herschel (Molinari et al., 2011). You can look up the source information in the [http://arxiv.org/abs/1111.3199 Longmore et al. 2012 paper].  If you want to try and set up an ALMA Proposal based more on your science, try looking up the “Did you Know?” document prepared here: [https://science.nrao.edu/facilities/alma/facilities/alma/didyouknow Did you Know?]. That document contains specifications on sensitivity, largest angular scale, angular resolution, spectral set-ups, etc…that will help guide you through the proposal preparation process. Or, you can also go ahead and just make up something that is sensible to you.
* The coordinates of the source(s), its velocity towards the observer (in km/s or redshift)
* The extent or size of the emission/absorption regions (which will in form your necessary spatial resolution, as well as your largest angular scale, in arcseconds ")
* If it is an emission/absorption line experiment, the width of the frequency structure that you want to detect (in km/s or kHz/MHz/GHz)
* Its continuum emission flux, based on your own models or previous observations (in Jy/beam at a given frequency)
* A list of transitions (lines) of interest observable with ALMA which are present (or expected to be) in the source, and their estimated brightness (in Jy/beam). You can use the [http://www.cv.nrao.edu/php/splat/ Splatalogue] to determine which lines of interest are encompassed within the ALMA bands. Be careful to include the sources' redshift/velocity when you do your line search.  
 
If you already have a preferred source (or a set of sources) in mind, please use it for this tutorial. You can also go ahead and just make up something that is sensible to you.


== Measurement goals ==
== Measurement goals ==


Now that you know a little more about your source(s), you should decide what are the scientific goals which you want to achieve, and which are the measurements which allow you to meet your scientific goals. For example, measure the continuum distribution with a spatial resolution of 1.5". Or obtain a 10 sigma detection of HCN in a given region of the source. Or both. The measurements must be achievable within the capabilities offered by ALMA. We will here assume that you are proposing for a Cycle 2 project, for which capabilities are listed [https://almascience.nrao.edu/proposing/call-for-proposals/capabilities here].  
Now that you know a little more about your source(s), you should decide what are the scientific goals which you want to achieve, and what measurements would allow you to meet your scientific goals. For example, measuring the continuum distribution with a spatial resolution of 0.5". Or obtaining a 10 sigma detection of HCN. Or both. The measurements must be achievable within the capabilities offered by ALMA. We will assume that you are proposing for a Cycle 4 project, for which capabilities are listed [https://almascience.nrao.edu/proposing/proposers-guide#section-58 here].  


You should in particular estimate:  
If you would like to check out some ideas of what is possible with ALMA in Cycle 4 in order to get you started, check out the Did You Know page [https://science.nrao.edu/facilities/alma/didyouknow here].
 
You should in particular decide:
* The spatial resolution do you want to reach
* The spatial resolution do you want to reach
* The signal to noise do you want to achieve (on the different line detections, on the continuum detection)
* The signal to noise do you want to achieve (on a line detection or on the continuum detection)
* The frequency range(s) which you want to observe.  
* The frequency range(s) which you want to observe.  
** For continuum observations, the choice of frequency is usually driven by the optimal compromise between signal to noise and spatial resolution. You can play with the continuum reference frequency in the OT to determine which is the best option depending on your goal.
** For continuum observations, the choice of frequency is usually driven by the optimal compromise between signal to noise and spatial resolution. You can play with the continuum reference frequency in the OT to determine which is the best option depending on your goal.
Line 27: Line 32:
* The maximal spatial scale which you want to be able to retrieve  
* The maximal spatial scale which you want to be able to retrieve  


It is very likely that will go back and forth and modify your original goals while preparing the proposal, to satisfy constraints on ALMA observational setups, or optimize the signal to noise.
It is very likely that you will need to go back and forth and modify your original goals while preparing the proposal, to satisfy constraints on ALMA observational setups, or optimize the signal to noise.
 


== Starting your proposal in the OT ==
== Starting your proposal in the OT ==
Line 34: Line 38:
Now you can open the OT to prepare your proposal
Now you can open the OT to prepare your proposal


* type ./ALMA-OT.sh in your shell in the directory where you have installed the OT. Or if you use the web-based OT, just click on the 'Webstart' button on this page: https://almascience.nrao.edu/proposing/observing-tool
* type ALMA-OT.sh in a terminal
* select 'Create a new proposal' in the pop-up window. You will see a tree structure on the left panel of the OT display, which describes the structure of the proposal.  
* select 'Create a new proposal' in the pop-up window. You will see a tree structure on the left panel of the OT display, which describes the structure of the proposal.  
* click on 'Proposal' in the tree structure
* click on 'Proposal' in the tree structure
* on the main panel, write some high-level information on the proposal (Title, Abstract, Keywords).
* on the main panel, write some general information on the proposal (Title, Proposal Type, ...).
* [add yourself as a PI and collaborators as co-Is. You can only add people who are registered in the ALMA userbase. You can register at almascience.org ('Register' link at the top-right corner)]
* [attach a pdf of your scientific justification]




== Determine the science goals ==
== Determine the science goals ==


An ALMA proposal is composed of one or several science goals (SG). A science goal groups observations which can be obtained in the same observation instance. In practice this means that a SG can include a limited number of sources which are sufficiently nearby in the sky (<10 degrees apart), with a single receiver and correlator setup (central rest frequencies, resolution and width of spectral windows). However, a single science goal can be used with several arrays or configurations (for example, ACA and 12-m array, or extended 12-m and compact 12-m configurations). It is also possible to include sources with (limited) different velocities in a single SG, as long as the spectral setup can be observed within a single ALMA band. [From a scientific goal is produced a scheduling block, which is the set of instructions given to the telescope to perform an observation.]
An ALMA proposal is composed of one or several science goals (SG). In practice, each SG (or pseudo-SG) corresponds to observations obtained with a single receiver and correlator/receiver setup (except for spectral scan mode) of sources which are sufficiently nearby in the sky (~<10 degrees apart) to be observed with the same phase calibrator. However, a single science goal can be used with several arrays or configurations (for example, ACA and 12-m array, or extended 12-m and compact 12-m configurations). The telescope observation instructions (scheduling blocks or SBs) are produced based on the SGs inputs.


* [Determine how many science goals will need to be created based on your sources' characteristics and measurement goals]
* Create one (or several) scientific goals by clicking on the 'target' button on the task bar of the OT ('New phase 1 science goal')
* Create one (or several) scientific goals by clicking on the 'target' button on the task bar of the OT ('New phase 1 science goal')
* In the project tree, click on the newly created SGs. You will see that each SG is divided in 6 sections (General, Field, Spectral, Calibration, Control, Justification)
* In the project tree, click on the newly created SG. You will see that the SG is divided in 6 panels (General, Field, Spectral, Calibration, Control, Justification)
* In the general section of each SG, give a distinctive name to the science goal
* In the 'General' panel of the SG, give a distinctive name to the science goal
* The next sections will guide you on how to define each SG
* The next sections will help you to fill each panel of the SG




== Define the sources ==
== Field panel (source definition) ==


* In the tree structure click on the 'Field Setup' section of a SG
* In the tree structure click on the 'Field Setup' section of a SG
* In the 'source' panel, define the name, coordinates and velocity (in km/s or z) of one source
* In the 'Field Setup' tab, define the name, coordinates and velocity (in km/s or z) of a source, as well as some expected properties
* In the 'expected properties' panel define some expected properties (as far as you know)
** Note that the expected fluxes densities are defined 'per beam'. This corresponds to the flux encompassed in a resolution unit of the size of your requested angular resolution. For example, if you know that your source has a 4"-wide circular disk shape on the plane-of sky, emitting 1 Jy of continuum emission total, the peak flux density per beam of 0.4" will be 10 mJy.
* Note that the expected fluxes densities are defined 'per beam'. This corresponds to the flux encompassed in a resolution unit of the size of your requested angular resolution. For example, if you know that you source is a 4"-wide disk emitting 1 Jy of continuum emission total, the peak flux density per beam of 0.4" will be 10 mJy. You can find more information on how to convert the fluxes from other observations in 'expected flux density per beam' here XX [Gerald's tutorial ?)
* if your source size may extend beyond half of the primary beam of the telescope (which depends on the observing frequency), or if it is composed of several regions of interest which are more than half of the primary beam away from each other, you will need to observe multiple pointings within your source. In that case:
**  you may prefer to define yourself the coordinate of each pointing. Select 'individual pointings' on the 'target type' line. Add as many pointings as desired by clicking on 'Add' at the bottom of the 'Field Center coordinates' panel. You can define the coordinates of each pointing in RA/Dec or offsets from the coordinates defined above. By clicking 'custom mosaic', these pointings will be imaged as a single mosaic
** you may prefer to set up a regular pattern of pointings so as to ideally cover a given area around the source center. Select 'Rectangular field' on the 'target type' line. You will need to define the size of the area in two directions (p and q), and the spacing between pointings. The OT will suggest a number of pointings with the 12-m array, and - if necessary - a number of pointings with the 7m array.
* In the 'Spatial' tab (top of the panel), you can obtain a graphic view of the chosen pointing pattern. You will need to upload a fits file of the source or make an image query.
* If you want to add additional sources to the SG, click on 'Add Source' at the bottom of the panel
* If you want to add additional sources to the SG, click on 'Add Source' at the bottom of the panel
* Define each additional source coordinates, velocity and expected properties
* You can flip through the different defined sources by using the tabs at the top of the panel
* You can flip through the different defined sources by using the tabs at the top of the panel


 
== Spectral Setup panel (receiver and correlator setup) ==
== Define the receiver and correlator setup ==


* In the tree structure on the left panel in the display, click on the 'Spectral Setup' section of a SG
* In the tree structure on the left panel in the display, click on the 'Spectral Setup' section of a SG
* On the 'Spectral type' line, you need to define if this is a line project (spectral line or spectral scan) or a continuum project
* On the 'Spectral type' line, you need to define if this is a line project (spectral line or spectral scan) or a continuum project
* At any time you can have a graphic view of your spectral setup plotted over the atmospheric absorption spectrum in the 'Spectral' tab on the top of the panel.
* If it is a pure continuum project, you will probably want to maximize the observed bandwidth and use the low resolution-large bandwidth mode of the correlator (Time Division Mode or TDM). Define the receiver band corresponding to your chosen frequency, and you'll be given a default suggested frequency and a correlator setup (4 2-GHz wide spectral windows). You can change the average sky frequency (the corresponding rest frequency is shown below).  
* If it is a pure continuum project, you will probably want to maximize the observed bandwidth and use the low resolution-large bandwidth mode of the correlator (Time Domain Mode or TDM). Define the receiver band corresponding to your chosen frequency, and you'll be given a default suggested frequency and a correlator setup (4 2-GHz wide spectral windows). You can change the average sky frequency (the corresponding rest frequency the first defined source is shown below).  
* In the case of a line project, you will need to manually define each of the desired spectral windows within the four basebands. Each baseband encompasses at most 2 continuous GHz of the sky spectrum, and can be split in up to 4 spectral windows. There are several rules restricting how basebands and spectral windows within basebands can be setup with respect to each other.
* In the case of a line project, you will need to manually define each of the desired spectral windows within the four basebands. Each baseband encompasses at most 2 continuous GHz of the sky spectrum, and can be split in up to 4 spectral windows. There are several rules restricting how basebands and spectral windows within basebands can be setup with respect to each other.
** Add spectral windows in each baseband. To do that in a given baseband, you can either:
** Add spectral windows in each baseband. To do that in a given baseband, you can either:
*** click on the 'add' button below the baseband panel. An additional line appears above, in which you write the desired central frequency directly in either the 'rest' frequency' or 'sky' box
*** click on the 'add' button below the baseband panel. An additional line appears above, in which you write the desired central frequency directly in either the 'rest' frequency' or 'sky' box
*** click on the 'Select Lines to Observe' button below the baseband panel. A line selection window pops up, showing a selection of lines from the Splatalogue catalogue. You can refine your line search by selecting on the left the desired ALMA band, the range of sky frequencies, or the maximum energy state of the transitions. Once you have identified the line you want, highlight it and click on 'Add to selected transitions'. You can then continue your line search and select up to 4 transitions. When you click on 'ok' (bottom right), a spectral window will be created for each of the selected transition. Any unacceptable selection will be highlighted in red in the 'Spectral Setup Errors' box.
*** click on the 'Select Lines to Observe' button below the baseband panel. A line selection window pops up, showing a selection of lines from the Splatalogue catalogue. You can refine your line search by selecting on the left the desired ALMA band, the range of sky frequencies, or the maximum energy state of the transitions. Once you have identified the line you want, highlight it and click on 'Add to selected transitions'. You can then continue your line search and select up to 4 transitions. When you click on 'ok' (bottom right), a spectral window will be created for each of the selected transition. Any unacceptable selection will be highlighted in red in the 'Spectral Setup Errors' box.
**  Define the spectral resolution/bandwidth and spectral smoothing of each spectral window. This is mainly driven by the expected width of the observed spectral lines, and how well you need to resolve them. Note that all spectral windows within a baseband must shared the same resolution before smoothing. The spectral resolution and smoothing determine 
**  Define the spectral resolution/bandwidth and spectral smoothing of each spectral window. This is mainly driven by the expected width of the observed spectral lines, and how well you need to resolve them. Note that all spectral windows within a baseband must share the same resolution before smoothing.  
* Select which one of the spectral windows will define the representative frequency for which parameters such as noise, signal to noise and resolution are calculated.
* Select which one of the spectral windows will define the representative frequency for which parameters such as noise, signal to noise and resolution are calculated.
* At any time you can have a graphic view of your spectral setup plotted over the atmospheric absorption spectrum in the 'Spectral' tab on the top of the panel.




== Define the needed arrays and configurations ==
== Control and performance panel==


Depending on your desired angular resolution and the maximal characteristic scale which you want to image, you may need to combine observation from different arrays or array configurations to reach your measurement goals. An extended configuration of the main array (the 12-m array, composed of 34 12-m antennas) may provide an excellent spatial resolution, but filter out large scales. You may compensate this by adding observations in a more compact configuration of the 12-m array, or observations by the ACA (Atacama Compact Array, composed of 9 7-m antennas). You will find more information to understand the concept of largest recoverable scale here https://science.nrao.edu/science/videos/largest-angular-scale-and-maximum-recoverable-scale.
 
The signal to noise which you want to achieve drives the required sensitivity, which necessitates a certain amount of observing time to be reached.
Determining the necessary sensitivity is (pretty) simple. You have an idea of the signal to noise you want on your detection (S/N ratio). You have an estimate of the flux density (signal) of the source per beam: for a continuum detection this is the peak continuum flux density. For a line detection, this is the peak flux density averaged over the lowest spectral resolution unit on which you want to achieve a detection (usually, the expected FWHM of the line). The sensitivity (noise) hence corresponds to the flux density per beam divided by the S/N ratio. If the SG includes different lines and continuum detections, each leading to different desired sensitivities, the desired sensitivity for the SG will be defined as the most stringent of these sensitivities.


* In the tree structure on the left panel in the display, click on the 'Control and Performance' section of a SG
* In the tree structure on the left panel in the display, click on the 'Control and Performance' section of a SG
* Enter the desired angular resolution and largest angular structure (LAS)
* Write down your desired sensitivity (in Jy)
* Click on 'Suggest' to see whether the use of ACA is suggested to reach your goals. It may be the case that achieving both the requested angular resolution and LAS is not possible.
* Write the corresponding bandwidth. For a continuum project, this is the aggregate bandwidth over all spectral windows. For a line project, this is the lowest spectral resolution unit on which you want to achieve the detection.
* Depending on the suggestion, click 'yes' or 'no' on the 'Request complementary ACA observations' line.
 
 
== Define the source pointing pattern ==


Now that you know the frequency range at which you will observe and the arrays which you will request, you are able to determine if the mapping of your source requires several pointings.
Now you can define the imaging performance parameters which are necessary to perform your project
* Enter the desired angular resolution
* Enter the largest angular structure (LAS)


* In the tree structure on the left panel in the display, click on the 'Field Setup' section of a SG
* if your source size extends beyond half of the primary beam of the telescope, or if it is composed of several regions of interest which are more than half of the primary beam away from each other, you will need to observe multiple pointings within your source. Estimate if you need one or several pointings.
* If multiple pointings are needed:
**  you may prefer to define yourself the coordinate of each pointing. Select 'individual pointings' on the 'target type' line. Add as many pointings as desired by clicking on 'Add' at the bottom of the 'Field Center coordinates' panel. You can define the coordinates of each pointing in RA/Dec or offsets from the coordinates defined above.
** you may prefer to set up regular pattern of pointings so as to ideally cover a given area around the source center. Select 'Rectangular field' on the 'target type' line. You will need to define the size of the area in two directions (p and q), and the spacing between pointings. The OT will suggest a number of pointings with the 12-m array, and - if necessary- a number of pointings with the 7m array.
*In the 'Spatial' tab (top of the panel), you can obtain a graphic view of the chosen pointing pattern. You will need to upload a fits file of the source or make an image query.


== Control and performance panel: observing time and arrays==


== How much time will you need ? ==
* Click on 'Time Estimate'. You will obtain a breakdown of the estimated time to be spent on source and on calibrators, as well as which arrays and configurations are needed to perform the proposed measurement


You have now defined most of your observational setup. To verify if all parameters are set in a correct way, run a proposal validation (check mark icon on the main task bar). This will indicate if there are some errors in the proposal and parameters need to be changed.
Depending on your desired angular resolution and the maximal characteristic scale which you want to image, the time estimator may indicate that a combination observation from different arrays or array configurations is needed. An extended configuration of the main array (the 12-m array, composed of 40 12-m antennas) may provide an excellent spatial resolution, but filter out large scales. This would be compensated by adding observations, not necessarily simultaneous, in a more compact configuration of the 12-m array, or observations by the ACA (Atacama Compact Array, composed of 9 7-m antennas). You will find more information to understand the concept of largest recoverable scale here https://science.nrao.edu/science/videos/largest-angular-scale-and-maximum-recoverable-scale.
 
The signal to noise which you want to achieve drives the required sensitivity, which necessitates a certain amount of observing time to be reached. In Cycle 2, up to 100h per proposal could be allocated, and the typical proposal lasted ~ 8h.
Determining the necessary sensitivity is (pretty) simple. You have an idea of the signal to noise you want on your detection (S/N ratio). You have an estimate of the flux density (signal) of the source per beam: for a continuum detection this is the peak continuum flux density. For a line detection, this is the peak flux density averaged over the lowest spectral resolution unit on which you want to achieve a detection (usually, the expected FWHM of the line). The sensitivity (noise) hence corresponds to the flux density per beam divided by the S/N ratio. If the SG combines different lines and continuum detections, each leading to different desired sensitivities, the desired sensitivity for the SG will be defined as the most stringent of these sensitivities.
 
* In the tree structure on the left panel in the display, click on the 'Control and Performance' section of a SG
* Write down your desired sensitivity (in Jy)
* Write the corresponding bandwidth. For a continuum project, this is the aggregate bandwidth over all spectral windows. For a line project, this is the lowest spectral resolution unit on which you want to achieve the detection.
* Click on 'Time Estimate'. You will obtain a breakdown of the estimated time to be spent on source and on calibrators. The time estimate will also tell you if your requested spatial resolution is achievable (otherwise, change it).


If you think that your time request is too high with respect to what you could hope being awarded, there are many ways to drive it down. Remember that the observing time varies as the square of the sensitivity, so a small change in requested sensitivity can significantly change the time request.
If you think that the final time estimate is too high with respect to what you could hope being awarded, there are many ways to drive it down. Remember that the observing time varies as the square of the sensitivity, so a small change in requested sensitivity can significantly change the time request.


* Increase the requested angular resolution. With a larger synthesized beam, the sources' expected flux per beam needs to be increased accordingly. For a constant desired S/N ratio, the corresponding desired sensitivity will be increased.
* Increase the requested angular resolution. With a larger synthesized beam, the (resolved) sources' expected flux per beam increases. For a constant desired S/N ratio, the corresponding desired sensitivity will be increased.
* Decrease the size of the area to be mapped - hence decreasing the number of necessary pointings.
* Decrease the size of the area to be mapped - hence decreasing the number of necessary pointings.
* Increase the spectral resolution unit for line detection.
* Increase the spectral resolution unit for line detection.
Line 120: Line 109:
* Eliminate scientific objectives which are too time-expensive
* Eliminate scientific objectives which are too time-expensive


You may need several iterations to hone the most optimal observation parameters. It is also a good idea to regularly run a proposal validation, to verify if all parameters are still consistent and valid.
You may need several iterations to hone the most optimal observation parameters.


You have now defined most of your observational setup. To verify if all parameters are set in a correct way, run a proposal validation (check mark icon on the main task bar). This will indicate if there are some errors in the proposal and parameters need to be changed.


== Submit ==


== If this was a real submission [INFORMATIONAL ONLY] ==
There are additional steps to undertake to transform a mock-up proposal into a real one. Those steps *should not be performed* during this exercise, but for your information only, here they are:
* add yourself as a PI and collaborators as co-Is. You can only add people who are registered in the ALMA userbase. You can register at almascience.org ('Register' link at the top-right corner)
* justify your choices of observational parameters in the 'technical Justification' tab
* attach a pdf of your scientific justification
* generate a pdf file of your proposal. In the Tool section at the top of the window, click on 'Generate a pdf'
* generate a pdf file of your proposal. In the Tool section at the top of the window, click on 'Generate a pdf'
* [Submit it: In the File section at the top of the window, click on 'Submit' ]
* Submit it: In the File section at the top of the window, click on 'Submit'
 
If you used the G0.253+0.016 example, you can compare your setup with the ALMA observations of the same source which were performed in Cycle 0: http://fr.arxiv.org/abs/1403.4734 (Higuchi et al., 2014)

Latest revision as of 20:48, 7 June 2016


The objective of this tutorial is to describe the key observational parameters which you would need to define to propose for ALMA observations (spatial resolution, sensitivity, spectral setup), and to let you play with the ALMA OT so that you feel comfortable enough to craft your own proposal for the next Call for Proposals (next spring!).

This worksheet is intended as a step-by-step guide on how to prepare a mock proposal for the last ALMA Call for Proposals (Cycle 4), by using the ALMA proposal preparation and submission tool ('Observing Tool' or OT). Feel free to skip any of the proposed steps which are not applicable to the science of your practice proposal, and note that many special modes are not described in this basic tutorial. We recommend the OT User Manual for further reference.

Source characteristics

Before starting to craft a proposal, you should have an estimate of some characteristics of your source (or at least estimates). These include (but are not limited to):

  • The coordinates of the source(s), its velocity towards the observer (in km/s or redshift)
  • The extent or size of the emission/absorption regions (which will in form your necessary spatial resolution, as well as your largest angular scale, in arcseconds ")
  • If it is an emission/absorption line experiment, the width of the frequency structure that you want to detect (in km/s or kHz/MHz/GHz)
  • Its continuum emission flux, based on your own models or previous observations (in Jy/beam at a given frequency)
  • A list of transitions (lines) of interest observable with ALMA which are present (or expected to be) in the source, and their estimated brightness (in Jy/beam). You can use the Splatalogue to determine which lines of interest are encompassed within the ALMA bands. Be careful to include the sources' redshift/velocity when you do your line search.

If you already have a preferred source (or a set of sources) in mind, please use it for this tutorial. You can also go ahead and just make up something that is sensible to you.

Measurement goals

Now that you know a little more about your source(s), you should decide what are the scientific goals which you want to achieve, and what measurements would allow you to meet your scientific goals. For example, measuring the continuum distribution with a spatial resolution of 0.5". Or obtaining a 10 sigma detection of HCN. Or both. The measurements must be achievable within the capabilities offered by ALMA. We will assume that you are proposing for a Cycle 4 project, for which capabilities are listed here.

If you would like to check out some ideas of what is possible with ALMA in Cycle 4 in order to get you started, check out the Did You Know page here.

You should in particular decide:

  • The spatial resolution do you want to reach
  • The signal to noise do you want to achieve (on a line detection or on the continuum detection)
  • The frequency range(s) which you want to observe.
    • For continuum observations, the choice of frequency is usually driven by the optimal compromise between signal to noise and spatial resolution. You can play with the continuum reference frequency in the OT to determine which is the best option depending on your goal.
    • For line observations, this choice is driven by the sky frequencies of the lines would be the most suited for your scientific goal (based on your own models, previous publications, line parameters from Splatalogue)
  • The maximal spatial scale which you want to be able to retrieve

It is very likely that you will need to go back and forth and modify your original goals while preparing the proposal, to satisfy constraints on ALMA observational setups, or optimize the signal to noise.

Starting your proposal in the OT

Now you can open the OT to prepare your proposal

  • type ALMA-OT.sh in a terminal
  • select 'Create a new proposal' in the pop-up window. You will see a tree structure on the left panel of the OT display, which describes the structure of the proposal.
  • click on 'Proposal' in the tree structure
  • on the main panel, write some general information on the proposal (Title, Proposal Type, ...).


Determine the science goals

An ALMA proposal is composed of one or several science goals (SG). In practice, each SG (or pseudo-SG) corresponds to observations obtained with a single receiver and correlator/receiver setup (except for spectral scan mode) of sources which are sufficiently nearby in the sky (~<10 degrees apart) to be observed with the same phase calibrator. However, a single science goal can be used with several arrays or configurations (for example, ACA and 12-m array, or extended 12-m and compact 12-m configurations). The telescope observation instructions (scheduling blocks or SBs) are produced based on the SGs inputs.

  • Create one (or several) scientific goals by clicking on the 'target' button on the task bar of the OT ('New phase 1 science goal')
  • In the project tree, click on the newly created SG. You will see that the SG is divided in 6 panels (General, Field, Spectral, Calibration, Control, Justification)
  • In the 'General' panel of the SG, give a distinctive name to the science goal
  • The next sections will help you to fill each panel of the SG


Field panel (source definition)

  • In the tree structure click on the 'Field Setup' section of a SG
  • In the 'Field Setup' tab, define the name, coordinates and velocity (in km/s or z) of a source, as well as some expected properties
    • Note that the expected fluxes densities are defined 'per beam'. This corresponds to the flux encompassed in a resolution unit of the size of your requested angular resolution. For example, if you know that your source has a 4"-wide circular disk shape on the plane-of sky, emitting 1 Jy of continuum emission total, the peak flux density per beam of 0.4" will be 10 mJy.
  • if your source size may extend beyond half of the primary beam of the telescope (which depends on the observing frequency), or if it is composed of several regions of interest which are more than half of the primary beam away from each other, you will need to observe multiple pointings within your source. In that case:
    • you may prefer to define yourself the coordinate of each pointing. Select 'individual pointings' on the 'target type' line. Add as many pointings as desired by clicking on 'Add' at the bottom of the 'Field Center coordinates' panel. You can define the coordinates of each pointing in RA/Dec or offsets from the coordinates defined above. By clicking 'custom mosaic', these pointings will be imaged as a single mosaic
    • you may prefer to set up a regular pattern of pointings so as to ideally cover a given area around the source center. Select 'Rectangular field' on the 'target type' line. You will need to define the size of the area in two directions (p and q), and the spacing between pointings. The OT will suggest a number of pointings with the 12-m array, and - if necessary - a number of pointings with the 7m array.
  • In the 'Spatial' tab (top of the panel), you can obtain a graphic view of the chosen pointing pattern. You will need to upload a fits file of the source or make an image query.
  • If you want to add additional sources to the SG, click on 'Add Source' at the bottom of the panel
  • You can flip through the different defined sources by using the tabs at the top of the panel

Spectral Setup panel (receiver and correlator setup)

  • In the tree structure on the left panel in the display, click on the 'Spectral Setup' section of a SG
  • On the 'Spectral type' line, you need to define if this is a line project (spectral line or spectral scan) or a continuum project
  • If it is a pure continuum project, you will probably want to maximize the observed bandwidth and use the low resolution-large bandwidth mode of the correlator (Time Division Mode or TDM). Define the receiver band corresponding to your chosen frequency, and you'll be given a default suggested frequency and a correlator setup (4 2-GHz wide spectral windows). You can change the average sky frequency (the corresponding rest frequency is shown below).
  • In the case of a line project, you will need to manually define each of the desired spectral windows within the four basebands. Each baseband encompasses at most 2 continuous GHz of the sky spectrum, and can be split in up to 4 spectral windows. There are several rules restricting how basebands and spectral windows within basebands can be setup with respect to each other.
    • Add spectral windows in each baseband. To do that in a given baseband, you can either:
      • click on the 'add' button below the baseband panel. An additional line appears above, in which you write the desired central frequency directly in either the 'rest' frequency' or 'sky' box
      • click on the 'Select Lines to Observe' button below the baseband panel. A line selection window pops up, showing a selection of lines from the Splatalogue catalogue. You can refine your line search by selecting on the left the desired ALMA band, the range of sky frequencies, or the maximum energy state of the transitions. Once you have identified the line you want, highlight it and click on 'Add to selected transitions'. You can then continue your line search and select up to 4 transitions. When you click on 'ok' (bottom right), a spectral window will be created for each of the selected transition. Any unacceptable selection will be highlighted in red in the 'Spectral Setup Errors' box.
    • Define the spectral resolution/bandwidth and spectral smoothing of each spectral window. This is mainly driven by the expected width of the observed spectral lines, and how well you need to resolve them. Note that all spectral windows within a baseband must share the same resolution before smoothing.
  • Select which one of the spectral windows will define the representative frequency for which parameters such as noise, signal to noise and resolution are calculated.
  • At any time you can have a graphic view of your spectral setup plotted over the atmospheric absorption spectrum in the 'Spectral' tab on the top of the panel.


Control and performance panel

The signal to noise which you want to achieve drives the required sensitivity, which necessitates a certain amount of observing time to be reached. Determining the necessary sensitivity is (pretty) simple. You have an idea of the signal to noise you want on your detection (S/N ratio). You have an estimate of the flux density (signal) of the source per beam: for a continuum detection this is the peak continuum flux density. For a line detection, this is the peak flux density averaged over the lowest spectral resolution unit on which you want to achieve a detection (usually, the expected FWHM of the line). The sensitivity (noise) hence corresponds to the flux density per beam divided by the S/N ratio. If the SG includes different lines and continuum detections, each leading to different desired sensitivities, the desired sensitivity for the SG will be defined as the most stringent of these sensitivities.

  • In the tree structure on the left panel in the display, click on the 'Control and Performance' section of a SG
  • Write down your desired sensitivity (in Jy)
  • Write the corresponding bandwidth. For a continuum project, this is the aggregate bandwidth over all spectral windows. For a line project, this is the lowest spectral resolution unit on which you want to achieve the detection.

Now you can define the imaging performance parameters which are necessary to perform your project

  • Enter the desired angular resolution
  • Enter the largest angular structure (LAS)


Control and performance panel: observing time and arrays

  • Click on 'Time Estimate'. You will obtain a breakdown of the estimated time to be spent on source and on calibrators, as well as which arrays and configurations are needed to perform the proposed measurement

Depending on your desired angular resolution and the maximal characteristic scale which you want to image, the time estimator may indicate that a combination observation from different arrays or array configurations is needed. An extended configuration of the main array (the 12-m array, composed of 40 12-m antennas) may provide an excellent spatial resolution, but filter out large scales. This would be compensated by adding observations, not necessarily simultaneous, in a more compact configuration of the 12-m array, or observations by the ACA (Atacama Compact Array, composed of 9 7-m antennas). You will find more information to understand the concept of largest recoverable scale here https://science.nrao.edu/science/videos/largest-angular-scale-and-maximum-recoverable-scale.

If you think that the final time estimate is too high with respect to what you could hope being awarded, there are many ways to drive it down. Remember that the observing time varies as the square of the sensitivity, so a small change in requested sensitivity can significantly change the time request.

  • Increase the requested angular resolution. With a larger synthesized beam, the (resolved) sources' expected flux per beam increases. For a constant desired S/N ratio, the corresponding desired sensitivity will be increased.
  • Decrease the size of the area to be mapped - hence decreasing the number of necessary pointings.
  • Increase the spectral resolution unit for line detection.
  • If possible, change the frequency for a frequency offering a better S/N ratio (often at the expense of spatial resolution)
  • Eliminate scientific objectives which are too time-expensive

You may need several iterations to hone the most optimal observation parameters.

You have now defined most of your observational setup. To verify if all parameters are set in a correct way, run a proposal validation (check mark icon on the main task bar). This will indicate if there are some errors in the proposal and parameters need to be changed.


If this was a real submission [INFORMATIONAL ONLY]

There are additional steps to undertake to transform a mock-up proposal into a real one. Those steps *should not be performed* during this exercise, but for your information only, here they are:

  • add yourself as a PI and collaborators as co-Is. You can only add people who are registered in the ALMA userbase. You can register at almascience.org ('Register' link at the top-right corner)
  • justify your choices of observational parameters in the 'technical Justification' tab
  • attach a pdf of your scientific justification
  • generate a pdf file of your proposal. In the Tool section at the top of the window, click on 'Generate a pdf'
  • Submit it: In the File section at the top of the window, click on 'Submit'