Mission Overview
The Hubble Advanced Spectral Products (HASP) program provides co-added spectra within individual observing programs that use the Space Telescope Imaging Spectrograph (STIS) and the Cosmic Origins Spectrograph (COS) aboard the Hubble Space Telescope (HST). HASP products are automatically generated for new observations and updated for new calibrations.
The Hubble Spectroscopic Legacy Archive (HSLA) performs two additional steps. First, it combines data from multiple observing programs, instruments, and gratings to create spectral products with the highest possible signal-to-noise ratio and wavelength coverage. Second, it performs automatic target classification, enabling searches based on object classification as well as by target name.
Overview
While HASP provides visit-level and program-level coadds of 1-D spectra for both COS and STIS, the HSLA combines data from multiple observing programs into a single spectrum for each target in the MAST archive. It then assigns a target classification to each object.
For a given target, the software first creates separate spectra for each combination of instrument, grating, and (for COS) lifetime position. The COS spectra from multiple lifetime positions are combined into separate spectra for each grating. Finally, the COS and STIS spectra are spliced together (not co-added) to span the full available wavelength range for each target.
The software then performs an automatic hierarchical object classification based on classifications from SIMBAD, NED and Phase II information. This enables searches based on object classification as well as by target name: see the full list of HSLA classification tiers.
The project provides a publicly available Python script and Jupyter Notebooks to enable custom coaddition by the community.
History: Between 2016 and 2018, the original HSLA provided combined spectra for all publicly-available COS data (Peeples et al. 2017), but that effort required considerable human intervention to create the data products. It did not include new data obtained after 2018, nor were the coadded products updated with the latest calibration products. The new HSLA is fully automated and updates the spectrum of each target whenever it is re-observed or there are updates to the calibration.
Data Access
While HSLA data products are available on a variety of platforms, different tools work best in different situations. If you are interested in retrieving the HSLA files for a handful of objects, then both the HST Search Form and the MAST Portal are good choices. If you would like to retrieve an entire class of objects (but not an enormous list – say, all the DA white dwarfs), then either the MAST Portal or astroquery will do the job. For bulk downloads (all stars in the archive, for example), astroquery is recommended, as the interactive tools can be unwieldy.
Want tips on using the search forms? See the example searches page.
-
The HST Search Form in MAST

HSLA products are now available in the HST search form. As part of the default products available for download, you'll now see new, HSLA-generated cspec.fits files.
-
astroquery: example notebook

A streamlined interface for Python users to access data in MAST. As HSLA data is now included in MAST, these files are available through the astroquery API. The jupyter notebook tutorial "Introduction to the HSLA Data Products and Tools" will guide you through an example query.
-
MAST Portal

Using an advanced search, set "Project" to HSLA to see only results from this collection. You can also add the "target classification" field to search on the type of target.
Spectra
Example HSLA coadd spectra are presented below.
Top: The region near 950 Å shows several ISM features.
Bottom: ISM Si and photospheric C lines are seen in a high SNR region of the FUV spectrum near 1300 Å, obtained by combining dozens of individual observations of this flux-calibration standard. Residual O I airglow lines are present around 1301 and 1306 Å.
Data Products
File Naming Conventions
Abutted co-add files follow the format:
hst_<instrument>_<target>_<opt_elem>_aspec.fits
Configuration-level co-add files follow a similar format:
hst_<instrument>_<target>_<opt_elem>-<lp_num>_cspec.fits
where:
- <instrument> is the instrument used (one of COS, STIS, OR COS-STIS)
- <target> is the target of the observation, e.g. "NGC5457"
- <opt_elem> is the optical element (i.e. filter or grating), e.g. "G140L"
- <lp_num> is the lifetime position (COS only)
Abutted Spectra
Data are combined into the final, abutted spectrum according to the following set of priorities:
| Priority | Grating | Initial Wavelength (Å) | Final Wavelength (Å) |
|---|---|---|---|
| 1 | STIS_E140H | 1141.1 | 1687.9 |
| 2 | STIS_E230H | 1629.0 | 3156.0 |
| 3 | STIS_E140M | 1141.1 | 1727.2 |
| 4 | COS_G130M | 900.0 | 1470.0 |
| 5 | COS_G160M | 1342.0 | 1800.0 |
| 6 | COS_E230M | 1606.7 | 3119.2 |
| 7 | COS_G185M | 1664.0 | 2134.0 |
| 8 | COS_G285M | 2474.0 | 3221.0 |
| 9 | COS_G225M | 2069.0 | 2526.0 |
| 10 | STIS_G140M | 1145.1 | 1741.9 |
| 11 | STIS_G230M | 1641.8 | 3098.2 |
| 12 | STIS_G430M | 3021.9 | 5610.1 |
| 13 | STIS_G750M | 5464.6 | 10645.1 |
| 14 | COS_G230L | 1650.0 | 3200.0 |
| 15 | COS_G140L | 901.0 | 2150.0 |
| 16 | STIS_G230MB | 1635.0 | 3184.5 |
| 17 | STIS_G140L | 1138.4 | 1716.4 |
| 18 | STIS_G230L | 1582.0 | 3158.7 |
| 19 | STIS_G430L | 2895.9 | 5704.4 |
| 20 | STIS_G230LB | 1667.1 | 3071.6 |
| 21 | STIS_G750L | 5261.3 | 10252.3 |
File Structure
The HSLA co-added products are stored as FITS files with two BINTABLE extensions: a science extension containing specific information about the combined product and a provenance extension recording attributes of each spectrum contributing to the combination. An additional ASCII-format metadata file is produced for each target.
Science Extension Table
The Science extension table stores data elements of a single spectrum:
| Keyword | Units | Type |
|---|---|---|
| WAVELENGTH | Angstrom | single-precision float |
| FLUX | erg/cm2/s/Angstrom | single-precision float |
| ERROR | erg/cm2/s/Angstrom | single-precision float |
| SNR | --- | single-precision float |
| EFF_EXPTIME | s | single-precision float |
Provenance Table
The provenance table contains metadata from the headers of contributing spectra.
| Keyword | Units | Type | Description |
|---|---|---|---|
| FILENAME | -- | string | Input spectrum filename |
| EXPNAME | -- | string | Exposure name, if multiple spectra per file |
| PROPOSID | -- | string | Proposal ID |
| TELESCOPE | -- | string | Observatory |
| INSTRUMENT | -- | string | Instrument |
| DETECTOR | -- | string | Instrument detector |
| DISPERSER | -- | string | Grating |
| CENWAVE | -- | string | Central wavelength of grating |
| APERTURE | -- | string | Aperture selected |
| LIFE_ADJ | -- | string | Lifetime position (for COS) |
| SPECRES | -- | double-precision float | Estimated spectral resolution |
| CAL_VER | -- | string | Calibration version |
| MJD_BEG | d | double-precision float | Exposure start time (MJD) |
| MJD_MID | d | double-precision float | Exposure mid-point (MJD) |
| MJD_END | d | double-precision float | Exposure end time (MJD) |
| XPOSURE | s | double-precision float | Exposure time |
| MINWAVE | Angstrom | double-precision float | Minimum wavelength |
| MAXWAVE | Angstrom | double-precision float | Maximum wavelength |
Metadata File
Here is an example of the information contained in the ASCII metadata file for the star AvZ 261:
| Target Information | Details | ||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
TARGNAME: AzV 261 HSLA_CAT: azv261--0099 RA (2000): 1 00 58.72 DEC (2000): -72 30 50.23 SIMBAD: AzV 261 NED: WISEA J010058.75-723050.3 PHASE II: AV-261; AV261; AZV-261 |
Names retrieved during target-association step | ||||||||||||||||||||||||||||||
|
PHASE II KEYWORDS: B0-B2 III-I; BE; EXT-STAR; STAR; SUPERGIANT O PRIMARY CLASSIFICATION: Star SECONDARY CLASSIFICATION: Emission line star TERTIARY CLASSIFICATION: Emission line star CLASSIFICATION SOURCE: SIMBAD UAT EQUIVALENT: Emission line stars (460) RADIAL VELOCITY: 158.0 km / s |
Target classification(s) | ||||||||||||||||||||||||||||||
|
PROPOSAL IDS: 11625; 16230; 16368
|
From aspec.fits header (instrument, grating, lifetime position, minimum and maximum wavelength) |
Notebooks
The HASP and HSLA project releases are accompanied by a set of user-friendly Jupyter Notebooks that enable users to perform custom coadditions for specific use cases not supported by the automatic coadds. These Notebooks were developed to aid in setting up and running the coadd script and creating custom coadd products.
- Setup
- Introduction to the HSLA Data Products and Tools
- Combining COS Data from Multiple Lifetime Positions and Central Wavelengths
Please see the Coadd Tutorial, Flux Scaling Tutorial, and Data Diagnostics notebooks on the HASP homepage.
Caveats
Datasets with the following properties are not included in HSLA coadd data products:
Observing Issues
- Guide star acquisition failues
- Observatory or detector failure events
- EXPFLAG (exposure data quality flag) header keyword set to anything other than 'NORMAL'
- EXPTIME (exptime) is zero seconds
- Actual exposure time is less than 80% of the planned exposure time
- FGSLOCK (fine guidance system lock) is not 'FINE', i.e. guide star tracking was not locked
- The shutter was closed, denoted by the Take Data Flag (TDF)
- Data flagged with bad archive data quality (resulted from filed alertobs)
Observation Parameters
-
POSTARG1 ≠ 0.0, i.e., there is a pointing offset
-
POSTARG2 ≠ 0.0 AND P!_PURPS ≠ 'DITHER', i.e., there is a pointing offset not in the dispersion direction
-
PATTERN1 = STIS-PERP-TO-SLIT and P1_FRAME = POS-TARG, i.e. there is a cross-dispersion direction pointing pattern (STIS only)
-
P1_PURPS = MOSAIC, i.e., there is a pointing mosaic offset pattern (STIS only)
-
OPT_ELEM (grating) = PRISM (STIS only)
-
APERTURE = BOA (Bright Object Aperture, COS only)
Target Parameters
- Moving targets
- Variable (Not deliberately rejected, but some exposures may be removed by the code's flux-checking routine)
Coadded data products are derived from standard pipeline .x1d observations. As such, additional reduction steps (defringing, echelle blaze shifts, etc.) are not performed. Users must generate custom coadds to address issues not corrected by the standard COS and STIS pipelines.
Because the final products of the HSLA (called “abutted spectra”) are constructed by piecing together spectra from multiple instruments and gratings, their resolution, wavelength per pixel, and S/N ratio may change discontinuously. Note that the COS line-spread function (LSF) varies with both central wavelength and lifetime position. Because both HASP and HSLA co-add spectra from multiple CENWAVEs and LPs, the final spectra may have LSFs that differ from the tabulated values. See the LSF Jupyter Notebook (below) for details. The STIS LSF also varies with wavelength, but much more slowly than the COS LSF. More important for STIS is the variation in LSF with aperture. The narrow apertures exclude the wings of the LSF, which are prominent in spectra taken with wide apertures. If your science requires the precise analysis of subtle features in high S/N spectra, consider using the intermediate data products provided by the HSLA, rather than the final abutted spectra.
Performance Evaluation
To ensure the flux and wavelength accuracy of our data products, we performed a series of tests comparing each coadded spectrum with its component x1d datasets. We used the analysis software developed for HASP and described in the HASP ISR (Debes et al. 2024). To test the flux accuracy, each x1d spectrum was filtered to remove pixels with serious data-quality flags, binned into 20 wavelength bins, and compared with the similarly prepared coadded spectrum. We considered only wavelength bins with S/N > 20 and only x1d spectra with at least five such wavelength bins. For each wavelength bin, we computed the residual r = (Fx1d - Fcoadd) / Fcoadd. We found that both the mean and standard deviation of the residuals are less than 0.05 for more than 96% of x1d spectra with S/N sufficient to make the comparison. The wavelength accuracy was assessed by cross-correlating the prepared (unbinned) coadded and x1d spectra; we considered only the high S/N spectra described above. Nearly 98% of spectra yield wavelength offsets of less than 1 pixel. Both the flux and wavelength tests substantially exceed the benchmark success rate of 75%.
To characterize the flux-calibration accuracy of the HSLA data products, we examined the residuals between coadded spectra of standard WDs and their synthetic models. We focused on three standards, G191-B2B, GD71, and WD0308-565, which together span all COS and STIS modes. For each standard star and observing mode, we checked the flux-calibration accuracy by comparing the observed spectra in the HSLA “cspec” files with high-fidelity synthetic model spectra from the CALSPEC database. Across all the targets and modes, most of the residual means are less than 1%, and the residual standard deviations have a median of 2.3%. Based on these results we conclude that the HSLA cspec spectra retain the absolute flux-calibration accuracy of 5% of individual observations and have a relative accuracy of 2.3%, only slightly lower than for individual observations. Figure 3 shows the HSLA quick-look spectrum (stored in the “aspec.fits” file) of GD71 overlaid on the corresponding CALSPEC model.
To test the accuracy of our target associations (identifying multiple observations of the same target) and target classifications (star, galaxy, etc.), we conducted a survey of 100 randomly selected HSLA targets. We found that the accuracy of the target associations and coordinates was 98%, while the accuracy of the classifications and naming was 92%. Most classification and naming failures occurred when a structure within a spatially resolved galaxy was the target and SIMBAD lists multiple unique objects within 2" of that target. Users should exercise caution when using HSLA products for objects for which multiple unique SIMBAD or NED objects lie within 2".
Citations
If you are using HSLA data in a published work, please cite the following paper: Instrument Science Report COS 2025.
Also, please include the following acknowledgment in all publications that make use of HSLA data:
Based on observations obtained with the NASA/ESA Hubble Space Telescope, retrieved from the Mikulski Archive for Space Telescopes (MAST) at the Space Telescope Science Institute (STScI). STScI is operated by the Association of Universities for Research in Astronomy, Inc. under NASA contract NAS 5-26555.
References
Instrument Science Report COS 2025: The HSLA Program. This is the primary reference for the HSLA program; it should be cited in any papers using HSLA data.
Questions about HSLA? For the fastest response, please visit the HST Help Desk Website.

