Tutorial

Tutorial for the SAGA database Retrieval subsystem

This version of tutorial is obsolete. To be updated soon.

This tutorial explains the meanings of the options and columns displayed on the retrieval subsystem and shows how it works.

Top page

  • A-1: Date of last update of the SAGA database in JST
  • A-2: Button for executing search
  • A-3: Button for setting search example (currently not working)
  • A-4: Button for reset the form
  • B-1: Option to plot on 2D diagram or histogram
  • B-2: Bin width of the histogram (works only for Histogram option in B-1)
  • B-3: Range of values of the histogram (works only for Histogram option in B-1)
  • B-4: Category / Unit of the axis for plot as shown below
  • B-5: Quantity / Element of the axis
  • B-6: Quantity in text format. [Fe/H], [C/Fe], [C/N], … any combinations of [X/Y ] are supported.
  • B-7: Allowed range of quantity. Set blank if unset.
  • B-8: Options to choose if include/exclude the data with upper limit.
  • B-9: Options to show/hide error bars on the plot
  • C-1: Search by object name. “HE0107-5240”, “CS”, “0107”, etc are allowed.
  • C-2: Subtract binary stars with the range of binary period.
  • C-3: Criterion on the photometric magnitude. Choose photometric band and range.
  • C-4: Criterion on the wavelength resolution.
  • D-1: Search by author.
    • Family Name, Given Name or Initial Middle Name or Initial: Given Name and Middle Name can be omitted.
    • First author search by “^”.
    • All the names and initials are case insensitive.
    • Given name and middle name can be connected by hyphen.
  • D-2: Bibliographic search to include data
    • Format is “Journal, Volume, Page, Year”.
    • Any criterion can be omitted.
  • D-3: Bibliographic search to exclude data
  • D-4: Criterion to choose a journal.
  • D-5: Criterion on the published year of original journal.
  • E-1: Cross search option. Choose if the combination of data across papers is allowed or not.
    • same paper: allow to retrieve data for X and Y axis only from the same paper
    • any combination: allow to retrieve data for X and Y axis from any combinations of papers
    • plot one: plot only one data if more than one data are available with the same paper option
  • E-2: If yes, select data only from the abundances with the adopted solar abundances are provided. Otherwise, all the data are targets to search.
  • E-3: Reference solar abundances. Abundances are converted using the reference solar abundances.
  • E-4: How to choose the representative values if two or more data are available from the literature.
    • mean: mean of all the available data
    • median: median of all the available data
    • subject to priority parameter: data to plot is selected by the criteria.
  • E-5: Number of display per result page.
  • E-6: Check to display items
    • Plot data: data plot and download files
    • Output text data: download link to text format for selected data
    • Output search result: data table to provide links to data
    • Output data comment: additional comment on reference in the numerical data
         C-rich : [C/Fe] > 0.7
         RGB : Teff < 6000 and log g < 3.5
         EMP : [Fe/H] < -2.5
         CEMP-s : C-rich and EMP and [Ba/Fe] ≥ 0.5
         CEMP-no : C-rich and EMP and [Ba/Fe] < 0.5
  • E-1: Cross search option. Choose if the combination of data across papers is allowed or not.

Search Result

  • A-1: Plot data for objects with selected checkboxes
  • A-2: Destroy all internal set-ups and go to top page
  • A-3: Reset the form
  • A-4: Plot data for all objects retrieved
  • A-5: Show previous/next page
  • A-6: Change the page. The current page is shown by green button.
  • B-1: ID for object
  • B-2: Tick all the checkboxes in the current list
  • B-3: Add to plot list for the object
  • B-4: Object name group by references. Each object has a link to the page to see more info. of the object.
  • B-5: Reference code. Each reference code has a link to the page to see more info. of the paper.
  • B-6: Metallicity, Effective temperature, and Surface gravity of the object adopted by the paper.
  • B-7: Values of X-axis, Y-axis, and criterion axis derived by the paper.
  • B-8: Choose the dataset for derived values for X- and Y-axis. It is allowed that users can plot one data set for single object.

Data plot

  • A-1: Plotted data are automatically classified into categories according to the following criteria.
    • EMP: stars with [Fe/H] ⇐ -2.5. Although the value of [Fe/H] depends on the observations, it is simply taken from the data in the most recent published paper, the largest resolution for observing set ups, and the smallest error bars. Fe I is preferably adopted for identical paper.
    • C-rich: stars with [C/Fe] > 0.7. The selection condition of the data is the same as for EMP. “CEMP” means “C-rich” and “EMP”.
    • RGB: stars with Teff < 6000 K and log g < 3.5. Otherwise, the star is classified as “MS”.
    • CEMP-s: stars that satisfy C-rich and EMP criteria and [Ba/Fe] ≥ 0.5.
    • CEMP-no: stars that satisfy C-rich and EMP criteria and [Ba/Fe] < 0.5.
  • A-2: Number of plotted data (top) and Pearson coefficient for plotted data (bottom). In calculating the coefficient, data with upper limit are excluded.
  • A-3: Arrows show the upper limits for derived values.
  • A-4: Panel is the clickable map. Each plotted data has a link to the page to see more info. of the object.
  • B-1: Set title of the figure
  • B-2: Specify the position of the legend or unset the legend
  • B-3: Set labels for X- and Y-axis.
  • B-4: Set the scale of the figure in linear or log
  • B-5: Set the range of values. Use “*” for automatic scale.
  • B-6: Include or exclude the data with upper limits. Currently it is not working.
  • C-1: Replot the data
  • C-2: Reset the form
  • C-3: Delete all the list of plotted data
  • C-4: Destroy all internal set-ups and go to top page
  • D-2: Links to the current figures in different format
  • D-3: Button to download all the data and script to reproduce the figure.