technical article

Import PV Export Ceilings into SAM’s Curtailment Table

November 21, 2026Updated: November 21, 20266 min readFact Checked
Cinn Song

Cinn Song

Founder & Chief Solutions Architect

Import PV Export Ceilings into SAM’s Curtailment Table

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

Import PV Export Ceilings into SAM’s Curtailment Table — Detailed functional anatomy

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

Import PV Export Ceilings into SAM’s Curtailment Table — Detailed system operations and maintenance

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

About the Author

Cinn Song

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.

View All Posts

Cite This Article

APA

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

BibTeX
@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