Global Madrigal database report

The Global Madrigal database report is designed to allow searches of the entire local Madrigal Database at once, rather than on only one experiment at a time.These searches can be based on characteristics of the experiment, such as instrument, date, or experiment name, and in addition, can depend on the actual data, such as, whether the ion temperature was above a certain level. This report outputs data in ascii format. This tutorial describes the various way you can select what part of the Madrigal database you want to download. Do do a global search for another Madrigal site, you need to navigate to that site first - this web page only returns data from the local Madrigal site.

This page is meant to be used is conjunction with one of the remote API's: either python, Matlab, or IDL. It will generate commands that you can run from your own local computer using one of these API's to run this search. It is also possible to run the search on the Madrigal server itself, but this is less robust because the amount of data you can request may be limited by server capacity.

Select instrument(s)

This filter allows you to select the instruments you are interested in. You have the option to select more than one instrument.

Experiment dates

This lets you enter the time period you would like to search. It defaults to Jan 1, 1950 to the end of the present year

Show individual filenames in report

Select this to include the name of the individual files just before their data in the report. If not selected, only the data will be included.

Global search web page

Select parameters to display

Use this button to select a list of parameters to be shown in your report. After selecting parameters, you'll be returned to this page, and the parameters you selected will be displayed. UT1, the absolute time is selected by default, but you can always deselect it.

Advanced filters

The following filters are available only if you click the Show advanced filters checkbox.

Select kind(s) of data

This is a filter that lets you select the kinds of data you would like to search with a particular instrument. A "kind of data" is defined individually at each Madrigal site, and describes the way the raw data was processed to derived the particular Madrigal file. If more than one instrument is selected, a list of the kinds of data for those instruments would be displayed. You can then select which kinds of data you need to in your search. If you don't know which kinds of data to select, simply select them all..

Select seasonal filter

This filter lets you search through the database in a seasonal or monthly manner. For example, if you need to search for data during the spring time, you enter 3/21 and 6/21 in the start and end date input boxes, respectively. You would then get all experiments between 3/21 and 6/21 that were also in the overall date range entered above. Similarly, if you are only interested in data from November, just enter 11/1 and 11/31, respectively, in the start and end date input boxes. If you do not need this option as a criterion for your search, you can ignore it, since the default will search through the entire year.

Enter complete or partial experiment name

If you want to filter experiments based on experiment name, enter the name of the experiment or partial name. This name-based search is not case sensitive, and you have the option of leaving it blank to get all experiment names.

Select parameters and set up filters

Select parameter(s) to display

Global search advanced options

Set up filters using any Madrigal parameter(s)

Use these parameter filters to apply any filter you want to the data. It doesn't matter whether the parameter is measured (that is, read directly from the file), or derived - any parameter(s) that can be selected for display can be used for a filter. The filters look like the following:

These filters work as follows: The first filter implies "gdalt - sdwht" must be greater than 0.0. Since sdwht is shadow height (the distance above any point on the earth where the sun is first visible), this filter implies that only data in direct sunlight will be displayed. The second filter says that BMAG (the magnitude of the magnetic field) must be between 0 and 3e-5 Tesla. Note that the meaning and units of any parameter are available by clicking on them. You'll need to leave spaces between parameters and operators because some parameter names include "+".

Note that the filter can be based on any single parameter (such as BMAG above), or any two parameters either added, subtracted, multiplied, or divided (as in the "gdalt - sdwht" example above). Leaving either the lower limit or the upper limit blank means there will be either no lower limit or no upper limit. Leaving both blank means the filter is ignored. Note that if the parameter you enter is missing or cannot be calculated, it will be rejected no matter what the range is, since missing data is never in any range.

Continue button

When you select Continue, you will see a summary of all the filter parameters you selected. You can then return to this page to modify any selection, or generate the search command using your API of choice.

Mnemonic (or Mnem1 +,-,*,/ Mnem2) (example: gdalt or gdalt - sdwht) Leave spaces between mnemonics and operator	Lower limit (leave blank if none)	Upper limit (leave blank if none)