You must be logged in to download files
Please login or register using the form at the top right of the page
The security code was invalid
Please re-enter the security code and try again
The AMPERE Web Services API allows you to request AMPERE data in netCDF file directly from the website without having to download individual files. It is designed to be integrated into data analysis applications. The interface consists of three end points that provide access to the raw, filtered magnetometer data (rawdB), the raw filtered magnetometer data, binned into 10-minute windows (IRD) and the final fitted, 10-minute windowed data (GRD). The end points consist of PHP scripts that are called by constructing a URL that points to the script that includes the parameters of the data the user is requesting. The scripts respond by returning a netCDF that contains the requested data.
Users of the interface are required to be registered at the AMPERE web site. The interface is designed for downloading moderate amounts of data (up to 1 week, per request), if you intend to download large volumes of data, please contact us directly. The interface can be called from the UNIX command line using the curl command or an equivalent (replace <USERNAME> with your username):
curl "https://ampere.jhuapl.edu/services/data-rawdB.php?logon=<USERNAME>&start=2022-02-04T0:00&extent=604800" > rawdB.nc
curl "https://ampere.jhuapl.edu/services/data-grd.php?logon=<USERNAME>&start=2012-01-03T12:00&end=2012-01-03T14:00&pole=north" > north.nc
curl "https://ampere.jhuapl.edu/services/data-ird.php?logon=<USERNAME>&start=@1486098000&extent=3600&pole=south" > south.ird.nc
The three end points all take the same arguments:
Parameter | Definition |
---|---|
logon | The AMPERE website registered user identifier |
start | Start time of interval to request |
end | End time of interval to request |
extent | Extent to request (instead of specifying an end time) |
pole | Northern or Southern Hemisphere |
The format of the URLs for the three end points are as follows:
https://ampere.jhuapl.edu/services/data-rawdB.php?logon=<USERNAME>&start=<TIMESPEC>&end=<TIMESPEC>
https://ampere.jhuapl.edu/services/data-ird.php?logon=<USERNAME>&start=<TIMESPEC>&end=<TIMESPEC>&pole=<HEMISPHERE>
https://ampere.jhuapl.edu/services/data-grd.php?logon=<USERNAME>&start=<TIMESPEC>&end=<TIMESPEC>&pole=<HEMISPHERE>
https://ampere.jhuapl.edu/services/data-rawdB.php?logon=<USERNAME>&start=<TIMESPEC>&extent=<SECONDS>
https://ampere.jhuapl.edu/services/data-ird.php?logon=<USERNAME>&start=<TIMESPEC>&extent=<SECONDS>&pole=<HEMISPHERE>
https://ampere.jhuapl.edu/services/data-grd.php?logon=<USERNAME>&start=<TIMESPEC>&extent=<SECONDS>&pole=<HEMISPHERE>
The time and date are defined as shown using “start=<TIMESPEC>”. You can either define an extent in seconds like this “extent=<SECONDS>” or an end time using “end=<TIMESPEC>”. The start and end <TIMESPEC> parameters can either be in “YYYY-MM-DDTHH:MM” format or in seconds of UNIX epoch by putting an “@” at the front of the time, eg “@1486098000”. The value of the pole parameter can be either "north" or "south". If successful the service will return a netCDF file containing the requested data. If an error occurs, the string “ERROR” is returned, followed by text indicating the type of error.