Doc 6.15, ver. 1.0 | March, 2018

ALMA Science Archive Manual

ALMA, an international astronomy facility, is a partnership of Europe, North America and East Asia
in cooperation with the Republic of Chile.

For further information or to comment on this document, please contact your regional Helpdesk through the ALMA User
Portal at www.almascience.org . Helpdesk tickets will be redirected automatically to the nearest ALMA Regional Centerat ESO, NAOJ or NRAO.

Version

Date

Editors

4.1.0.x

March 2016

5.1.0.x

March 2017

6.1.0.x

March 2018

Felix Stoehr, Eric Murphy, Mark Lacy, Stéphane Leon, Erik
Muller, Kouchiro Nakanishi
Brenda Matthews, Felix Stoehr, Mark Lacy, Kouchiro Nakanishi,
Stéphane Leon
Brenda Matthews, Felix Stoehr, John Hibbard, Kouchiro Nakanishi, Kuo-Song Wang, Stéphane Leon

In publications, please refer to this document as:
F. Stoehr et al. 2018, ALMA Science Archive Manual, ALMA Doc. 6.15 v1.0

Contents
1 Introduction

1

1.1

Quickstart . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

1

1.2

User support

1. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

2 Science Portal

3

2.1

Archive Data and Documents . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

3

2.2

Project access delegation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

33 Science Archive5

3.1

Content and policies

3.2

Querying the ALMA Science Archive . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

5

3.3

Browsing the results7

3.4

Selecting the les for download

3.5

Downloading the data

3.6

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

5. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

9. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

10

Data packaging . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

11

3.6.1

Directory structure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

11

3.6.2

Cycle 0. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

12

3.6.3

Cycle 1 and later . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

12

4 Programmatic access

13

4.1

astroquery . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

13

4.2

VO . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

13

5 Scientic exploitation of the data

15

6 Acknowledgement statement

17

7 Frequently asked questions

19

3

This page was intentionally left almost blankChapter 1

Introduction
1.1 Quickstart
Searching for and downloading ALMA data is done in a few easy steps:
1. Place search constraints into the Query Form at http://almascience.org/aq and hit "Search"
2. Use the checkboxes to select observations of interest and hit "Submit download request"
3. Use the checkboxes to select les of interest and hit "Download selected"
4. Use one of the proposed download methods to save the selected les onto your computer.
The functionalities oered by the ALMA Science Archive (ASA) for each of these four steps are detailed in
sections 3.2, 3.3, 3.4 and 3.5, respectively.

1.2 User support
1

In each of the three partner regions an ALMA Regional Centre (ARC) has been established . Each ARC provides
scientic user support in the core areas of proposal preparation (Phase 1), observation program preparation(Phase 2) and data analysis to users in their respective communities.

The ARCs also host a full copy of the

ALMA Archive and deliver data packages to users. The ARCs are the ALMA interfaces to the user.

2 for any question orPlease do not hesitate to contact the ARCs or ARC nodes through the ALMA Helpdesk

comment. In particular we strongly enourage requests for face-to-face visits with the experts at one of the ARCsor ARC nodes for archival research purposes.

All ARCs and ARC nodes or a cooperative department of the

ARC do have computing facilities available.

1 http://almascience.org/about-alma/alma-organization
2 http://help.almascience.org

1Chapter 2

Science Portal
Each ARC maintains a full copy of the ALMA archive and hosts one of the three ALMA Science Portals (SP).

From the toplevel link http://www.almascience.org, you will be automatically redirected to the SP of yourclosest ARC and your ALMA credentials are valid at each of them following the "single-sign-on" principle.
To obtain ALMA data, click on the "Data" entry in the top menu of the Science Portal. Here you will nd links
to the three types of ALMA data: Archive: ALMA data taken for PI programs
 Calibrator Catalogue: Information on calibration sources, including ux histories
 Science Verication: ALMA data taken for Science Verication
In addition, there is the top-menu item "Processing" which amongst other items contains information on thedata processing performed by the Observatory and indications of the computing resources required to re-reduce
data at your home institution should you wish to do so.

2.1 Archive Data and Documents
The Archive link takes you to a page with a button that brings up the ALMA Query interface (AQ). On this1

page there is also a link to a page listing the contents of the Cycle 0 deliveries .

Useful documents available

from the Documents and Tools link include the ALMA Science Pipeline User's Guide, CASA documentation anddescriptions of the ALMA quality assurance for data products ("QA2") and the delivered data products under"ALMA QA2 Data Products" (see also Section 3.6).

2.2 Project access delegation
A PI can grant access rights to Co-Is or any other registered ALMA user directly from the ALMA Science Portal.
To do this, the PI should authenticate using the "Log in" button in the top right corner of the Science Portal,
click on their username and select "Prole" from the menu. Then select the "Project Delegation" tab and selectthe project to which you wish to grant another user proprietary access, and click on the "Add delegee" button
at the bottom left of the page. Users who are granted access via the project delegation mechanism can log in
to any of the three ARCs with their own account and can download the data from there. Data access is always
granted to entire projects rather than individual deliveries from a project. Delegating access to a project does
not allow the delegee to grant project access to others.

1 http://almascience.org/alma-data/archive/delivery-list

3

Chapter 3

Science Archive
3.1 Content and policies
The ALMA Science Archive (ASA) contains all public and proprietary data of PI-proposal observations.
ALMA is producing currently roughly 300TB worth of raw-data and reduced data products per year.

These

data are stored at the Joint ALMA Observatory in Santiago, Chile and are copied from there to the three ARCs.
Each ARC holds a complete copy of the ASA. (See chapter 14 of the Technical Handbook

1 for details.)

ALMA data from Regular and Large Programs are protected by a proprietary period of 12 months, after which
they become public. The proprietary period of a DDT project data is 6 months. All public data can be accessed
anonymously. Observational metadata (e.g., source names and positions, spectral setups, etc.) are not protectedby a proprietary period and are available directly from the ASA as soon as the data have passed the rst stepof quality control, QA0.
Data from calibration observations carried out during PI observations have no proprietary period.

As these

observations are contained in the data les of the proprietary data, it is currently not possible to extract them inan automatic fashion. Should you be interested in calibrator data contained in proprietary observations, pleasewrite a ticket to the ALMA Helpdesk, and we will extract the data for you on a best-eort basis.

2 for details.

Please refer to the ALMA User's policies

3.2 Querying the ALMA Science Archive
Sources can be queried either by their name or by a search near a position on the sky specied in Right Ascension
and Declination or Galactic coordinates.

The name resolver uses Sesame

3 to perform a semi-case-insensitive

search for a source name. A search radius in degrees can be added to the end of the name search separated by
a comma (e.g., "Arp220, 1"), where the default radius is 10 arcmin.

Sesame (via NED, Simbad and VizieR)

will parse names commonly found throughout the literature and return search coordinates. A green check markindicates a successful search, otherwise, a red cross is returned.

Sources can also be queried by their ALMA

name, which is the name of the source as entered by the PI in the Observing Tool (OT). For this case, partial
matches through wildcards (?, *) and boolean OR expressions ("|") can be used.
Various other constraints can be placed on a query to the ALMA Science Archive. As Figure 3.2 shows, they
have been grouped into the following eight categories: Position, Energy, Time, Polarisation, Observation, Project,
Publication and Options. Autocompletion is enabled in all text elds except for the Source Name (Resolver)eld, allowing for easier search.

In addition to the single source search, a target list can be uploaded.

Notethat despite the suggestions from the autocompletion, the full set of operations (including wildcards and OR) is

1 http://almascience.org/documents-and-tools/cycle5/alma-technical-handbook
2 http://almascience.org/documents-and-tools/cycle5/alma-user-policies
3 http://cds.u-strasbg.fr/cgi-bin/Sesame5

available.
Each query constraint comes with a tooltip help that provides a description, the units in case of queries forphysical parameters, and examples. Clicking on an example will insert it directly into the query constraint eld.

.
Figure 3.1: The archive query interface and an example tooltip, which shows the formats acceptable for entry
and provides clickable examples.
Query constraints in addition to those mentioned above include: angular resolution (00) continuum sensitivity (mJy/beam)
 line sensitivity (10km/s) (mJy/beam) largest angular scale (00) precipitable water vapor (mm) sky frequency (GHz) total bandwidth (GHz) spectral resolution (kHz) ALMA receiver band number observation date integration time (s) Polarization type
The query elds support a large number of operators. A full list of the capabilities can be accessed from the"Query help" link in the top right corner of the interface.
By default the search results are displayed so that one row of the results table corresponds to one observationin the raw data. However, if you are only interested in a list of projects that match the search criteria, you canselect the project" option. Furthermore, a search can be constrained to only return public data, i.e. data thatyou have access to without being a PI or having been delegated access rights to data.
In addition to being able to place constraints on the titles, authors or abstracts of publications resulting from
ALMA data we oer the publication count constraint. Setting this to 0 and selecting "public data only" shows
public but yet unpublished ALMA data.
During the observing process, ALMA observes calibrator sources in addition to science observations requestedby the PI. These are mostly planets and quasars. Uncheck the "Science Observations only" checkbox to include
those observations in the search.
We also provide search on the scientic keywords that PIs specify when writing the proposals. These permit
search for data per science topic. In addition we create scientic categories from those keywords to easier selectentire scientic areas. Note that the categories we provide are dierent from the categories in the OT: the latterdo change from cycle to cycle.
The largest angular scale and the angular resolution computations use the 5%ile and 95%ile of the projectedbaseline lengths which is an improvement over previous calculations and also matches the way those quantities
are computed in the OT and in AQUA.
If they are known before the query, the additional constraints can be entered directly into the query form as
described. However, for quicker exploration, additional constraints (ltering) can be applied also directly on the
results table.

3.3 Browsing the results
After executing a search, you can browse the results in the Results Table tab. By default, eleven columns areshown that include the Project code, Source name, RA, Dec, Band, Integration time, Release date, Velocity
resolution, Frequency support and the number of publications from those data.
Clicking on the headers of the columns will sort the Results table according to the values in that column.
Reordering of the columns can be done by dragging and dropping the column headers horizontally.
The observations are shown in their astronomical context in a skyview window above the results table which is

4based on AladinLite . Hovering with the mouse over the result rows will highlight the corresponding footprint on
the sky view. AladinLite is fully interactive (pan, zoom) and oers the possibility to select dierent backgroundlayers from the layers icon in the top left corner.

The skyview is directly linked to the results table so thatsubltering the results will immediately be reected in the displayed footprints and hovering over a given dataset
will highlight that dataset's footprint.
By clicking the "more columns" link in the top left portion of the table, a much larger number of column elds
can be added to the table. Three buttons on the top allow to quickly show all rows, to reset the default column
order, and to order the columns alphabetically. The browser's text search function (CTRL+F or Command+F)
can be used, too.
Columns above the red bar in the column selection window are displayed in the Results Table. They can be
dragged and dropped below or above the red bar or can be reordered. Also, the red bar itself can be dragged
and dropped. Finally, a checkbox in front of the column names makes it easy to quickly select or deselect anindividual column for display. There are many more columns available than are oered on the query interface
to keep the latter as clean as possible. Of particular interest might be the columns "Array" and "Mosaic" whichgive the ALMA array (12m, 7m, TP) and the pointing pattern, respectively.
As mentioned, the resulting rows can be further ltered by using the empty boxes in the top row of each column.
The Results Bookmark link in the top right of the page provides you with a link that will instantly re-executethe search of the results that are currently being viewed. This is helpful when you want to send the results of aquery to a colleague or just when you want to repeat the same query at a later period: As mentioned in section
3.1, the metadata of the observations are public as soon as those data have been observed. Therefore, at any
given time the results do indeed match the current state of the ALMA observations.

4 http://aladin.u-strasbg.fr/AladinLite

.
Figure 3.2:

The results of an archive query.

Each row entry has a footprint shown over a (selectable) sky

background. Hovering over the observation row will highlight the footprint of that observation.

You can also use the Export Table function to download the Results Table in VOTable (XML), CSV, or TSV
formats. In this case, the complete table is always returned.
A red background of the checkbox in the left-most column indicates that the data are still in their proprietary
period. In that case, the release date column provides an active link that you can use to add a reminder/event
to your calendar (e.g. Google, Live, Yahoo!, iCal) to notify you when the data reaches the end of its proprietary
period.
Data without an available checkbox in the left column is either in the process of acquiring more data or in theprocess of being reduced and quality controlled. In rare cases, users may nd and report problems with the datathat has been delivered to them. Also in this case no checkbox for download is presented on the interface andthe value in the Release date column is set to "In QA3" until the problem has been resolved.
One ALMA observation and thus one row in the Results table in "observation" display can have several Spectral
Windows (spw) that were observed simultaneously. Although the query constraints on frequencies (frequency,
bandwidth, spectral resolution) indeed do query against the values of the individual spectal windows in the ASA
database, when displaying, only the observations for which a matching spw have been found are shown. If you
hover with the mouse over the Frequency Support column, a summary of all the spw that have been observed
for the given observation is displayed.
Hovering over the project code link shows the full abstract of the proposal. It also displays the acknowledgement
using that project code which then can be copied and pasted into an publication. Indeed, it is ALMA policythat this statement including the correct data-link must be placed into all publications making use of ALMA
data (see also section 6).
The publication count number is an active link. Clicking on it will open an new browser tab with a new search
to the ALMA Science Archive for the publications related to the given project.

3.4 Selecting the les for download
You can select data available for download with the checkbox in the left-most column of the Results Table. To
select all available data for download, simply check the box at the top left of the table. Hitting the "Submit
download request" button starts the ALMA Request Handler (RH), which will open in a sepate tab or window(see Figure 3.3).

If at least some of the selected data are still in their proprietary period and if you are notalready authenticated, the RH will ask you to authenticate. Otherwise the Request Handler will immediately
display the list of tar les that can be downloaded. A green check mark indicates the les for which you haveaccess rights.

.
Figure 3.3: The results of a download request.

This query selects only one project.

Semipass data are notselected in the top boxes, so data having this status are not selected for download. You may opt only for raw
data or only for products.
If authenticated, you will receive an email notication with the content of your request. This email also contains
a link to the request in the RH. You might also decide to authenticate despite the fact that the data you would
like to download are all out of the proprietary period in case you want to come back to the request. Indeed, alist of all (authenticated) requests can be obtained by clicking on the "My requests" link in the top right cornerof the RH for authenticated users.
At this stage, you have the option of downloading the available data products as well as the associated raw data
via individual tar les separately via the selection boxes shown in Figure 3.3.

5

ALMA data do have quite a deep data hierarchy . In short: observations that can be observed and calibrated
together and independently are placed in a Member OUS (Observation Unit Set). Observations that have to be
combined from several Member OUSs are placed into the same Group OUS. This is done until all observationsof a Science Goal (corresponding to one Science Goal OUS) in the OT are distributed.
This hierarchy means that if you query and select data from a Member OUS, e.g. containing observations donewith the 12 m array, you might also be interested in observations from the same Group OUS containing the same

5 see e.g. Section 8.1. of http://almascience.org/documents-and-tools/cycle5/alma-technical-handbook

source but which potentially have been observed with the 7 m and/or TP array. Therefore, the RH expands all
selected data to show the complete Group OUSs.
Currently two types of les are available for download: les containing the data products (FITS les, quality assessment results, scripts, log les, calibration andagging tables).

 les containing the ALMA raw data (ALMA Science Data Model, ASDM)
The type of the le is indicated in the data hierarchy column.

In case you only want to have a look at the

products that have been created for the quality assessment, or if you only want to read the README le, only
the product le(s) have to be downloaded.
Data marked with "semipass" are data which may be useful, but are known to have issues which lead them tobe excluded from the creation of the data-products (e.g., missing calibrators, too little science data). The nameof the Scheduling Block that was used to aquire the data is shown to make it easier to understand which data
are contained in the products. We also oer the possibility to expand the entire list of source names containedin the products.
With the checkboxes on the top the dierent categories of products can be selected quickly. A auto-generated
readmele shows the data hierarchy, the SB and source names as well as the directory string to the MOUS which
can be copied and pasted directly into the shell for quick access to the data.
As mentioned before, there are three individual archives at the ARCs and thus three individual RHs available.
You can download data from any of the three ARCs. Note, however, that data requests are not transferrable. If
you want to download data from a dierent ARC you need to create a new request.

3.5 Downloading the data
ALMA data can be potentially very large. Although a single le can also be downloaded by right-clicking on thelink of the le and selecting "Save As .." from the browser menu, to assure ecient downloading and to makegood use of the available bandwidth for ALMA downloads, you should download ALMA data in several parallel
download streams.
After selecting the desired products/data for download and clicking the Download Selected button in the top-left
portion of the window, you are prompted with four dierent download methods:

 Download Script: A bash download script is created that can be directly run from the command line on
Linux and Mac.

 Download Manager: ALMA's download manager is launched as a browser applet, allowing for parallel
downloading that can be paused and resumed.

 Web Start Download Manager: ALMA's download manager is launched as a desktop application via JavaWeb Start. Accordingly, downloads will not stop if you close your browser.

 File List: A new page is opened containing a list of URLs for downloading the data that may be useful forthird-party download managers such as

DownThemAll.

The recommended method for downloading data is using the Download Script. This allows one to easily download
to computers that do not have web browsers available (e.g. processing environments). Save the script to yourLinux or Mac, add execute rights, run it, and then unpack the obtained tar les:chmod a+x downloadRequest12345.sh./downloadRequest12345.sh
for i in *.tar; do tar -xvf $i; done
Note, when downloading via the le list, please do not attempt to chop the download into pieces to make it faster!
This places a signicant load on the servers and may result in your downloads being throttled. For example, in
the Firefox plugin DownThemAll, make sure that the property "Max. Number of Segments Per Downloads" isset to 1. Likewise, it is easy to setup a download with more than 5 les in parallel, the archive limit. Pleaserefrain from doing this.

3.6 Data packaging
3.6.1

Directory structure

The data are streamed to the user as tar les which allows for the delivery of the ALMA data together with thecomplete directory structure following the ALMA data hierarchy.
The ALMA Archive currently has tarles for either products or "raw" data les (where raw is dened here as

6

post-correlation, but pre-calibration) in ASDM format . A typical package will unpack to a directory structurewith the rst three levels like:2012.1.01234.S/science_goal.uid___A001_X12345_X123/group.uid___A002_X6789ab_X6789/member.uid___A002_Xcdef1_X234/(Note that Cycle 0 data do not have the UIDs for the OUSes appended to the directory names.

Instead thedelivery date is appended to the member OUS directory name). In the member... directory there are the following
subdirectories:

calibrated calibration log product qa raw script
and a README le.
To unpackage the tarles rapidly you can set up a loop in bash:

for i in *.tar; do tar -xvf $i; doneor source the following C shell script if you are using tcsh or csh:#/bin/cshforeach i (*.tar)
tar -xvf $iend
The contents of the directories are as follows: The calibration directory contains calibration and ag tables.
 The log directory contains the CASA logs from running the reduction scripts/pipeline.
 The products directory contains the FITS images.
 The qa directory contains the QA2 reports (manual calibration) or the pipeline weblog (pipeline calibration).

 The script directory contains the reduction scripts.
 The contents of the raw and calibrated directories depend on whether the data were from Cycle 0 orfrom later Cycles (see below).

7

More details about the packaged QA2 products can be found in the data product guide .

6 These raw les are colloquially referred to as ASDMs, but ASDM strictly refers to the data model, not the le. The correct
designation is Execution Block (EB).
7 e.g.,http://almascience.org/documents-and-tools/cycle3/ALMAQA2Products3.0.pdf

3.6.2

Cycle 0

Cycle 0 was unique in that calibrated Measurement Sets (MS) were archived together with the data products.
The data for each Member OUS is combined into a set of tar les, the contents of which are linked from the

8

Science Portal . In particular, it is possible from these contents to see which tar les contain the image FITS
les for a given delivery.
Two MS were stored. The rst is a MS with the system temperature (Tsys ) and water vapour radiometer (WVR)
corrections applied. This is stored in the "raw" directory. The second is a fully calibrated MS, stored in the"calibrated" directory. Note that the raw ASDMs are not in the package, but are available from the ARCs uponrequest.

3.6.3

Cycle 1 and later

In Cycle 1 and later, calibrated MS are no longer included in the package.

If only the package tar le isdownloaded (the "product" le in the request handler listing), then the raw directory is not present. If tar lesof the raw data are downloaded, they will populate a raw directory when they are untarred. For the creation of
the calibrated MS see Chapter 5.

8 http://almascience.org/alma-data/archive/delivery-list

Chapter 4

Programmatic access
4.1 astroquery
The AQ has been developed so that it can be accessed programatically, i.e. from programs or scripts. Adam
Ginsburg has developed the external python tool

astroquery. Astroquery is a python package which allows querying and retrieving data from many large observatories including ALMA. Authentication support for the download of proprietary data is provided as well as the extractionof FITS les only for Cycle 0 data (see also section 3.6.2).
As a simple example, querying the ALMA Archive for the source M83 and retrieving all the corresponding data
is done by

from astroquery.alma import Alma
import numpy# Querying the ALMA Science Archive for source M83
result = Alma.query_object('M83')# Extracting a list of Member ObsUnitSets
member_ous = numpy.unique(result['Member ous id'])# Creating an ALMA astroquery instance and downloading all data the identified Member OUS
myAlma = Alma()
myAlma.cache_location = '/big/external/drive/'
myAlma.retrieve_data_from_uid(member_ous[0])At this stage, astroquery is the preferred way to query the ASA for a long list of sources. A full set of examples

on the usage of the package for ALMA data is available on the astroquery ALMA page (https://astroquery.

readthedocs.org/en/latest/alma/alma.html).

4.2 VOALMA is strongly committed to providing VO services for all ALMA data. The necessary Table Access Protocol

1 is in place and already now serves as backend for the Archive Query web interface. The(TAP) infrastructure

current plan is to allow for a search through the complete holdings based on the metadata in addition to ALMA
FITS products generated by the ALMA Pipeline. The preparative steps for this project are underway and the

1 using code from https://github.com/opencadc/tap

13

VO service ObsTAP is currently planned for 2018. A VO service for FITS products is expected to follow.

2

External providers oer VO services for the archived FITS products . Note that those products cover only asmall fraction of the total number of sources and available spectral range. As when viewing the products in thearchive, these FITS products are generated for quality assessment purposes and in most cases do not represent
the best, or even science-ready, products.

2 http://jvo.nao.ac.jp/portal/alma/archive.do, http://www.chivo.cl

Chapter 5

Scientic exploitation of the data
While in a few cases the FITS data-products that are provided by ALMA could be sucient to do science
directly, more often than not users should create their own images from the calibrated Measurement Set data
(MS). As mentioned above, for Cycle 0 the calibrated MS are directly delivered with the data packages. For
data later than Cycle 1, MS can be recreated from the raw data by running the command

execfile('scriptForPI.py')
within the version of CASA that was used to create the data (see the README le). The scriptF orP I.py lecan be found the script directory. The calibrated MS can then be found in the "calibrated" directory.

1 of the ALMA Science Portal for details. From there, you can follow the links

Please see the Processing section

to understand the contents of the data products; download and install CASA; download and install the ALMA
pipeline; and the hardware requirements for CASA and the pipeline.

2

CASA also provides guides related topipeline imaging reprocessing .
All users of the archive are welcome to request assistance with calibration and analysis through the ALMA
Helpdesk, and face-to-face visits to the ARCs are advisable when additional assistance is needed.

1 http://almascience.org/processing
2 https://casaguides.nrao.edu/index.php/ALMA_Imaging_Pipeline_Reprocessing
15

Chapter 6

Acknowledgement statement
All publications making use of ALMA data must include the following unaltered statement in the acknowledgement section:"This paper makes use of the following ALMA data: ADS/JAO.ALMA#2011.0.01234.S.
ALMA is a partnership of ESO (representing its member states), NSF (USA) and NINS
(Japan), together with NRC (Canada), NSC and ASIAA (Taiwan), and KASI (Republicof Korea), in cooperation with the Republic of Chile. The Joint ALMA Observatory is
operated by ESO, AUI/NRAO and NAOJ."
Please substitute the place-holder project code 2011.0.01234.S with the project code of the data used. Should
data from several projects have been used, please use the following notation: ADS/JAO.ALMA#2011.0.01234.S,
ADS/JAO.ALMA#2011.0.01235.S, ADS/JAO.ALMA#2011.0.01236.S.
In addition, publications from NA authors must include the standard NRAO acknowledgement:"The National Radio Astronomy Observatory is a facility of the National Science Foundation operated under cooperative agreement by Associated Universities, Inc."
Readers of the publication can enter either the full data tag or the project code into the "Project code" eld of
the ASA Query Interface (3.2) in order to obtain a list of the corresponding observations. We also use the data
tag to link the publications to the data in the archive which will allow the user to query for publications using
ALMA data in the ASA and also to show all publications related to the displayed data-rows.
If referring to sources detected for rst time in ALMA elds you should follow one of the options of the naming
convention
ALMA JHHMMSS.s+DDMMSSALMA JHHMMSS.ss+DDMMSS.s
ALMA JHHMMSS.sss+DDMMSS.ss
ALMA JHHMMSS.ssss+DDMMSS.sss(approved by IAU "Clearing House" of Commission 5 Working Group on Designations), where J indicates J2000
coordinates.
The coordinates should be truncated according to the precision in the position of the source.

Typically thisshould be approximately 1/10th of the size of the synthesized beam used in the discovery observation, e.g.
for a 1" beam, declination should be given to a precision of 0.1" of arc and RA to 0.01s of time (ALMAJHHMMSS.ss+/-DDMMSS.s), for a 0.1" beam declination to 0.01" of arc and RA to 0.001s of time (ALMAJHHMMSS.sss+/-DDMMSS.ss) etc.

17Chapter 7

Frequently asked questions
Please refer to the FAQ/Knowledgebase in the ALMA Science Portal for the answers to frequently asked ques-

tions: https://help.almascience.org/index.php?/Knowledgebase/List/Index/4/archive--data-retrieval
Please do not hesitate to contact us through the ALMA Helpdesk in case you have questions, comments orsuggestions.

19