PFS Pointing Simulation
The total exposure time required for a target list can be estimated using the online PFS Pointing Planner (PPP).
The online PPP will simulate the pointing after the validation of the input target list. The procedure is briefly listed below:
- Create a weight map on the sky for the input objects by using coordinates and priorities.
- Pick a density peak with the highest weight and assign PFS fibers using the netflow algorithm.
- Repeat 1 and 2 until all input targets are completed or the running time exceeds about 15 minutes.
Note
Please be aware that the online PPP only simulates the classical-mode observation without sharing fibers with other programs. We advise users to consider the results as a statistical reference. The final pointing coordinates and fiber assignments after sharing fibers may differ from the simulated results provided here.
Run the online PPP
Execute the online PPP
- Press the Simulate button in the sidebar to run the online PPP.
- The running time ranges from a few minutes to hours depending on the input target list. To save computational resources, the online PPP will stop if the running time exceeds 15 minutes. Please prevent uploading a huge list.
- In the case of the example file shown in the Inputs section, the computational time would be about 10 seconds.
Different observation types
- Queue type (default): the online PPP will run to automatically determine pointings with a fixed individual exposure time of 900 seconds
-
Classical type: the online PPP can accept a custom individual exposure time and/or pointing list from the
Config
tab in the side panel- Mandatory fields of the custom pointing list are listed below. An example can be seen here.
Name Datatype Unit Description ppc_ra float degree Right Ascension (J2000.0 or ICRS at the epoch of 2000.0) ppc_dec float degree Declination (J2000.0 or ICRS at the epoch of 2000.0) ppc_resolution str Grating used in the red optical arms. L
for the low resolution andM
for the medium resolution- Optional fields of the custom pointing list are listed below.
Name Datatype Unit Description ppc_pa float degree Position angle ppc_priority float Priority of the pointing center in the list ppc_code str Name of the pointing center
- Filler type: the online PPP will be disabled due to the limited computational resources
Understand the results
Simulation status
The online PPP will give a status report of the pointing simulation.
Errors are raised in the following cases
- (Usually under Classical mode) No fibers can be assigned since the input pointings can not complete any targets. For example, if a target requests 1800 sec, but only one pointing with an individual exposure time of 900 sec is given, no fiber can be assigned to the target since it can not be completed. Adding pointings or modifying individual exposure time can solve the problem.
- No fibers can be assigned due to no available fibers. Slightly shifting the pointing by ~0.2-0.5 degree can solve the problem in most cases.
Warnings are raised in the following cases:
- The total requested time exceeds the 5-night upper limit for the normal program (35 hours).
- The running time exceeds 15 minutes.
Examples of status
Summary of the PFS pointing simulation
A summary of the pointing simulation is shown as a list. The total request time and the following information is highlighted.
- Number of PFS pointing centers (PPCs)
- Corresponding fiberhours (i.e., the sum of exposure time for assigned targets)
- Total on-source time to complete the number of PPCs above assuming 15 minutes/pointing
- Total requested observing time (ROT) including overhead
- The expected completion rate for low- and medium-resolution modes, respectively
If the ROT exceeds the 5-night limit for an openuse program, the ROT is shown in red, otherwise, it is shown in green.
Download the results
Results from the online PPP can be downloaded as a ZIP file by pressing the Download button.
See README.txt
in the ZIP file for the content.
Table of the results
A table including the following information will be displayed. The table contents change interactively with the draggable slider(s) above the table.
Name | Unit | Description |
---|---|---|
resolution | low , medium or total |
|
N_ppc | Number of pointings, can be adjusted by the slider | |
Texp | hour | Total on-source time requested to complete N_ppc pointings |
Texp | fiberhour | Total on-source fiberhours requested |
Request time | hour | Total request time including overheads (e.g., calibration frames, fiber configuration, readout, telescope slewing) |
Used fiber fraction | % | Average fiber usage fraction of pointings |
Fraction of PPC <30% | % | Fration of pointings having the fiber usage fraction < 30% |
P_all | % | Completion rate of the entire program |
P_[0-9] | % | Completion rate of each priority group |
- If only one resolution mode (low or medium) is used, the table will only show information in that mode.
- The completion rates are calculated using
FiberHour_allocated / FiberHour_total
. It's important to note that this calculation includes partially observed targets in each pointing.
Interactive plots of the results
The Completion Rate (top and middle) and Target Distribution (bottom) will be shown for each resolution mode.
Completion Rate
PPC_id
- ID of PFS pointing center, PPCs are sorted by the total priority of targets assigned on them
- Thick black solid line
- Completion rate of the entire program
- Thick red solid line
- Completion rate of the primary sample (which has the smallest internal priority P)
- Other lines
- Completion rate of each priority group
- Vertical gray dashed line
- Number of pointings required, can be adjusted by the slider above
Target Distribution
Targets in each priority group are plotted in different colors, with the primary sample (which has the smallest internal priority P) in red. Transparent gray hexagons show the PFS FoV at pointing centers.
Fixed Parameters
In the PPP calculation, the following parameters are fixed.
Description | Value | Unit |
---|---|---|
Number of fibers | 2394 | |
Number of calibrators | 200 | |
Fiber configuration time per exposure | 180 | s |
Miscellaneous overheads1 | 120 | s |
Calibration and focusing overheads2 | 1.2 | h/night |
Maximum PPP running time | 900 | s |
Maximum number of pointings | 200 |