太阳能软件：SAM二次开发_3.SAM数据输入与处理.docx

PAGE1

PAGE1

3.SAM数据输入与处理

3.1数据输入方式

在使用SAM（SystemAdvisorModel）进行太阳能项目评估时，数据输入是一个关键步骤。SAM提供了多种数据输入方式，包括直接输入、文件导入和API调用。这些方式各有优势，适用于不同的场景和需求。

3.1.1直接输入

直接输入是最简单和直观的方式。用户可以通过SAM的图形用户界面（GUI）手动输入各种参数，如地理位置、天气数据、系统配置等。这种方式适用于小型项目或快速评估，但不适合大规模数据处理和自动化任务。

示例：

假设我们要评估一个位于美国加利福尼亚州圣迭戈的光伏系统。我们需要手动输入以下参数：

地理位置：纬度32.7157，经度-117.1611

天气数据：选择标准的气象数据文件（如TMY3文件）

系统配置：选择光伏模块型号、逆变器型号、安装方式等

3.1.2文件导入

文件导入是一种更高效的数据输入方式，适用于有大量数据需要处理的情况。SAM支持多种数据文件格式，如CSV、Excel和TMY3等。用户可以将这些文件导入SAM，从而快速配置项目参数。

示例：

假设我们有一个包含多个光伏项目的CSV文件，文件内容如下：

Project,Latitude,Longitude,Module,Inverter,Installation

Project1,32.7157,-117.1611,ModuleA,InverterB,Roof

Project2,37.7749,-122.4194,ModuleC,InverterD,Ground

我们可以使用Python脚本将这些数据导入SAM。以下是一个简单的示例代码：

importos

importpandasaspd

fromPySAMimportPvwattsv8

#读取CSV文件

data=pd.read_csv(projects.csv)

#初始化SAM模型

sam_model=Pvwattsv8.default(Pvwattsv8)

#遍历项目数据并配置到SAM模型

forindex,rowindata.iterrows():

project_name=row[Project]

latitude=row[Latitude]

longitude=row[Longitude]

module=row[Module]

inverter=row[Inverter]

installation=row[Installation]

#配置地理位置

sam_model.SolarResource.solar_resource_data={

lat:latitude,

lon:longitude

}

#配置光伏模块

sam_model.Pvwattsv8.module=module

#配置逆变器

sam_model.Pvwattsv8.inverter=inverter

#配置安装方式

ifinstallation==Roof:

sam_model.Pvwattsv8.array_type=0

elifinstallation==Ground:

sam_model.Pvwattsv8.array_type=1

#保存配置

sam_model.save(f{project_name}.sam)

3.1.3API调用

API调用是自动化数据输入的最佳方式。SAM提供了丰富的API接口，可以通过编程语言（如Python）进行调用，实现数据的批量处理和自动化配置。这种方式适用于需要频繁更新数据的项目，如天气数据的实时更新。

示例：

假设我们要通过API调用从一个气象数据服务获取实时天气数据，并将其配置到SAM模型中。以下是一个使用Python调用API并配置数据的示例代码：

importrequests

fromPySAMimportPvwattsv8

#获取实时天气数据的APIURL

api_url=/weather

#发送请求获取数据

response=requests.get(api_url,params={

location:SanDiego,