getExperiments.py is a script run to return a text output of selected experiments data.

It is presently used by the madmatlab methods getExperiments, and via the cgi script getExperimentsService.py the madmatlab method getExperimentsWeb. It has the following input arguments:

--code=<instrument code> (integer) - more than one allowed; 0 indicates all instruments (default)

--startyear=<year>

--startmonth=<month> (1-12) (defaults to 1)

--startday=<day> (1-31) (defaults to 1)

--starthour=<hour> (0-24)(defaults to 0)

--startmin=<min> (0-59)(defaults to 0)

--startsec=<sec> (0-61)(defaults to 0)

--endyear=<year>

--endmonth=<month> (1-12) (defaults to 12)

--endday=<day> (1-31) (defaults to 31)

--endhour=<hour> (0-24) (defaults to 23)

--endmin=<min> (0-59) (defaults to 59)

--endsec=<sec> (0-61) (defaults to 59)

--local=<1 or 0> - if 1, return local experiments only, otherwise, return all. Defaults to local.

--trusted=<0 if not, 1 if is> (default to not trusted). If not trusted, skips private experiments

If no code given, all instruments assumed. If no startyear given, starttime filter not used. If no endyear given, no endtime filter used.

Returns comma-delimited data, one line for each experiment, with the following fields:

1. experiment.id (int) Example: 10000111

2. experiment.url (string) Example: http://www.haystack.mit.edu/cgi-bin/madtoc/1997/mlh/03dec97

3. experiment.name (string) Example: Wide Latitude Substorm Study

4. experiment.siteid (int) Example: 1

5. experiment.sitename (string) Example: Millstone Hill Observatory

6. experiment.instcode (int) Code of instrument. Example: 30

7. experiment.instname (string) Instrument name. Example: Millstone Hill Incoherent Scatter Radar

8. experiment.start year (int) year of experiment start

9. experiment.start month (int) month of experiment start

10. experiment.start day (int) day of experiment start

11. experiment.start hour (int) hour of experiment start

12. experiment.start minute (int) min of experiment start

13. experiment.start second (int) sec of experiment start

14. experiment.end year (int) year of experiment end

15. experiment.end month (int) month of experiment end

16. experiment.end day (int) day of experiment end

17. experiment.end hour (int) hour of experiment end

18. experiment.end minute (int) min of experiment end

19. experiment.end second (int) sec of experiment end

20. experiment.isLocal (int) 1 if local, 0 if not

This script, and the corresponding cgi script getExperimentsService.py are available to any scripting language that wants to access Madrigal metadata.