Import PV Export Ceilings into SAM’s Curtailment Table
Cinn Song
Founder & Chief Solutions Architect

TL;DR
Use SAM’s Curtailment table for time-varying AC export ceilings. Confirm the measurement point, power unit and weather-file alignment, then verify modeled output at schedule changes.
Specify absolute AC power ceilings in SAM’s Curtailment table for time-varying PV export restrictions. Approve the import after checking the operator’s measurement point, the table’s power unit, weather-file alignment and support in the selected performance model.
Summary
Specify absolute AC power ceilings in SAM’s Curtailment table for time-varying PV export restrictions. Approve the import after checking the operator’s measurement point, the table’s power unit, weather-file alignment and support in the selected performance model.
Key Takeaways
- Use the Curtailment table for the operator’s time-varying AC export ceilings.
- Use System Availability percentages for operational losses such as maintenance downtime.
- Enter a standing maximum export allowance in Grid Interconnection Limit, in kWac.
- Confirm the measurement point, power unit, interval and any percentage reference basis before formatting the schedule.
- Match the Curtailment rows to the weather file and check modeled output at schedule transitions.
- Confirm how the selected battery dispatch option treats grid limits and ask bidders to identify the site controls and their costs.
How to import time-varying PV export limits into SAM
Yes. In the System Advisor Model (SAM), map a grid operator’s time-varying PV export restrictions to absolute AC power ceilings in Grid Limits → Curtailment when the selected performance model supports that input and its system AC output represents the quantity the operator limits. Before approving the mapping, ask the integrator to confirm the operator’s measurement point, the required power unit and the alignment between the export schedule and the weather-file time steps. SAM Help — Grid Limits
Match each restriction to the SAM input

SAM applies the Curtailment table as a maximum system AC power output at each simulation time step. System Availability applies a percentage loss to the output for the corresponding step and is intended for operational losses such as maintenance downtime. As a result, an availability percentage changes output in proportion to the power the model calculates, while a curtailment ceiling constrains output when it would otherwise exceed the ceiling. SAM’s PVWatts System Design help directs grid-operator curtailment and required output reductions to Grid Limits. SAM Help — Grid Limits · SAM Help — PVWatts System Design
If the project also has a standing maximum export allowance, enter that value in Grid Interconnection Limit, which SAM labels in kWac. Use the Curtailment table for the schedule of varying ceilings. Ask the integrator to show both entries in the case handover so reviewers can trace each restriction to the relevant operator document. SAM Help — Grid Limits
Verify the operator schedule before importing it

Request the operator’s schedule with its effective period, time zone, interval length, measurement point and power unit. If the operator expresses a restriction as a percentage, ask what quantity the percentage refers to and request the corresponding absolute ceilings or confirmation of the conversion basis. SAM Help’s Grid Limits page defines the Curtailment table in terms of system AC power output. If the operator limits net export at the meter, ask the integrator to demonstrate that the selected SAM case represents that boundary, including any relevant site load or storage. Confirm the Curtailment table’s expected unit in the SAM version used for the study. SAM Help — Grid Limits
Prepare one ceiling per simulation step for the full modeled year. SAM expects the row count to match the weather file and specifies 8,760 values for the hourly case it documents. For a subhourly weather file, set the Curtailment array’s time step to the weather-file interval in minutes. Check row order and spot-check timestamps around changes in the ceiling. If a restriction starts or ends within a model step, agree with the operator on how to represent it before accepting the import. For a text-file import, use one data column and one header row. For clipboard paste, select the values without the header. SAM Help — Grid Limits
Review the simulation and specify the site controls
Ask the integrator to provide the normalized schedule, the saved SAM case and results at selected schedule transitions. Compare the pre-curtailment power series with the modeled output and the ceiling at those steps. Choose intervals where pre-curtailment power is above and below the ceiling to check where the limit binds. Review the annual curtailment energy loss in Results → Data Tables and, if a standing limit is enabled, review the separately reported interconnection-limit loss. SAM Help — Grid Limits
SAM assumes the site has a mechanism to adjust output to meet grid limits. Ask bidders to identify the proposed control equipment and itemize the related installation and operating costs. For a PV-plus-storage case, ask the integrator to identify the dispatch option and demonstrate how it treats the export limits. SAM’s Grid Limits help describes consideration of interconnection limits and curtailment as configurable for some battery dispatch options. SAM Help — Grid Limits
FAQ
What should go in the Curtailment table?
Enter the maximum system AC power allowed for each simulation step. SAM Help — Grid Limits
Where does scheduled PV maintenance belong?
Use System Availability to model maintenance downtime as an operational output loss. SAM Help — PVWatts System Design
Does every SAM performance model offer Grid Limits?
Availability varies by performance model. Open the proposed case and confirm the Grid Limits page is available before specifying the import. SAM Help — PVWatts System Design
Where do I enter a fixed export cap?
Enable Grid Interconnection Limit and enter the standing maximum in kWac. SAM Help — Grid Limits
Should the import file include a header?
For text-file import, use one header row followed by one column of values. For clipboard paste, select only the values. SAM Help — Grid Limits
Do these grid limits also restrict imports?
The Curtailment and Grid Interconnection Limit inputs restrict exports. Electricity imports are outside their scope. SAM Help — Grid Limits
Where can I review annual energy lost to curtailment?
Look for the annual curtailment-limit energy loss in Results → Data Tables. SAM Help — Grid Limits
Which financial models use the curtailment compensation rate?
SAM’s Grid Limits help identifies Single Owner and Merchant Plant as using the curtailment compensation rate on the Revenue page. Confirm the applicable rate in the project agreement. SAM Help — Grid Limits
Procurement paths
About the Author

Cinn Song
Founder & Chief Solutions Architect
Cinn Song founded SOLARTODO LIMITED and leads its smart-city infrastructure engineering — from solar, storage and integrated smart poles to the company's push into physical-AI city edge nodes: pole-mounted edge computing, vertical LLMs for smart cities, drone-based O&M with autonomous battery swapping, robotic maintenance, and high-speed counter-UAS interception. Since 2010, he has directed turnkey EPC + BOT delivery across 50+ countries, including telecom monopole supply for national grid operators, off-grid solar street-lighting for African municipalities, and integrated smart-pole programs for Gulf smart cities.
Cite This Article
Cinn Song. (2026). Import PV Export Ceilings into SAM’s Curtailment Table. SOLARTODO. Retrieved from https://solartodo.com/knowledge/when-importing-a-grid-operators-time-varying-pv-export-restrictions-should-the-integration-map-them-to-absolute
@article{solartodo_when_importing_a_grid_operators_time_varying_pv_export_restrictions_should_the_integration_map_them_to_absolute,
title = {Import PV Export Ceilings into SAM’s Curtailment Table},
author = {Cinn Song},
journal = {SOLARTODO Knowledge Base},
year = {2026},
url = {https://solartodo.com/knowledge/when-importing-a-grid-operators-time-varying-pv-export-restrictions-should-the-integration-map-them-to-absolute},
note = {Accessed: 2026-11-22}
}Published: November 21, 2026 | Available at: https://solartodo.com/knowledge/when-importing-a-grid-operators-time-varying-pv-export-restrictions-should-the-integration-map-them-to-absolute
Subscribe to Our Newsletter
Get the latest solar energy news and insights delivered to your inbox.
View All Articles