listsmfs

Go back up.

listsmf.php is a tool that may be used to retrieve certain information about SMF files from the IPP database.
The url of the tool is http://misc.ipp.ifa.hawaii.edu/listsmfs.php

The list returned is controlled by parameters supplied as part of the http request used to access the page. By default listsmfs displays the list of smfs corresponding to the PS1 science exposures collected on the current date (UTC). The output may be fine tuned using parameters. The use of parameters is discussed below.

Here is some sample output.

#cam_id smf_name                           quality state   exp_name    label                release        filter      obs_date   obs_time  comment
1783121 o7622g0062o.1134677.cm.1783121.smf       0 full    o7622g0062o OSS.nightlyscience   SSS.nightly    i.00000     2016-08-22 07:43:12  'OSSR.R19S6.16.Q.i ps1_32_2599 visit 1'
1783120 o7622g0061o.1134678.cm.1783120.smf       0 full    o7622g0061o OSS.nightlyscience   SSS.nightly    i.00000     2016-08-22 07:42:16  'OSSR.R19S6.16.Q.i ps1_32_2493 visit 1'
1783122 o7622g0063o.1134679.cm.1783122.smf       0 full    o7622g0063o OSS.nightlyscience   SSS.nightly    i.00000     2016-08-22 07:44:08  'OSSR.R19S6.16.Q.i ps1_32_2614 visit 1'
... and so on.

The first line, which begins with the "comment" character '#', is a header line. This line lists the names of the columns shown in the subsequent lines.

If no exposures are found that match the supplied parameters (and their defaults) only the header line is displayed.

The first 4 columns are the most important. They are very useful for constructing requests to retrieve individual SMFs using getsmf.php.

List of Columns

cam_id

The IPP camera run identifier.

smf_name

The base name of the SMF file for the exposure (if any).

quality

The quality value for the camera processing. A non-zero value indicates a problem with the processing. For example: unsuccessful astrometric solution. In the event of a run with non zero quality no SMF file will be available.

state

The current state of the camera run. Runs that have completed processing will have the state "full". SMF files will not be available for runs with any state other than full. Runs with state "new" may finish processing at a later time.

exp_name

The exposure name of the source exposure. (Also known as "Frame Name" in PSPS and other contexts.)

label

The processing label for the camRun.

release

The Release that contains the exposures. Examples might be 3PI.nightly or SSS.nightly. If the exposure has not been assigned to a release this column will have the value "none".

filter

The filter used by the camera for the exposure.

obs_date

Date of the observation (UTC).

obs_time

Time of the observation (UTC).

comment

The comment string for the exposure. Note that single quote characters have been added around the comment string as delimiters to facilitate parsing.

Parameters

As mentioned above, listsmfs gives a list of the exposures for the current (UTC) day by default. Parameters may be used to control the selection. Parameters are provided by appending an HTML query string to the request URL.

For example the sample output shown above was generated by a request with the parameter string '?release=SSS.nightly' appended to the URL (on the date that this page was written of course).

If multiple parameters are to be supplied they should be separated by a '&' character. For example '?release=SSS.nightly&filter=r' would list exposures with the named release in the r band filter..

Here is the list of the parameters.

date_min and date_max

The date/time limits for observations to be included by the listing. The format for the datetime is

    YYYY-MM-DDTHH:MM:SS

where the '-', 'T', and ':' characters are literal and the other characters are numeric values for year, month, day, hours, minutes, and seconds.

For example 'date_min=2016-08-22T08:00:00&date_max=2016-08-22T09:00:00' would select exposures observed between 0800 UTC and before 0900 UTC on Augst 22.

Notes on date limits.

The time portion may be omitted. For example the parameter pair 'date_min=2016-08-21&date_max=2016-08-22' will cause all exposures observed on 2016-08-21 or 2016-08-22 to be listed.

If date_min is not supplied, any date_max value supplied is silently ignored. Instead page uses the defaults for the date parameter: exposures for the current date are listed (if any).

filter

Only exposures with the corresponding filter are listed. If a single character value is supplied for filter, exposures from all filters that begin with that letter are listed.

label

The list is restricted to camRuns with the supplied label.

release

The list is restrictred to exposures with supplied release name.

data_group

The list is restrictred to camRuns with the supplied data group. Note: This parameter is expected to be rarely used.