# pvl_SAMLibraryReader_CECModules

Open a System Advisor Model (SAM) CEC Module library

## Contents

- Syntax
- Description
- Input
- Output
- Notes
- Sources
- See also

## Syntax

- `[CECModuleDB, ModuleNames] = pvl_SAMLibraryReader_CECModules()`
- `[CECModuleDB, ModuleNames] = pvl_SAMLibraryReader_CECModules(LibraryFile)`

## Description

`pvl_SAMLibraryReader_CECModules` reads a System Advisor Model (SAM) [1] library of CEC Modules.

## Input

- `LibraryFile` - An optional input string to select which SAM library to read. If omitted, a user dialog box will prompt the user to browse and select a module library. Note that if `LibraryFile` is input to the function, the standard MATLAB precedence order applies.

## Output

- `CECModuleDB` - The parameters in the SAM module library. CECModuleDB is a column vector of length `NumberOfLibraryEntries` where each element. is a struct with the following fields. These fields may be described in more detail in the SAM documentation.
- `CECModuleDB.name` - Name of the module entry in the library.
- `CECModuleDB.t_noct` - Nominal Operating Cell Temperature (NOCT) in degrees C of the module.
- `CECModuleDB.a_c` - Module area in m^2.
- `CECModuleDB.Ns` - Number of series cells within the module.
- `CECModuleDB.i_sc_ref` - Short circuit current under reference conditions.
- `CECModuleDB.v_oc_ref` - Open circuit voltage under reference conditions.
- `CECModuleDB.i_mp_ref` - Maximum power current under reference condtions.
- `CECModuleDB.v_mp_ref` - Maximum power voltage under reference conditions.
- `CECModuleDB.alpha_sc` - Short circuit current temperature coefficient in A/C.
- `CECModuleDB.beta_oc` - Open circuit voltage tempereature coefficient in V/C.
- `CECModuleDB.a_ref` - modified diode ideality factor parameter at reference conditions (units of eV), a_ref can be calculated from the usual diode ideality factor (n), number of cells in series (Ns), and cell temperature (Tcell) per equation (2) in [2].
- `CECModuleDB.IL_ref` - Light-generated current (or photocurrent) in amperes at reference conditions. This value is referred to as Iph in some literature.
- `CECModuleDB.I0_ref` - diode reverse saturation current in amperes, under reference conditions.
- `CECModuleDB.Rs_ref` - series resistance under reference conditions (ohms)
- `CECModuleDB.Rsh_ref` - shunt resistance under reference conditions (ohms)
- `adjust` - Adjustment percentage to allow measured power temperature coefficient to match reported power temperature coefficient [3].
- `CECModuleDB.gamma_r` - Power temperature coefficient in %/C.
- `CECModuleDB.source` - String describing the type of cells used in the module.
- `CECModuleDB.LibraryType` - Library type as listed in the header information of the SAM library file.
- `CECModuleDB.LibraryName` - Library name as listed in the header information of the SAM library file.

- `ModuleNames` - A cell array of size [NumberOfLibraryEntries, 1] with the names of the modules in the SAM library.

## Notes

If this function detects that the selected input library is not of type "CECModule", it will display a warning to the command window and continue to try and read the library.

The PV_LIB team would also like to thank the SAM team for maintaining the CEC module parameter library and allowing for interaction with the library files.

## Sources

[1] System Advisor Model web page. https://sam.nrel.gov.

[2] W. De Soto et al., "Improvement and validation of a model for photovoltaic array performance", Solar Energy, vol 80, pp. 78-88, 2006.

[3] A. Dobos, "An Improved Coefficient Calculator for the California Energy Commission 6 Parameter Photovoltaic Module Model", Journal of Solar Energy Engineering, vol 134, 2012.

## See also

`pvl_singlediode`, `pvl_calcparams`

Copyright 2015 Sandia National Laboratories