Model.new_space_from_excel#

Model.new_space_from_excel(book, range_, sheet=None, name=None, names_row=0, param_cols=(0,), space_param_order=None, cells_param_order=None, transpose=False, names_col=None, param_rows=None)#

从Excel范围创建子空间。

警告

该方法已弃用。

要使用此方法,必须安装openpyxl包。

Parameters:
  • book (str) – Excel文件路径。

  • range (str) – 范围表达式,例如"A1"、"$G4:$K10",或命名范围"NamedRange1"。

  • sheet (str) – 工作表名称(不区分大小写)。

  • name (str, optional) – 空间的名称。默认为 SpaceN, 其中 N 是自动确定的数字。

  • names_row (可选) - 一个索引数字,表示哪一行包含单元格和参数的名称。默认为首行(0)。

  • param_cols (可选) – 表示参数列的索引号序列。默认为仅最左侧列([0])。

  • names_col (可选) – 从0开始的索引号,表示哪一列包含额外参数。

  • param_rows (可选) – 从0开始的行索引序列,用于表示附加参数所在的行,适用于单元格以二维形式定义的情况。

  • transpose (可选) – 默认为 False。 如果设置为 True,则参数名称中的"row(s)"和"col(s)"会被反向解释, 即传递给"row(s)"参数的所有索引将被解释为列索引, 而传递给"col(s)"参数的所有索引将被解释为行索引。

  • space_param_order – 用于指定空间参数及其顺序的序列。序列元素表示param_cols元素的索引,并可选择性地表示param_rows元素索引(需加上param_cols的长度作为偏移量)。该参数的元素与cell_param_order的元素不得重叠。

  • cell_param_order (可选) – 用于重新排序参数的序列。序列元素表示param_cols元素的索引,也可以表示param_rows元素的索引(需加上param_cols的长度作为偏移量)。该参数的元素与cell_space_order的元素不能有重叠。

Returns:

从Excel范围创建的新子空间。

另请参阅

new_cells_from_excel(): 从Excel文件创建Cells。

在0.20.0版本中变更:该方法已弃用。