ltbams 0.9.9__py3-none-any.whl → 1.0.0__py3-none-any.whl

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (728) hide show
  1. ams/__init__.py +4 -11
  2. ams/_version.py +4 -4
  3. ams/cases/5bus/pjm5bus_demo.xlsx +0 -0
  4. ams/cases/5bus/pjm5bus_jumper.xlsx +0 -0
  5. ams/cases/5bus/pjm5bus_uced.json +1062 -0
  6. ams/cases/5bus/pjm5bus_uced.xlsx +0 -0
  7. ams/cases/5bus/pjm5bus_uced_esd1.xlsx +0 -0
  8. ams/cases/5bus/pjm5bus_uced_ev.xlsx +0 -0
  9. ams/cases/ieee123/ieee123.xlsx +0 -0
  10. ams/cases/ieee123/ieee123_regcv1.xlsx +0 -0
  11. ams/cases/ieee14/ieee14.json +1166 -0
  12. ams/cases/ieee14/ieee14.raw +92 -0
  13. ams/cases/ieee14/ieee14_conn.xlsx +0 -0
  14. ams/cases/ieee14/ieee14_uced.xlsx +0 -0
  15. ams/cases/ieee39/ieee39.xlsx +0 -0
  16. ams/cases/ieee39/ieee39_uced.xlsx +0 -0
  17. ams/cases/ieee39/ieee39_uced_esd1.xlsx +0 -0
  18. ams/cases/ieee39/ieee39_uced_pvd1.xlsx +0 -0
  19. ams/cases/ieee39/ieee39_uced_vis.xlsx +0 -0
  20. ams/cases/matpower/benchmark.json +1594 -0
  21. ams/cases/matpower/case118.m +787 -0
  22. ams/cases/matpower/case14.m +129 -0
  23. ams/cases/matpower/case300.m +1315 -0
  24. ams/cases/matpower/case39.m +205 -0
  25. ams/cases/matpower/case5.m +62 -0
  26. ams/cases/matpower/case_ACTIVSg2000.m +9460 -0
  27. ams/cases/npcc/npcc.m +644 -0
  28. ams/cases/npcc/npcc_uced.xlsx +0 -0
  29. ams/cases/pglib/pglib_opf_case39_epri__api.m +243 -0
  30. ams/cases/wecc/wecc.m +714 -0
  31. ams/cases/wecc/wecc_uced.xlsx +0 -0
  32. ams/cli.py +6 -0
  33. ams/core/__init__.py +2 -0
  34. ams/core/documenter.py +652 -0
  35. ams/core/matprocessor.py +782 -0
  36. ams/core/model.py +330 -0
  37. ams/core/param.py +322 -0
  38. ams/core/service.py +918 -0
  39. ams/core/symprocessor.py +224 -0
  40. ams/core/var.py +59 -0
  41. ams/extension/__init__.py +5 -0
  42. ams/extension/eva.py +401 -0
  43. ams/interface.py +1085 -0
  44. ams/io/__init__.py +133 -0
  45. ams/io/json.py +82 -0
  46. ams/io/matpower.py +406 -0
  47. ams/io/psse.py +6 -0
  48. ams/io/pypower.py +103 -0
  49. ams/io/xlsx.py +80 -0
  50. ams/main.py +83 -4
  51. ams/models/__init__.py +24 -0
  52. ams/models/area.py +40 -0
  53. ams/models/bus.py +52 -0
  54. ams/models/cost.py +169 -0
  55. ams/models/distributed/__init__.py +3 -0
  56. ams/models/distributed/esd1.py +71 -0
  57. ams/models/distributed/ev.py +60 -0
  58. ams/models/distributed/pvd1.py +67 -0
  59. ams/models/group.py +231 -0
  60. ams/models/info.py +26 -0
  61. ams/models/line.py +238 -0
  62. ams/models/renewable/__init__.py +5 -0
  63. ams/models/renewable/regc.py +119 -0
  64. ams/models/reserve.py +94 -0
  65. ams/models/shunt.py +14 -0
  66. ams/models/static/__init__.py +2 -0
  67. ams/models/static/gen.py +165 -0
  68. ams/models/static/pq.py +61 -0
  69. ams/models/timeslot.py +69 -0
  70. ams/models/zone.py +49 -0
  71. ams/opt/__init__.py +12 -0
  72. ams/opt/constraint.py +175 -0
  73. ams/opt/exprcalc.py +127 -0
  74. ams/opt/expression.py +188 -0
  75. ams/opt/objective.py +174 -0
  76. ams/opt/omodel.py +432 -0
  77. ams/opt/optzbase.py +192 -0
  78. ams/opt/param.py +156 -0
  79. ams/opt/var.py +233 -0
  80. ams/pypower/__init__.py +8 -0
  81. ams/pypower/_compat.py +9 -0
  82. ams/pypower/core/__init__.py +8 -0
  83. ams/pypower/core/pips.py +894 -0
  84. ams/pypower/core/ppoption.py +244 -0
  85. ams/pypower/core/ppver.py +18 -0
  86. ams/pypower/core/solver.py +2451 -0
  87. ams/pypower/eps.py +6 -0
  88. ams/pypower/idx.py +174 -0
  89. ams/pypower/io.py +604 -0
  90. ams/pypower/make/__init__.py +11 -0
  91. ams/pypower/make/matrices.py +665 -0
  92. ams/pypower/make/pdv.py +506 -0
  93. ams/pypower/routines/__init__.py +7 -0
  94. ams/pypower/routines/cpf.py +513 -0
  95. ams/pypower/routines/cpf_callbacks.py +114 -0
  96. ams/pypower/routines/opf.py +1803 -0
  97. ams/pypower/routines/opffcns.py +1946 -0
  98. ams/pypower/routines/pflow.py +852 -0
  99. ams/pypower/toggle.py +1098 -0
  100. ams/pypower/utils.py +293 -0
  101. ams/report.py +212 -50
  102. ams/routines/__init__.py +23 -0
  103. ams/routines/acopf.py +117 -0
  104. ams/routines/cpf.py +65 -0
  105. ams/routines/dcopf.py +241 -0
  106. ams/routines/dcpf.py +209 -0
  107. ams/routines/dcpf0.py +196 -0
  108. ams/routines/dopf.py +150 -0
  109. ams/routines/ed.py +312 -0
  110. ams/routines/pflow.py +255 -0
  111. ams/routines/pflow0.py +113 -0
  112. ams/routines/pflow1.py +156 -0
  113. ams/routines/routine.py +1033 -0
  114. ams/routines/rted.py +519 -0
  115. ams/routines/type.py +160 -0
  116. ams/routines/uc.py +376 -0
  117. ams/shared.py +34 -9
  118. ams/system.py +61 -22
  119. ams/utils/__init__.py +3 -0
  120. ams/utils/misc.py +77 -0
  121. ams/utils/paths.py +257 -0
  122. docs/Makefile +21 -0
  123. docs/build/doctrees/nbsphinx/_examples_demo_demo_AGC_20_1.png +0 -0
  124. docs/build/doctrees/nbsphinx/_examples_demo_demo_AGC_37_1.png +0 -0
  125. docs/build/doctrees/nbsphinx/_examples_demo_demo_AGC_39_1.png +0 -0
  126. docs/build/html/_images/_examples_demo_demo_AGC_20_1.png +0 -0
  127. docs/build/html/_images/_examples_demo_demo_AGC_37_1.png +0 -0
  128. docs/build/html/_images/_examples_demo_demo_AGC_39_1.png +0 -0
  129. docs/build/html/_images/xlsx.png +0 -0
  130. docs/build/html/_static/file.png +0 -0
  131. docs/build/html/_static/minus.png +0 -0
  132. docs/build/html/_static/plus.png +0 -0
  133. docs/make.bat +35 -0
  134. docs/source/_generated/_generated/ams.core.model.Model.alter.rst +6 -0
  135. docs/source/_generated/_generated/ams.core.model.Model.class_name.rst +6 -0
  136. docs/source/_generated/_generated/ams.core.model.Model.doc.rst +6 -0
  137. docs/source/_generated/_generated/ams.core.model.Model.get.rst +6 -0
  138. docs/source/_generated/_generated/ams.core.model.Model.get_idx.rst +6 -0
  139. docs/source/_generated/_generated/ams.core.model.Model.idx2uid.rst +6 -0
  140. docs/source/_generated/_generated/ams.core.model.Model.list2array.rst +6 -0
  141. docs/source/_generated/_generated/ams.core.model.Model.set.rst +6 -0
  142. docs/source/_generated/_generated/ams.core.model.Model.set_backref.rst +6 -0
  143. docs/source/_generated/_generated/ams.core.param.RParam.class_name.rst +6 -0
  144. docs/source/_generated/_generated/ams.core.param.RParam.dtype.rst +6 -0
  145. docs/source/_generated/_generated/ams.core.param.RParam.evaluate.rst +6 -0
  146. docs/source/_generated/_generated/ams.core.param.RParam.get_idx.rst +6 -0
  147. docs/source/_generated/_generated/ams.core.param.RParam.n.rst +6 -0
  148. docs/source/_generated/_generated/ams.core.param.RParam.parse.rst +6 -0
  149. docs/source/_generated/_generated/ams.core.param.RParam.shape.rst +6 -0
  150. docs/source/_generated/_generated/ams.core.param.RParam.size.rst +6 -0
  151. docs/source/_generated/_generated/ams.core.param.RParam.update.rst +6 -0
  152. docs/source/_generated/_generated/ams.core.param.RParam.v.rst +6 -0
  153. docs/source/_generated/_generated/ams.core.service.LoadScale.assign_memory.rst +6 -0
  154. docs/source/_generated/_generated/ams.core.service.LoadScale.class_name.rst +6 -0
  155. docs/source/_generated/_generated/ams.core.service.LoadScale.evaluate.rst +6 -0
  156. docs/source/_generated/_generated/ams.core.service.LoadScale.get_names.rst +6 -0
  157. docs/source/_generated/_generated/ams.core.service.LoadScale.n.rst +6 -0
  158. docs/source/_generated/_generated/ams.core.service.LoadScale.parse.rst +6 -0
  159. docs/source/_generated/_generated/ams.core.service.LoadScale.shape.rst +6 -0
  160. docs/source/_generated/_generated/ams.core.service.LoadScale.size.rst +6 -0
  161. docs/source/_generated/_generated/ams.core.service.LoadScale.update.rst +6 -0
  162. docs/source/_generated/_generated/ams.core.service.LoadScale.v.rst +6 -0
  163. docs/source/_generated/_generated/ams.core.service.MinDur.assign_memory.rst +6 -0
  164. docs/source/_generated/_generated/ams.core.service.MinDur.class_name.rst +6 -0
  165. docs/source/_generated/_generated/ams.core.service.MinDur.evaluate.rst +6 -0
  166. docs/source/_generated/_generated/ams.core.service.MinDur.get_names.rst +6 -0
  167. docs/source/_generated/_generated/ams.core.service.MinDur.n.rst +6 -0
  168. docs/source/_generated/_generated/ams.core.service.MinDur.parse.rst +6 -0
  169. docs/source/_generated/_generated/ams.core.service.MinDur.shape.rst +6 -0
  170. docs/source/_generated/_generated/ams.core.service.MinDur.size.rst +6 -0
  171. docs/source/_generated/_generated/ams.core.service.MinDur.update.rst +6 -0
  172. docs/source/_generated/_generated/ams.core.service.MinDur.v.rst +6 -0
  173. docs/source/_generated/_generated/ams.core.service.MinDur.v0.rst +6 -0
  174. docs/source/_generated/_generated/ams.core.service.MinDur.v1.rst +6 -0
  175. docs/source/_generated/_generated/ams.core.service.NumExpandDim.assign_memory.rst +6 -0
  176. docs/source/_generated/_generated/ams.core.service.NumExpandDim.class_name.rst +6 -0
  177. docs/source/_generated/_generated/ams.core.service.NumExpandDim.evaluate.rst +6 -0
  178. docs/source/_generated/_generated/ams.core.service.NumExpandDim.get_names.rst +6 -0
  179. docs/source/_generated/_generated/ams.core.service.NumExpandDim.n.rst +6 -0
  180. docs/source/_generated/_generated/ams.core.service.NumExpandDim.parse.rst +6 -0
  181. docs/source/_generated/_generated/ams.core.service.NumExpandDim.shape.rst +6 -0
  182. docs/source/_generated/_generated/ams.core.service.NumExpandDim.size.rst +6 -0
  183. docs/source/_generated/_generated/ams.core.service.NumExpandDim.update.rst +6 -0
  184. docs/source/_generated/_generated/ams.core.service.NumExpandDim.v.rst +6 -0
  185. docs/source/_generated/_generated/ams.core.service.NumExpandDim.v0.rst +6 -0
  186. docs/source/_generated/_generated/ams.core.service.NumExpandDim.v1.rst +6 -0
  187. docs/source/_generated/_generated/ams.core.service.NumHstack.assign_memory.rst +6 -0
  188. docs/source/_generated/_generated/ams.core.service.NumHstack.class_name.rst +6 -0
  189. docs/source/_generated/_generated/ams.core.service.NumHstack.evaluate.rst +6 -0
  190. docs/source/_generated/_generated/ams.core.service.NumHstack.get_names.rst +6 -0
  191. docs/source/_generated/_generated/ams.core.service.NumHstack.n.rst +6 -0
  192. docs/source/_generated/_generated/ams.core.service.NumHstack.parse.rst +6 -0
  193. docs/source/_generated/_generated/ams.core.service.NumHstack.shape.rst +6 -0
  194. docs/source/_generated/_generated/ams.core.service.NumHstack.size.rst +6 -0
  195. docs/source/_generated/_generated/ams.core.service.NumHstack.update.rst +6 -0
  196. docs/source/_generated/_generated/ams.core.service.NumHstack.v.rst +6 -0
  197. docs/source/_generated/_generated/ams.core.service.NumHstack.v0.rst +6 -0
  198. docs/source/_generated/_generated/ams.core.service.NumHstack.v1.rst +6 -0
  199. docs/source/_generated/_generated/ams.core.service.NumOp.assign_memory.rst +6 -0
  200. docs/source/_generated/_generated/ams.core.service.NumOp.class_name.rst +6 -0
  201. docs/source/_generated/_generated/ams.core.service.NumOp.evaluate.rst +6 -0
  202. docs/source/_generated/_generated/ams.core.service.NumOp.get_names.rst +6 -0
  203. docs/source/_generated/_generated/ams.core.service.NumOp.n.rst +6 -0
  204. docs/source/_generated/_generated/ams.core.service.NumOp.parse.rst +6 -0
  205. docs/source/_generated/_generated/ams.core.service.NumOp.shape.rst +6 -0
  206. docs/source/_generated/_generated/ams.core.service.NumOp.size.rst +6 -0
  207. docs/source/_generated/_generated/ams.core.service.NumOp.update.rst +6 -0
  208. docs/source/_generated/_generated/ams.core.service.NumOp.v.rst +6 -0
  209. docs/source/_generated/_generated/ams.core.service.NumOp.v0.rst +6 -0
  210. docs/source/_generated/_generated/ams.core.service.NumOp.v1.rst +6 -0
  211. docs/source/_generated/_generated/ams.core.service.NumOpDual.assign_memory.rst +6 -0
  212. docs/source/_generated/_generated/ams.core.service.NumOpDual.class_name.rst +6 -0
  213. docs/source/_generated/_generated/ams.core.service.NumOpDual.evaluate.rst +6 -0
  214. docs/source/_generated/_generated/ams.core.service.NumOpDual.get_names.rst +6 -0
  215. docs/source/_generated/_generated/ams.core.service.NumOpDual.n.rst +6 -0
  216. docs/source/_generated/_generated/ams.core.service.NumOpDual.parse.rst +6 -0
  217. docs/source/_generated/_generated/ams.core.service.NumOpDual.shape.rst +6 -0
  218. docs/source/_generated/_generated/ams.core.service.NumOpDual.size.rst +6 -0
  219. docs/source/_generated/_generated/ams.core.service.NumOpDual.update.rst +6 -0
  220. docs/source/_generated/_generated/ams.core.service.NumOpDual.v.rst +6 -0
  221. docs/source/_generated/_generated/ams.core.service.NumOpDual.v0.rst +6 -0
  222. docs/source/_generated/_generated/ams.core.service.NumOpDual.v1.rst +6 -0
  223. docs/source/_generated/_generated/ams.core.service.RBaseService.assign_memory.rst +6 -0
  224. docs/source/_generated/_generated/ams.core.service.RBaseService.class_name.rst +6 -0
  225. docs/source/_generated/_generated/ams.core.service.RBaseService.evaluate.rst +6 -0
  226. docs/source/_generated/_generated/ams.core.service.RBaseService.get_names.rst +6 -0
  227. docs/source/_generated/_generated/ams.core.service.RBaseService.n.rst +6 -0
  228. docs/source/_generated/_generated/ams.core.service.RBaseService.parse.rst +6 -0
  229. docs/source/_generated/_generated/ams.core.service.RBaseService.shape.rst +6 -0
  230. docs/source/_generated/_generated/ams.core.service.RBaseService.size.rst +6 -0
  231. docs/source/_generated/_generated/ams.core.service.RBaseService.update.rst +6 -0
  232. docs/source/_generated/_generated/ams.core.service.RBaseService.v.rst +6 -0
  233. docs/source/_generated/_generated/ams.core.service.ROperationService.assign_memory.rst +6 -0
  234. docs/source/_generated/_generated/ams.core.service.ROperationService.class_name.rst +6 -0
  235. docs/source/_generated/_generated/ams.core.service.ROperationService.evaluate.rst +6 -0
  236. docs/source/_generated/_generated/ams.core.service.ROperationService.get_names.rst +6 -0
  237. docs/source/_generated/_generated/ams.core.service.ROperationService.n.rst +6 -0
  238. docs/source/_generated/_generated/ams.core.service.ROperationService.parse.rst +6 -0
  239. docs/source/_generated/_generated/ams.core.service.ROperationService.shape.rst +6 -0
  240. docs/source/_generated/_generated/ams.core.service.ROperationService.size.rst +6 -0
  241. docs/source/_generated/_generated/ams.core.service.ROperationService.update.rst +6 -0
  242. docs/source/_generated/_generated/ams.core.service.ROperationService.v.rst +6 -0
  243. docs/source/_generated/_generated/ams.core.service.RampSub.assign_memory.rst +6 -0
  244. docs/source/_generated/_generated/ams.core.service.RampSub.class_name.rst +6 -0
  245. docs/source/_generated/_generated/ams.core.service.RampSub.evaluate.rst +6 -0
  246. docs/source/_generated/_generated/ams.core.service.RampSub.get_names.rst +6 -0
  247. docs/source/_generated/_generated/ams.core.service.RampSub.n.rst +6 -0
  248. docs/source/_generated/_generated/ams.core.service.RampSub.parse.rst +6 -0
  249. docs/source/_generated/_generated/ams.core.service.RampSub.shape.rst +6 -0
  250. docs/source/_generated/_generated/ams.core.service.RampSub.size.rst +6 -0
  251. docs/source/_generated/_generated/ams.core.service.RampSub.update.rst +6 -0
  252. docs/source/_generated/_generated/ams.core.service.RampSub.v.rst +6 -0
  253. docs/source/_generated/_generated/ams.core.service.RampSub.v0.rst +6 -0
  254. docs/source/_generated/_generated/ams.core.service.RampSub.v1.rst +6 -0
  255. docs/source/_generated/_generated/ams.core.service.ValueService.assign_memory.rst +6 -0
  256. docs/source/_generated/_generated/ams.core.service.ValueService.class_name.rst +6 -0
  257. docs/source/_generated/_generated/ams.core.service.ValueService.evaluate.rst +6 -0
  258. docs/source/_generated/_generated/ams.core.service.ValueService.get_names.rst +6 -0
  259. docs/source/_generated/_generated/ams.core.service.ValueService.n.rst +6 -0
  260. docs/source/_generated/_generated/ams.core.service.ValueService.parse.rst +6 -0
  261. docs/source/_generated/_generated/ams.core.service.ValueService.shape.rst +6 -0
  262. docs/source/_generated/_generated/ams.core.service.ValueService.size.rst +6 -0
  263. docs/source/_generated/_generated/ams.core.service.ValueService.update.rst +6 -0
  264. docs/source/_generated/_generated/ams.core.service.ValueService.v.rst +6 -0
  265. docs/source/_generated/_generated/ams.core.service.VarReduction.assign_memory.rst +6 -0
  266. docs/source/_generated/_generated/ams.core.service.VarReduction.class_name.rst +6 -0
  267. docs/source/_generated/_generated/ams.core.service.VarReduction.evaluate.rst +6 -0
  268. docs/source/_generated/_generated/ams.core.service.VarReduction.get_names.rst +6 -0
  269. docs/source/_generated/_generated/ams.core.service.VarReduction.n.rst +6 -0
  270. docs/source/_generated/_generated/ams.core.service.VarReduction.parse.rst +6 -0
  271. docs/source/_generated/_generated/ams.core.service.VarReduction.shape.rst +6 -0
  272. docs/source/_generated/_generated/ams.core.service.VarReduction.size.rst +6 -0
  273. docs/source/_generated/_generated/ams.core.service.VarReduction.update.rst +6 -0
  274. docs/source/_generated/_generated/ams.core.service.VarReduction.v.rst +6 -0
  275. docs/source/_generated/_generated/ams.core.service.VarReduction.v0.rst +6 -0
  276. docs/source/_generated/_generated/ams.core.service.VarReduction.v1.rst +6 -0
  277. docs/source/_generated/_generated/ams.core.service.VarSelect.assign_memory.rst +6 -0
  278. docs/source/_generated/_generated/ams.core.service.VarSelect.class_name.rst +6 -0
  279. docs/source/_generated/_generated/ams.core.service.VarSelect.evaluate.rst +6 -0
  280. docs/source/_generated/_generated/ams.core.service.VarSelect.get_names.rst +6 -0
  281. docs/source/_generated/_generated/ams.core.service.VarSelect.n.rst +6 -0
  282. docs/source/_generated/_generated/ams.core.service.VarSelect.parse.rst +6 -0
  283. docs/source/_generated/_generated/ams.core.service.VarSelect.shape.rst +6 -0
  284. docs/source/_generated/_generated/ams.core.service.VarSelect.size.rst +6 -0
  285. docs/source/_generated/_generated/ams.core.service.VarSelect.update.rst +6 -0
  286. docs/source/_generated/_generated/ams.core.service.VarSelect.v.rst +6 -0
  287. docs/source/_generated/_generated/ams.core.service.VarSelect.v0.rst +6 -0
  288. docs/source/_generated/_generated/ams.core.service.VarSelect.v1.rst +6 -0
  289. docs/source/_generated/_generated/ams.core.service.ZonalSum.assign_memory.rst +6 -0
  290. docs/source/_generated/_generated/ams.core.service.ZonalSum.class_name.rst +6 -0
  291. docs/source/_generated/_generated/ams.core.service.ZonalSum.evaluate.rst +6 -0
  292. docs/source/_generated/_generated/ams.core.service.ZonalSum.get_names.rst +6 -0
  293. docs/source/_generated/_generated/ams.core.service.ZonalSum.n.rst +6 -0
  294. docs/source/_generated/_generated/ams.core.service.ZonalSum.parse.rst +6 -0
  295. docs/source/_generated/_generated/ams.core.service.ZonalSum.shape.rst +6 -0
  296. docs/source/_generated/_generated/ams.core.service.ZonalSum.size.rst +6 -0
  297. docs/source/_generated/_generated/ams.core.service.ZonalSum.update.rst +6 -0
  298. docs/source/_generated/_generated/ams.core.service.ZonalSum.v.rst +6 -0
  299. docs/source/_generated/_generated/ams.core.service.ZonalSum.v0.rst +6 -0
  300. docs/source/_generated/_generated/ams.core.service.ZonalSum.v1.rst +6 -0
  301. docs/source/_generated/_generated/ams.interface.Dynamic.is_tds.rst +6 -0
  302. docs/source/_generated/_generated/ams.interface.Dynamic.link_andes.rst +6 -0
  303. docs/source/_generated/_generated/ams.interface.Dynamic.receive.rst +6 -0
  304. docs/source/_generated/_generated/ams.interface.Dynamic.send.rst +6 -0
  305. docs/source/_generated/_generated/ams.opt.constraint.Constraint.class_name.rst +6 -0
  306. docs/source/_generated/_generated/ams.opt.constraint.Constraint.e.rst +6 -0
  307. docs/source/_generated/_generated/ams.opt.constraint.Constraint.evaluate.rst +6 -0
  308. docs/source/_generated/_generated/ams.opt.constraint.Constraint.n.rst +6 -0
  309. docs/source/_generated/_generated/ams.opt.constraint.Constraint.parse.rst +6 -0
  310. docs/source/_generated/_generated/ams.opt.constraint.Constraint.shape.rst +6 -0
  311. docs/source/_generated/_generated/ams.opt.constraint.Constraint.size.rst +6 -0
  312. docs/source/_generated/_generated/ams.opt.constraint.Constraint.v.rst +6 -0
  313. docs/source/_generated/_generated/ams.opt.exprcalc.ExpressionCalc.class_name.rst +6 -0
  314. docs/source/_generated/_generated/ams.opt.exprcalc.ExpressionCalc.e.rst +6 -0
  315. docs/source/_generated/_generated/ams.opt.exprcalc.ExpressionCalc.evaluate.rst +6 -0
  316. docs/source/_generated/_generated/ams.opt.exprcalc.ExpressionCalc.get_idx.rst +6 -0
  317. docs/source/_generated/_generated/ams.opt.exprcalc.ExpressionCalc.n.rst +6 -0
  318. docs/source/_generated/_generated/ams.opt.exprcalc.ExpressionCalc.parse.rst +6 -0
  319. docs/source/_generated/_generated/ams.opt.exprcalc.ExpressionCalc.shape.rst +6 -0
  320. docs/source/_generated/_generated/ams.opt.exprcalc.ExpressionCalc.size.rst +6 -0
  321. docs/source/_generated/_generated/ams.opt.exprcalc.ExpressionCalc.v.rst +6 -0
  322. docs/source/_generated/_generated/ams.opt.expression.Expression.class_name.rst +6 -0
  323. docs/source/_generated/_generated/ams.opt.expression.Expression.e.rst +6 -0
  324. docs/source/_generated/_generated/ams.opt.expression.Expression.evaluate.rst +6 -0
  325. docs/source/_generated/_generated/ams.opt.expression.Expression.get_idx.rst +6 -0
  326. docs/source/_generated/_generated/ams.opt.expression.Expression.n.rst +6 -0
  327. docs/source/_generated/_generated/ams.opt.expression.Expression.parse.rst +6 -0
  328. docs/source/_generated/_generated/ams.opt.expression.Expression.shape.rst +6 -0
  329. docs/source/_generated/_generated/ams.opt.expression.Expression.size.rst +6 -0
  330. docs/source/_generated/_generated/ams.opt.expression.Expression.v.rst +6 -0
  331. docs/source/_generated/_generated/ams.opt.objective.Objective.class_name.rst +6 -0
  332. docs/source/_generated/_generated/ams.opt.objective.Objective.e.rst +6 -0
  333. docs/source/_generated/_generated/ams.opt.objective.Objective.evaluate.rst +6 -0
  334. docs/source/_generated/_generated/ams.opt.objective.Objective.n.rst +6 -0
  335. docs/source/_generated/_generated/ams.opt.objective.Objective.parse.rst +6 -0
  336. docs/source/_generated/_generated/ams.opt.objective.Objective.shape.rst +6 -0
  337. docs/source/_generated/_generated/ams.opt.objective.Objective.size.rst +6 -0
  338. docs/source/_generated/_generated/ams.opt.objective.Objective.v.rst +6 -0
  339. docs/source/_generated/_generated/ams.opt.omodel.OModel.class_name.rst +6 -0
  340. docs/source/_generated/_generated/ams.opt.omodel.OModel.evaluate.rst +6 -0
  341. docs/source/_generated/_generated/ams.opt.omodel.OModel.finalize.rst +6 -0
  342. docs/source/_generated/_generated/ams.opt.omodel.OModel.init.rst +6 -0
  343. docs/source/_generated/_generated/ams.opt.omodel.OModel.initialized.rst +6 -0
  344. docs/source/_generated/_generated/ams.opt.omodel.OModel.parse.rst +6 -0
  345. docs/source/_generated/_generated/ams.opt.omodel.OModel.update.rst +6 -0
  346. docs/source/_generated/_generated/ams.opt.omodel.OModelBase.class_name.rst +6 -0
  347. docs/source/_generated/_generated/ams.opt.omodel.OModelBase.evaluate.rst +6 -0
  348. docs/source/_generated/_generated/ams.opt.omodel.OModelBase.finalize.rst +6 -0
  349. docs/source/_generated/_generated/ams.opt.omodel.OModelBase.init.rst +6 -0
  350. docs/source/_generated/_generated/ams.opt.omodel.OModelBase.initialized.rst +6 -0
  351. docs/source/_generated/_generated/ams.opt.omodel.OModelBase.parse.rst +6 -0
  352. docs/source/_generated/_generated/ams.opt.omodel.OModelBase.update.rst +6 -0
  353. docs/source/_generated/_generated/ams.opt.optbase.OptzBase.class_name.rst +6 -0
  354. docs/source/_generated/_generated/ams.opt.optbase.OptzBase.evaluate.rst +6 -0
  355. docs/source/_generated/_generated/ams.opt.optbase.OptzBase.n.rst +6 -0
  356. docs/source/_generated/_generated/ams.opt.optbase.OptzBase.parse.rst +6 -0
  357. docs/source/_generated/_generated/ams.opt.optbase.OptzBase.shape.rst +6 -0
  358. docs/source/_generated/_generated/ams.opt.optbase.OptzBase.size.rst +6 -0
  359. docs/source/_generated/_generated/ams.opt.param.Param.class_name.rst +6 -0
  360. docs/source/_generated/_generated/ams.opt.param.Param.evaluate.rst +6 -0
  361. docs/source/_generated/_generated/ams.opt.param.Param.n.rst +6 -0
  362. docs/source/_generated/_generated/ams.opt.param.Param.parse.rst +6 -0
  363. docs/source/_generated/_generated/ams.opt.param.Param.shape.rst +6 -0
  364. docs/source/_generated/_generated/ams.opt.param.Param.size.rst +6 -0
  365. docs/source/_generated/_generated/ams.opt.param.Param.update.rst +6 -0
  366. docs/source/_generated/_generated/ams.opt.var.Var.class_name.rst +6 -0
  367. docs/source/_generated/_generated/ams.opt.var.Var.evaluate.rst +6 -0
  368. docs/source/_generated/_generated/ams.opt.var.Var.get_idx.rst +6 -0
  369. docs/source/_generated/_generated/ams.opt.var.Var.n.rst +6 -0
  370. docs/source/_generated/_generated/ams.opt.var.Var.parse.rst +6 -0
  371. docs/source/_generated/_generated/ams.opt.var.Var.shape.rst +6 -0
  372. docs/source/_generated/_generated/ams.opt.var.Var.size.rst +6 -0
  373. docs/source/_generated/_generated/ams.opt.var.Var.v.rst +6 -0
  374. docs/source/_generated/_generated/ams.routines.dcopf.DCOPF.addConstrs.rst +6 -0
  375. docs/source/_generated/_generated/ams.routines.dcopf.DCOPF.addRParam.rst +6 -0
  376. docs/source/_generated/_generated/ams.routines.dcopf.DCOPF.addService.rst +6 -0
  377. docs/source/_generated/_generated/ams.routines.dcopf.DCOPF.addVars.rst +6 -0
  378. docs/source/_generated/_generated/ams.routines.dcopf.DCOPF.class_name.rst +6 -0
  379. docs/source/_generated/_generated/ams.routines.dcopf.DCOPF.dc2ac.rst +6 -0
  380. docs/source/_generated/_generated/ams.routines.dcopf.DCOPF.disable.rst +6 -0
  381. docs/source/_generated/_generated/ams.routines.dcopf.DCOPF.doc.rst +6 -0
  382. docs/source/_generated/_generated/ams.routines.dcopf.DCOPF.enable.rst +6 -0
  383. docs/source/_generated/_generated/ams.routines.dcopf.DCOPF.export_csv.rst +6 -0
  384. docs/source/_generated/_generated/ams.routines.dcopf.DCOPF.get.rst +6 -0
  385. docs/source/_generated/_generated/ams.routines.dcopf.DCOPF.init.rst +6 -0
  386. docs/source/_generated/_generated/ams.routines.dcopf.DCOPF.run.rst +6 -0
  387. docs/source/_generated/_generated/ams.routines.dcopf.DCOPF.set.rst +6 -0
  388. docs/source/_generated/_generated/ams.routines.dcopf.DCOPF.solve.rst +6 -0
  389. docs/source/_generated/_generated/ams.routines.dcopf.DCOPF.summary.rst +6 -0
  390. docs/source/_generated/_generated/ams.routines.dcopf.DCOPF.unpack.rst +6 -0
  391. docs/source/_generated/_generated/ams.routines.dcopf.DCOPF.update.rst +6 -0
  392. docs/source/_generated/_generated/ams.routines.pflow.PFlow.addConstrs.rst +6 -0
  393. docs/source/_generated/_generated/ams.routines.pflow.PFlow.addRParam.rst +6 -0
  394. docs/source/_generated/_generated/ams.routines.pflow.PFlow.addService.rst +6 -0
  395. docs/source/_generated/_generated/ams.routines.pflow.PFlow.addVars.rst +6 -0
  396. docs/source/_generated/_generated/ams.routines.pflow.PFlow.class_name.rst +6 -0
  397. docs/source/_generated/_generated/ams.routines.pflow.PFlow.dc2ac.rst +6 -0
  398. docs/source/_generated/_generated/ams.routines.pflow.PFlow.disable.rst +6 -0
  399. docs/source/_generated/_generated/ams.routines.pflow.PFlow.doc.rst +6 -0
  400. docs/source/_generated/_generated/ams.routines.pflow.PFlow.enable.rst +6 -0
  401. docs/source/_generated/_generated/ams.routines.pflow.PFlow.export_csv.rst +6 -0
  402. docs/source/_generated/_generated/ams.routines.pflow.PFlow.get.rst +6 -0
  403. docs/source/_generated/_generated/ams.routines.pflow.PFlow.init.rst +6 -0
  404. docs/source/_generated/_generated/ams.routines.pflow.PFlow.run.rst +6 -0
  405. docs/source/_generated/_generated/ams.routines.pflow.PFlow.set.rst +6 -0
  406. docs/source/_generated/_generated/ams.routines.pflow.PFlow.solve.rst +6 -0
  407. docs/source/_generated/_generated/ams.routines.pflow.PFlow.summary.rst +6 -0
  408. docs/source/_generated/_generated/ams.routines.pflow.PFlow.unpack.rst +6 -0
  409. docs/source/_generated/_generated/ams.routines.pflow.PFlow.update.rst +6 -0
  410. docs/source/_generated/_generated/ams.routines.routine.RoutineBase.addConstrs.rst +6 -0
  411. docs/source/_generated/_generated/ams.routines.routine.RoutineBase.addRParam.rst +6 -0
  412. docs/source/_generated/_generated/ams.routines.routine.RoutineBase.addService.rst +6 -0
  413. docs/source/_generated/_generated/ams.routines.routine.RoutineBase.addVars.rst +6 -0
  414. docs/source/_generated/_generated/ams.routines.routine.RoutineBase.class_name.rst +6 -0
  415. docs/source/_generated/_generated/ams.routines.routine.RoutineBase.dc2ac.rst +6 -0
  416. docs/source/_generated/_generated/ams.routines.routine.RoutineBase.disable.rst +6 -0
  417. docs/source/_generated/_generated/ams.routines.routine.RoutineBase.doc.rst +6 -0
  418. docs/source/_generated/_generated/ams.routines.routine.RoutineBase.enable.rst +6 -0
  419. docs/source/_generated/_generated/ams.routines.routine.RoutineBase.export_csv.rst +6 -0
  420. docs/source/_generated/_generated/ams.routines.routine.RoutineBase.get.rst +6 -0
  421. docs/source/_generated/_generated/ams.routines.routine.RoutineBase.init.rst +6 -0
  422. docs/source/_generated/_generated/ams.routines.routine.RoutineBase.run.rst +6 -0
  423. docs/source/_generated/_generated/ams.routines.routine.RoutineBase.set.rst +6 -0
  424. docs/source/_generated/_generated/ams.routines.routine.RoutineBase.solve.rst +6 -0
  425. docs/source/_generated/_generated/ams.routines.routine.RoutineBase.summary.rst +6 -0
  426. docs/source/_generated/_generated/ams.routines.routine.RoutineBase.unpack.rst +6 -0
  427. docs/source/_generated/_generated/ams.routines.routine.RoutineBase.update.rst +6 -0
  428. docs/source/_generated/_generated/ams.system.System.add.rst +6 -0
  429. docs/source/_generated/_generated/ams.system.System.as_dict.rst +6 -0
  430. docs/source/_generated/_generated/ams.system.System.calc_pu_coeff.rst +6 -0
  431. docs/source/_generated/_generated/ams.system.System.call_models.rst +6 -0
  432. docs/source/_generated/_generated/ams.system.System.collect_config.rst +6 -0
  433. docs/source/_generated/_generated/ams.system.System.collect_ref.rst +6 -0
  434. docs/source/_generated/_generated/ams.system.System.connectivity.rst +6 -0
  435. docs/source/_generated/_generated/ams.system.System.e_clear.rst +6 -0
  436. docs/source/_generated/_generated/ams.system.System.f_update.rst +6 -0
  437. docs/source/_generated/_generated/ams.system.System.fg_to_dae.rst +6 -0
  438. docs/source/_generated/_generated/ams.system.System.find_devices.rst +6 -0
  439. docs/source/_generated/_generated/ams.system.System.find_models.rst +6 -0
  440. docs/source/_generated/_generated/ams.system.System.from_ipysheet.rst +6 -0
  441. docs/source/_generated/_generated/ams.system.System.g_islands.rst +6 -0
  442. docs/source/_generated/_generated/ams.system.System.g_update.rst +6 -0
  443. docs/source/_generated/_generated/ams.system.System.get_z.rst +6 -0
  444. docs/source/_generated/_generated/ams.system.System.import_groups.rst +6 -0
  445. docs/source/_generated/_generated/ams.system.System.import_models.rst +6 -0
  446. docs/source/_generated/_generated/ams.system.System.import_routines.rst +6 -0
  447. docs/source/_generated/_generated/ams.system.System.import_types.rst +6 -0
  448. docs/source/_generated/_generated/ams.system.System.init.rst +6 -0
  449. docs/source/_generated/_generated/ams.system.System.j_islands.rst +6 -0
  450. docs/source/_generated/_generated/ams.system.System.j_update.rst +6 -0
  451. docs/source/_generated/_generated/ams.system.System.l_update_eq.rst +6 -0
  452. docs/source/_generated/_generated/ams.system.System.l_update_var.rst +6 -0
  453. docs/source/_generated/_generated/ams.system.System.link_ext_param.rst +6 -0
  454. docs/source/_generated/_generated/ams.system.System.precompile.rst +6 -0
  455. docs/source/_generated/_generated/ams.system.System.prepare.rst +6 -0
  456. docs/source/_generated/_generated/ams.system.System.reload.rst +6 -0
  457. docs/source/_generated/_generated/ams.system.System.remove_pycapsule.rst +6 -0
  458. docs/source/_generated/_generated/ams.system.System.report.rst +6 -0
  459. docs/source/_generated/_generated/ams.system.System.reset.rst +6 -0
  460. docs/source/_generated/_generated/ams.system.System.s_update_post.rst +6 -0
  461. docs/source/_generated/_generated/ams.system.System.s_update_var.rst +6 -0
  462. docs/source/_generated/_generated/ams.system.System.save_config.rst +6 -0
  463. docs/source/_generated/_generated/ams.system.System.set_address.rst +6 -0
  464. docs/source/_generated/_generated/ams.system.System.set_config.rst +6 -0
  465. docs/source/_generated/_generated/ams.system.System.set_dae_names.rst +6 -0
  466. docs/source/_generated/_generated/ams.system.System.set_output_subidx.rst +6 -0
  467. docs/source/_generated/_generated/ams.system.System.set_var_arrays.rst +6 -0
  468. docs/source/_generated/_generated/ams.system.System.setup.rst +6 -0
  469. docs/source/_generated/_generated/ams.system.System.store_adder_setter.rst +6 -0
  470. docs/source/_generated/_generated/ams.system.System.store_existing.rst +6 -0
  471. docs/source/_generated/_generated/ams.system.System.store_no_check_init.rst +6 -0
  472. docs/source/_generated/_generated/ams.system.System.store_sparse_pattern.rst +6 -0
  473. docs/source/_generated/_generated/ams.system.System.store_switch_times.rst +6 -0
  474. docs/source/_generated/_generated/ams.system.System.summary.rst +6 -0
  475. docs/source/_generated/_generated/ams.system.System.supported_models.rst +6 -0
  476. docs/source/_generated/_generated/ams.system.System.supported_routines.rst +6 -0
  477. docs/source/_generated/_generated/ams.system.System.switch_action.rst +6 -0
  478. docs/source/_generated/_generated/ams.system.System.to_andes.rst +6 -0
  479. docs/source/_generated/_generated/ams.system.System.to_ipysheet.rst +6 -0
  480. docs/source/_generated/_generated/ams.system.System.undill.rst +6 -0
  481. docs/source/_generated/_generated/ams.system.System.vars_to_dae.rst +6 -0
  482. docs/source/_generated/_generated/ams.system.System.vars_to_models.rst +6 -0
  483. docs/source/_generated/_generated/ams.utils.paths.DisplayablePath.display_filename_prefix_last.rst +6 -0
  484. docs/source/_generated/_generated/ams.utils.paths.DisplayablePath.display_filename_prefix_middle.rst +6 -0
  485. docs/source/_generated/_generated/ams.utils.paths.DisplayablePath.display_parent_prefix_last.rst +6 -0
  486. docs/source/_generated/_generated/ams.utils.paths.DisplayablePath.display_parent_prefix_middle.rst +6 -0
  487. docs/source/_generated/_generated/ams.utils.paths.DisplayablePath.displayable.rst +6 -0
  488. docs/source/_generated/_generated/ams.utils.paths.DisplayablePath.displayname.rst +6 -0
  489. docs/source/_generated/_generated/ams.utils.paths.DisplayablePath.make_tree.rst +6 -0
  490. docs/source/_generated/ams.cli.create_parser.rst +6 -0
  491. docs/source/_generated/ams.cli.main.rst +6 -0
  492. docs/source/_generated/ams.cli.preamble.rst +6 -0
  493. docs/source/_generated/ams.cli.rst +32 -0
  494. docs/source/_generated/ams.core.model.Model.rst +56 -0
  495. docs/source/_generated/ams.core.model.rst +30 -0
  496. docs/source/_generated/ams.core.param.RParam.rst +49 -0
  497. docs/source/_generated/ams.core.param.rst +30 -0
  498. docs/source/_generated/ams.core.service.LoadScale.rst +51 -0
  499. docs/source/_generated/ams.core.service.MinDur.rst +53 -0
  500. docs/source/_generated/ams.core.service.NumExpandDim.rst +53 -0
  501. docs/source/_generated/ams.core.service.NumHstack.rst +53 -0
  502. docs/source/_generated/ams.core.service.NumOp.rst +53 -0
  503. docs/source/_generated/ams.core.service.NumOpDual.rst +53 -0
  504. docs/source/_generated/ams.core.service.RBaseService.rst +51 -0
  505. docs/source/_generated/ams.core.service.ROperationService.rst +51 -0
  506. docs/source/_generated/ams.core.service.RampSub.rst +53 -0
  507. docs/source/_generated/ams.core.service.ValueService.rst +51 -0
  508. docs/source/_generated/ams.core.service.VarReduction.rst +53 -0
  509. docs/source/_generated/ams.core.service.VarSelect.rst +53 -0
  510. docs/source/_generated/ams.core.service.ZonalSum.rst +53 -0
  511. docs/source/_generated/ams.core.service.rst +42 -0
  512. docs/source/_generated/ams.interface.Dynamic.rst +41 -0
  513. docs/source/_generated/ams.interface.build_group_table.rst +6 -0
  514. docs/source/_generated/ams.interface.make_link_table.rst +6 -0
  515. docs/source/_generated/ams.interface.parse_addfile.rst +6 -0
  516. docs/source/_generated/ams.interface.replace_dev.rst +6 -0
  517. docs/source/_generated/ams.interface.rst +43 -0
  518. docs/source/_generated/ams.interface.sync_adsys.rst +6 -0
  519. docs/source/_generated/ams.interface.to_andes.rst +6 -0
  520. docs/source/_generated/ams.interface.verify_pf.rst +6 -0
  521. docs/source/_generated/ams.io.guess.rst +6 -0
  522. docs/source/_generated/ams.io.json.rst +30 -0
  523. docs/source/_generated/ams.io.json.write.rst +6 -0
  524. docs/source/_generated/ams.io.matpower.mpc2system.rst +6 -0
  525. docs/source/_generated/ams.io.matpower.read.rst +6 -0
  526. docs/source/_generated/ams.io.matpower.rst +33 -0
  527. docs/source/_generated/ams.io.matpower.system2mpc.rst +6 -0
  528. docs/source/_generated/ams.io.matpower.testlines.rst +6 -0
  529. docs/source/_generated/ams.io.parse.rst +6 -0
  530. docs/source/_generated/ams.io.psse.rst +23 -0
  531. docs/source/_generated/ams.io.pypower.ppc2system.rst +6 -0
  532. docs/source/_generated/ams.io.pypower.py2ppc.rst +6 -0
  533. docs/source/_generated/ams.io.pypower.read.rst +6 -0
  534. docs/source/_generated/ams.io.pypower.rst +34 -0
  535. docs/source/_generated/ams.io.pypower.system2ppc.rst +6 -0
  536. docs/source/_generated/ams.io.pypower.testlines.rst +6 -0
  537. docs/source/_generated/ams.io.rst +45 -0
  538. docs/source/_generated/ams.io.xlsx.rst +30 -0
  539. docs/source/_generated/ams.io.xlsx.write.rst +6 -0
  540. docs/source/_generated/ams.main.config_logger.rst +6 -0
  541. docs/source/_generated/ams.main.demo.rst +6 -0
  542. docs/source/_generated/ams.main.doc.rst +6 -0
  543. docs/source/_generated/ams.main.edit_conf.rst +6 -0
  544. docs/source/_generated/ams.main.find_log_path.rst +6 -0
  545. docs/source/_generated/ams.main.load.rst +6 -0
  546. docs/source/_generated/ams.main.misc.rst +6 -0
  547. docs/source/_generated/ams.main.print_license.rst +6 -0
  548. docs/source/_generated/ams.main.remove_output.rst +6 -0
  549. docs/source/_generated/ams.main.rst +44 -0
  550. docs/source/_generated/ams.main.run.rst +6 -0
  551. docs/source/_generated/ams.main.run_case.rst +6 -0
  552. docs/source/_generated/ams.main.save_conf.rst +6 -0
  553. docs/source/_generated/ams.main.selftest.rst +6 -0
  554. docs/source/_generated/ams.main.set_logger_level.rst +6 -0
  555. docs/source/_generated/ams.main.versioninfo.rst +6 -0
  556. docs/source/_generated/ams.opt.constraint.Constraint.rst +43 -0
  557. docs/source/_generated/ams.opt.constraint.rst +30 -0
  558. docs/source/_generated/ams.opt.exprcalc.ExpressionCalc.rst +46 -0
  559. docs/source/_generated/ams.opt.exprcalc.rst +30 -0
  560. docs/source/_generated/ams.opt.expression.Expression.rst +46 -0
  561. docs/source/_generated/ams.opt.expression.rst +30 -0
  562. docs/source/_generated/ams.opt.objective.Objective.rst +43 -0
  563. docs/source/_generated/ams.opt.objective.rst +30 -0
  564. docs/source/_generated/ams.opt.omodel.OModel.rst +48 -0
  565. docs/source/_generated/ams.opt.omodel.OModelBase.rst +48 -0
  566. docs/source/_generated/ams.opt.omodel.rst +31 -0
  567. docs/source/_generated/ams.opt.optbase.OptzBase.rst +41 -0
  568. docs/source/_generated/ams.opt.optbase.ensure_mats_and_parsed.rst +6 -0
  569. docs/source/_generated/ams.opt.optbase.ensure_symbols.rst +6 -0
  570. docs/source/_generated/ams.opt.optbase.rst +38 -0
  571. docs/source/_generated/ams.opt.param.Param.rst +44 -0
  572. docs/source/_generated/ams.opt.param.rst +30 -0
  573. docs/source/_generated/ams.opt.rst +40 -0
  574. docs/source/_generated/ams.opt.var.Var.rst +45 -0
  575. docs/source/_generated/ams.opt.var.rst +30 -0
  576. docs/source/_generated/ams.routines.dcopf.DCOPF.rst +83 -0
  577. docs/source/_generated/ams.routines.dcopf.rst +30 -0
  578. docs/source/_generated/ams.routines.pflow.PFlow.rst +83 -0
  579. docs/source/_generated/ams.routines.pflow.rst +30 -0
  580. docs/source/_generated/ams.routines.routine.RoutineBase.rst +83 -0
  581. docs/source/_generated/ams.routines.routine.collect_data.rst +6 -0
  582. docs/source/_generated/ams.routines.routine.initialize_data_dict.rst +6 -0
  583. docs/source/_generated/ams.routines.routine.rst +38 -0
  584. docs/source/_generated/ams.system.System.rst +189 -0
  585. docs/source/_generated/ams.system.disable_method.rst +6 -0
  586. docs/source/_generated/ams.system.disable_methods.rst +6 -0
  587. docs/source/_generated/ams.system.example.rst +6 -0
  588. docs/source/_generated/ams.system.rst +39 -0
  589. docs/source/_generated/ams.utils.paths.DisplayablePath.rst +42 -0
  590. docs/source/_generated/ams.utils.paths.ams_root.rst +6 -0
  591. docs/source/_generated/ams.utils.paths.cases_root.rst +6 -0
  592. docs/source/_generated/ams.utils.paths.confirm_overwrite.rst +6 -0
  593. docs/source/_generated/ams.utils.paths.get_case.rst +6 -0
  594. docs/source/_generated/ams.utils.paths.get_config_path.rst +6 -0
  595. docs/source/_generated/ams.utils.paths.get_dot_andes_path.rst +6 -0
  596. docs/source/_generated/ams.utils.paths.get_log_dir.rst +6 -0
  597. docs/source/_generated/ams.utils.paths.get_pkl_path.rst +6 -0
  598. docs/source/_generated/ams.utils.paths.get_pycode_path.rst +6 -0
  599. docs/source/_generated/ams.utils.paths.list_cases.rst +6 -0
  600. docs/source/_generated/ams.utils.paths.rst +47 -0
  601. docs/source/_generated/ams.utils.paths.tests_root.rst +6 -0
  602. docs/source/_templates/autosummary/base.rst +5 -0
  603. docs/source/_templates/autosummary/class.rst +35 -0
  604. docs/source/_templates/autosummary/module.rst +65 -0
  605. docs/source/_templates/autosummary/module_toctree.rst +66 -0
  606. docs/source/api.rst +102 -0
  607. docs/source/conf.py +203 -0
  608. docs/source/examples/index.rst +34 -0
  609. docs/source/genmodelref.py +61 -0
  610. docs/source/genroutineref.py +47 -0
  611. docs/source/getting_started/copyright.rst +20 -0
  612. docs/source/getting_started/formats/index.rst +20 -0
  613. docs/source/getting_started/formats/matpower.rst +183 -0
  614. docs/source/getting_started/formats/psse.rst +46 -0
  615. docs/source/getting_started/formats/pypower.rst +223 -0
  616. docs/source/getting_started/formats/xlsx.png +0 -0
  617. docs/source/getting_started/formats/xlsx.rst +23 -0
  618. docs/source/getting_started/index.rst +76 -0
  619. docs/source/getting_started/install.rst +234 -0
  620. docs/source/getting_started/overview.rst +26 -0
  621. docs/source/getting_started/testcase.rst +45 -0
  622. docs/source/getting_started/verification.rst +13 -0
  623. docs/source/groupdoc/ACLine.rst +92 -0
  624. docs/source/groupdoc/ACShort.rst +51 -0
  625. docs/source/groupdoc/ACTopology.rst +66 -0
  626. docs/source/groupdoc/Collection.rst +84 -0
  627. docs/source/groupdoc/Cost.rst +135 -0
  628. docs/source/groupdoc/DG.rst +204 -0
  629. docs/source/groupdoc/Horizon.rst +97 -0
  630. docs/source/groupdoc/Information.rst +36 -0
  631. docs/source/groupdoc/RenGen.rst +63 -0
  632. docs/source/groupdoc/Reserve.rst +135 -0
  633. docs/source/groupdoc/StaticGen.rst +229 -0
  634. docs/source/groupdoc/StaticLoad.rst +53 -0
  635. docs/source/groupdoc/StaticShunt.rst +45 -0
  636. docs/source/groupdoc/Undefined.rst +63 -0
  637. docs/source/groupdoc/VSG.rst +125 -0
  638. docs/source/images/dcopf_time.png +0 -0
  639. docs/source/images/sponsors/CURENT_Logo_NameOnTrans.png +0 -0
  640. docs/source/images/sponsors/CURENT_Logo_Transparent.png +0 -0
  641. docs/source/images/sponsors/CURENT_Logo_Transparent_Name.png +0 -0
  642. docs/source/images/sponsors/doe.png +0 -0
  643. docs/source/index.rst +108 -0
  644. docs/source/modeling/_generated/_generated/ams.opt.Constraint.class_name.rst +6 -0
  645. docs/source/modeling/_generated/_generated/ams.opt.Constraint.e.rst +6 -0
  646. docs/source/modeling/_generated/_generated/ams.opt.Constraint.evaluate.rst +6 -0
  647. docs/source/modeling/_generated/_generated/ams.opt.Constraint.n.rst +6 -0
  648. docs/source/modeling/_generated/_generated/ams.opt.Constraint.parse.rst +6 -0
  649. docs/source/modeling/_generated/_generated/ams.opt.Constraint.shape.rst +6 -0
  650. docs/source/modeling/_generated/_generated/ams.opt.Constraint.size.rst +6 -0
  651. docs/source/modeling/_generated/_generated/ams.opt.Constraint.v.rst +6 -0
  652. docs/source/modeling/_generated/_generated/ams.opt.OModel.class_name.rst +6 -0
  653. docs/source/modeling/_generated/_generated/ams.opt.OModel.evaluate.rst +6 -0
  654. docs/source/modeling/_generated/_generated/ams.opt.OModel.finalize.rst +6 -0
  655. docs/source/modeling/_generated/_generated/ams.opt.OModel.init.rst +6 -0
  656. docs/source/modeling/_generated/_generated/ams.opt.OModel.initialized.rst +6 -0
  657. docs/source/modeling/_generated/_generated/ams.opt.OModel.parse.rst +6 -0
  658. docs/source/modeling/_generated/_generated/ams.opt.OModel.update.rst +6 -0
  659. docs/source/modeling/_generated/_generated/ams.opt.Objective.class_name.rst +6 -0
  660. docs/source/modeling/_generated/_generated/ams.opt.Objective.e.rst +6 -0
  661. docs/source/modeling/_generated/_generated/ams.opt.Objective.evaluate.rst +6 -0
  662. docs/source/modeling/_generated/_generated/ams.opt.Objective.n.rst +6 -0
  663. docs/source/modeling/_generated/_generated/ams.opt.Objective.parse.rst +6 -0
  664. docs/source/modeling/_generated/_generated/ams.opt.Objective.shape.rst +6 -0
  665. docs/source/modeling/_generated/_generated/ams.opt.Objective.size.rst +6 -0
  666. docs/source/modeling/_generated/_generated/ams.opt.Objective.v.rst +6 -0
  667. docs/source/modeling/_generated/_generated/ams.opt.Var.class_name.rst +6 -0
  668. docs/source/modeling/_generated/_generated/ams.opt.Var.evaluate.rst +6 -0
  669. docs/source/modeling/_generated/_generated/ams.opt.Var.get_idx.rst +6 -0
  670. docs/source/modeling/_generated/_generated/ams.opt.Var.n.rst +6 -0
  671. docs/source/modeling/_generated/_generated/ams.opt.Var.parse.rst +6 -0
  672. docs/source/modeling/_generated/_generated/ams.opt.Var.shape.rst +6 -0
  673. docs/source/modeling/_generated/_generated/ams.opt.Var.size.rst +6 -0
  674. docs/source/modeling/_generated/_generated/ams.opt.Var.v.rst +6 -0
  675. docs/source/modeling/_generated/ams.opt.Constraint.rst +43 -0
  676. docs/source/modeling/_generated/ams.opt.OModel.rst +48 -0
  677. docs/source/modeling/_generated/ams.opt.Objective.rst +43 -0
  678. docs/source/modeling/_generated/ams.opt.Var.rst +45 -0
  679. docs/source/modeling/example.rst +159 -0
  680. docs/source/modeling/index.rst +17 -0
  681. docs/source/modeling/model.rst +210 -0
  682. docs/source/modeling/routine.rst +122 -0
  683. docs/source/modeling/system.rst +51 -0
  684. docs/source/modelref.rst +66 -0
  685. docs/source/release-notes.rst +385 -0
  686. docs/source/routineref.rst +38 -0
  687. docs/source/typedoc/ACED.rst +91 -0
  688. docs/source/typedoc/DCED.rst +1869 -0
  689. docs/source/typedoc/DCUC.rst +899 -0
  690. docs/source/typedoc/DED.rst +390 -0
  691. docs/source/typedoc/PF.rst +376 -0
  692. docs/source/typedoc/UndefinedType.rst +8 -0
  693. icebar/ips/ips.py +668 -0
  694. ltbams-1.0.0.dist-info/METADATA +231 -0
  695. ltbams-1.0.0.dist-info/RECORD +725 -0
  696. {ltbams-0.9.9.dist-info → ltbams-1.0.0.dist-info}/WHEEL +1 -1
  697. ltbams-1.0.0.dist-info/top_level.txt +5 -0
  698. tests/__init__.py +0 -0
  699. tests/test_1st_system.py +33 -0
  700. tests/test_addressing.py +40 -0
  701. tests/test_andes_mats.py +61 -0
  702. tests/test_case.py +266 -0
  703. tests/test_cli.py +34 -0
  704. tests/test_export_csv.py +89 -0
  705. tests/test_group.py +83 -0
  706. tests/test_interface.py +216 -0
  707. tests/test_io.py +32 -0
  708. tests/test_jumper.py +27 -0
  709. tests/test_known_good.py +267 -0
  710. tests/test_matp.py +437 -0
  711. tests/test_model.py +54 -0
  712. tests/test_omodel.py +119 -0
  713. tests/test_paths.py +22 -0
  714. tests/test_report.py +245 -0
  715. tests/test_repr.py +21 -0
  716. tests/test_routine.py +178 -0
  717. tests/test_rtn_dcopf.py +101 -0
  718. tests/test_rtn_dcpf.py +77 -0
  719. tests/test_rtn_ed.py +275 -0
  720. tests/test_rtn_pflow.py +219 -0
  721. tests/test_rtn_rted.py +273 -0
  722. tests/test_rtn_uc.py +248 -0
  723. tests/test_service.py +73 -0
  724. ltbams-0.9.9.dist-info/LICENSE +0 -692
  725. ltbams-0.9.9.dist-info/METADATA +0 -859
  726. ltbams-0.9.9.dist-info/RECORD +0 -14
  727. ltbams-0.9.9.dist-info/top_level.txt +0 -1
  728. {ltbams-0.9.9.dist-info → ltbams-1.0.0.dist-info}/entry_points.txt +0 -0
@@ -0,0 +1,899 @@
1
+ .. _DCUC:
2
+
3
+ ================================================================================
4
+ DCUC
5
+ ================================================================================
6
+ Type for DC-based unit commitment.
7
+
8
+ Available routines:
9
+ UC_,
10
+ UCDG_,
11
+ UCES_
12
+
13
+ .. _UC:
14
+
15
+ --------------------------------------------------------------------------------
16
+ UC
17
+ --------------------------------------------------------------------------------
18
+ DC-based unit commitment (UC):
19
+ The bilinear term in the formulation is linearized with big-M method.
20
+
21
+ Non-negative var `pdu` is introduced as unserved load with its penalty `cdp`.
22
+
23
+ Constraints include power balance, ramping, spinning reserve, non-spinning reserve,
24
+ minimum ON/OFF duration.
25
+ The cost inludes generation cost, startup cost, shutdown cost, spinning reserve cost,
26
+ non-spinning reserve cost, and unserved load penalty.
27
+
28
+ Method ``_initial_guess`` is used to make initial guess for commitment decision if all
29
+ generators are online at initial. It is a simple heuristic method, which may not be optimal.
30
+
31
+ Notes
32
+ -----
33
+ 1. Formulations has been adjusted with interval ``config.t``
34
+
35
+ 3. The tie-line flow has not been implemented in formulations.
36
+
37
+ References
38
+ ----------
39
+ 1. Huang, Y., Pardalos, P. M., & Zheng, Q. P. (2017). Electrical power unit commitment: deterministic and
40
+ two-stage stochastic programming models and algorithms. Springer.
41
+
42
+ 2. D. A. Tejada-Arango, S. Lumbreras, P. Sánchez-Martín and A. Ramos, "Which Unit-Commitment Formulation
43
+ is Best? A Comparison Framework," in IEEE Transactions on Power Systems, vol. 35, no. 4, pp. 2926-2936,
44
+ July 2020, doi: 10.1109/TPWRS.2019.2962024.
45
+
46
+ Objective
47
+ ----------------------------------
48
+
49
+ +------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
50
+ | Unit | Expression |
51
+ +======+=====================================================================================================================================================================================================================================+
52
+ | *$* | :math:`min. T_{cfg}^{2} \sum(c_{2} z_{u_{g}}^{2} + T_{cfg} c_{1} z_{u_{g}})+ \sum(u_{g} c_{0} 1_{tl}) + T_{cfg} \sum(c_{su} v_{g,d} + c_{sd} w_{g,d} + c_{sr} p_{r,s} + c_{nsr} p_{r, ns} + c_{d,p} p_{d,u})` |
53
+ +------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
54
+
55
+ Expressions
56
+ ----------------------------------
57
+
58
+ +--------+----------------+-----------------------------------------------------------------+--------+-----------+
59
+ | Name | Description | Expression | Unit | Source |
60
+ +========+================+=================================================================+========+===========+
61
+ | plf | 2D Line flow | :math:`B_{f} \theta_{bus} + P_{f}^{inj}` | *p.u.* | Line |
62
+ +--------+----------------+-----------------------------------------------------------------+--------+-----------+
63
+ | pmaxe | Effective pmax | :math:`c_{trl,n} p_{g, 0} u_{g,d} + c_{trl} p_{g, max} u_{g,d}` | *p.u.* | StaticGen |
64
+ +--------+----------------+-----------------------------------------------------------------+--------+-----------+
65
+ | pmine | Effective pmin | :math:`c_{trl} p_{g, min} u_{g,d} + c_{trl,n} p_{g, 0} u_{g,d}` | *p.u.* | StaticGen |
66
+ +--------+----------------+-----------------------------------------------------------------+--------+-----------+
67
+
68
+ Constraints
69
+ ----------------------------------
70
+
71
+ +---------+-----------------------------------+----------------------------------------------------------------------------------------------------------------------+
72
+ | Name | Description | Expression |
73
+ +=========+===================================+======================================================================================================================+
74
+ | pb | power balance | :math:`B_{bus} \theta_{bus} + P_{bus}^{inj} 1_{tl} + C_{l} (p_{d,s}-p_{d,u}) + C_{sh} g_{sh} 1_{tl} - C_{g} p_g = 0` |
75
+ +---------+-----------------------------------+----------------------------------------------------------------------------------------------------------------------+
76
+ | sbus | align slack bus angle | :math:`c_{sb} \theta_{bus} = 0` |
77
+ +---------+-----------------------------------+----------------------------------------------------------------------------------------------------------------------+
78
+ | pglb | pg min | :math:`-p_g + p_{g, min, e} \leq 0` |
79
+ +---------+-----------------------------------+----------------------------------------------------------------------------------------------------------------------+
80
+ | pgub | pg max | :math:`p_g - p_{g, max, e} \leq 0` |
81
+ +---------+-----------------------------------+----------------------------------------------------------------------------------------------------------------------+
82
+ | plflb | line flow lower bound | :math:`-B_{f} \theta_{bus} - P_{f}^{inj} - R_{ATEA} 1_{tl} \leq 0` |
83
+ +---------+-----------------------------------+----------------------------------------------------------------------------------------------------------------------+
84
+ | plfub | line flow upper bound | :math:`B_{f} \theta_{bus} + P_{f}^{inj} - R_{ATEA} 1_{tl} \leq 0` |
85
+ +---------+-----------------------------------+----------------------------------------------------------------------------------------------------------------------+
86
+ | alflb | line angle difference lower bound | :math:`-C_{ft}^T \theta_{bus} - \theta_{bus, max} 1_{tl} \leq 0` |
87
+ +---------+-----------------------------------+----------------------------------------------------------------------------------------------------------------------+
88
+ | alfub | line angle difference upper bound | :math:`C_{ft}^T \theta_{bus} - \theta_{bus, max} 1_{tl} \leq 0` |
89
+ +---------+-----------------------------------+----------------------------------------------------------------------------------------------------------------------+
90
+ | prsb | spinning reserve balance | :math:`u_{g,d} p_{g, max} 1_{tl} - z_{u_{g}} - p_{r,s} = 0` |
91
+ +---------+-----------------------------------+----------------------------------------------------------------------------------------------------------------------+
92
+ | rsr | spinning reserve requirement | :math:`-S_{g} p_{r,s} + d_{s,r,z} \leq 0` |
93
+ +---------+-----------------------------------+----------------------------------------------------------------------------------------------------------------------+
94
+ | prnsb | non-spinning reserve balance | :math:`1-u_{g,d} p_{g, max} 1_{tl} - p_{r, ns} = 0` |
95
+ +---------+-----------------------------------+----------------------------------------------------------------------------------------------------------------------+
96
+ | rnsr | non-spinning reserve requirement | :math:`-S_{g} p_{r, ns} + d_{nsr} \leq 0` |
97
+ +---------+-----------------------------------+----------------------------------------------------------------------------------------------------------------------+
98
+ | actv | startup action | :math:`u_{g,d} M_{r} - v_{g,d}[:, 1:] = 0` |
99
+ +---------+-----------------------------------+----------------------------------------------------------------------------------------------------------------------+
100
+ | actv0 | initial startup action | :math:`u_{g,d}[:, 0] - u_{g}[:, 0] - v_{g,d}[:, 0] = 0` |
101
+ +---------+-----------------------------------+----------------------------------------------------------------------------------------------------------------------+
102
+ | actw | shutdown action | :math:`-u_{g,d} M_{r} - w_{g,d}[:, 1:] = 0` |
103
+ +---------+-----------------------------------+----------------------------------------------------------------------------------------------------------------------+
104
+ | actw0 | initial shutdown action | :math:`-u_{g,d}[:, 0] + u_{g}[:, 0] - w_{g,d}[:, 0] = 0` |
105
+ +---------+-----------------------------------+----------------------------------------------------------------------------------------------------------------------+
106
+ | zuglb | zug lower bound | :math:`- z_{u_{g}} + p_g \leq 0` |
107
+ +---------+-----------------------------------+----------------------------------------------------------------------------------------------------------------------+
108
+ | zugub | zug upper bound | :math:`z_{u_{g}} - p_g - M_{zug} (1 - u_{g,d}) \leq 0` |
109
+ +---------+-----------------------------------+----------------------------------------------------------------------------------------------------------------------+
110
+ | zugub2 | zug upper bound | :math:`z_{u_{g}} - M_{zug} u_{g,d} \leq 0` |
111
+ +---------+-----------------------------------+----------------------------------------------------------------------------------------------------------------------+
112
+ | don | minimum online duration | :math:`T_{on} v_{g,d} - u_{g,d} \leq 0` |
113
+ +---------+-----------------------------------+----------------------------------------------------------------------------------------------------------------------+
114
+ | doff | minimum offline duration | :math:`T_{off} w_{g,d} - (1 - u_{g,d}) \leq 0` |
115
+ +---------+-----------------------------------+----------------------------------------------------------------------------------------------------------------------+
116
+ | pdumax | unserved demand upper bound | :math:`p_{d,u} - p_{d,s}^{+} c_{trl,d} 1_{tl} \leq 0` |
117
+ +---------+-----------------------------------+----------------------------------------------------------------------------------------------------------------------+
118
+
119
+ Vars
120
+ ----------------------------------
121
+
122
+ +-------+----------------------+-----------------------------------------+--------+-------------+------------+
123
+ | Name | Symbol | Description | Unit | Source | Properties |
124
+ +=======+======================+=========================================+========+=============+============+
125
+ | pg | :math:`p_g` | 2D Gen power | *p.u.* | StaticGen.p | |
126
+ +-------+----------------------+-----------------------------------------+--------+-------------+------------+
127
+ | vBus | :math:`v_{Bus}` | 2D Bus voltage | *p.u.* | Bus.v | |
128
+ +-------+----------------------+-----------------------------------------+--------+-------------+------------+
129
+ | aBus | :math:`\theta_{bus}` | 2D Bus angle | *rad* | Bus.a | |
130
+ +-------+----------------------+-----------------------------------------+--------+-------------+------------+
131
+ | prs | :math:`p_{r,s}` | 2D Spinning reserve | *p.u.* | StaticGen | nonneg |
132
+ +-------+----------------------+-----------------------------------------+--------+-------------+------------+
133
+ | prns | :math:`p_{r, ns}` | 2D Non-spinning reserve | | StaticGen | nonneg |
134
+ +-------+----------------------+-----------------------------------------+--------+-------------+------------+
135
+ | ugd | :math:`u_{g,d}` | commitment decision | | StaticGen.u | boolean |
136
+ +-------+----------------------+-----------------------------------------+--------+-------------+------------+
137
+ | vgd | :math:`v_{g,d}` | startup action | | StaticGen.u | boolean |
138
+ +-------+----------------------+-----------------------------------------+--------+-------------+------------+
139
+ | wgd | :math:`w_{g,d}` | shutdown action | | StaticGen.u | boolean |
140
+ +-------+----------------------+-----------------------------------------+--------+-------------+------------+
141
+ | zug | :math:`z_{ug}` | Aux var, :math:`z_{ug} = u_{g,d} * p_g` | | StaticGen | pos |
142
+ +-------+----------------------+-----------------------------------------+--------+-------------+------------+
143
+ | pdu | :math:`p_{d,u}` | unserved demand | *p.u.* | StaticLoad | nonneg |
144
+ +-------+----------------------+-----------------------------------------+--------+-------------+------------+
145
+
146
+ ExpressionCalcs
147
+ ----------------------------------
148
+
149
+ +------+-------------------+------------------+----------+--------+
150
+ | Name | Description | Expression | Unit | Source |
151
+ +======+===================+==================+==========+========+
152
+ | pi | LMP, dual of <pb> | :math:`\phi[pb]` | *$/p.u.* | Bus |
153
+ +------+-------------------+------------------+----------+--------+
154
+
155
+ Services
156
+ ---------
157
+
158
+ +---------+-----------------------+------------------------------------------------------+-----------+
159
+ | Name | Symbol | Description | Type |
160
+ +=========+=======================+======================================================+===========+
161
+ | csb | :math:`c_{sb}` | select slack bus | VarSelect |
162
+ +---------+-----------------------+------------------------------------------------------+-----------+
163
+ | ctrle | :math:`c_{trl, e}` | Reshaped controllability | NumOpDual |
164
+ +---------+-----------------------+------------------------------------------------------+-----------+
165
+ | nctrl | :math:`c_{trl,n}` | Effective Gen uncontrollability | NumOp |
166
+ +---------+-----------------------+------------------------------------------------------+-----------+
167
+ | nctrle | :math:`c_{trl,n,e}` | Reshaped non-controllability | NumOpDual |
168
+ +---------+-----------------------+------------------------------------------------------+-----------+
169
+ | gs | :math:`S_{g}` | Sum Gen vars vector in shape of zone | ZonalSum |
170
+ +---------+-----------------------+------------------------------------------------------+-----------+
171
+ | ds | :math:`S_{d}` | Sum pd vector in shape of zone | ZonalSum |
172
+ +---------+-----------------------+------------------------------------------------------+-----------+
173
+ | pdz | :math:`p_{d,z}` | zonal total load | NumOpDual |
174
+ +---------+-----------------------+------------------------------------------------------+-----------+
175
+ | tlv | :math:`1_{tl}` | time length vector | NumOp |
176
+ +---------+-----------------------+------------------------------------------------------+-----------+
177
+ | pds | :math:`p_{d,s}` | Scaled load | LoadScale |
178
+ +---------+-----------------------+------------------------------------------------------+-----------+
179
+ | Mr | :math:`M_{r}` | Subtraction matrix for ramping | RampSub |
180
+ +---------+-----------------------+------------------------------------------------------+-----------+
181
+ | RR30 | :math:`R_{30,R}` | Repeated ramp rate | NumHstack |
182
+ +---------+-----------------------+------------------------------------------------------+-----------+
183
+ | dsrpz | :math:`d_{s,r, p, z}` | zonal spinning reserve requirement in percentage | NumOpDual |
184
+ +---------+-----------------------+------------------------------------------------------+-----------+
185
+ | dsr | :math:`d_{s,r,z}` | zonal spinning reserve requirement | NumOpDual |
186
+ +---------+-----------------------+------------------------------------------------------+-----------+
187
+ | dnsrpz | :math:`d_{nsr, p, z}` | zonal non-spinning reserve requirement in percentage | NumOpDual |
188
+ +---------+-----------------------+------------------------------------------------------+-----------+
189
+ | dnsr | :math:`d_{nsr}` | zonal non-spinning reserve requirement | NumOpDual |
190
+ +---------+-----------------------+------------------------------------------------------+-----------+
191
+ | Mzug | :math:`M_{zug}` | 10 times of max of pmax as big M for zug | NumOp |
192
+ +---------+-----------------------+------------------------------------------------------+-----------+
193
+ | Con | :math:`T_{on}` | minimum ON coefficient | MinDur |
194
+ +---------+-----------------------+------------------------------------------------------+-----------+
195
+ | Coff | :math:`T_{off}` | minimum OFF coefficient | MinDur |
196
+ +---------+-----------------------+------------------------------------------------------+-----------+
197
+ | pdsp | :math:`p_{d,s}^{+}` | positive demand | NumOp |
198
+ +---------+-----------------------+------------------------------------------------------+-----------+
199
+
200
+ Parameters
201
+ ----------------------------------
202
+
203
+ +-----------+---------------------------+------------------------------------------------+--------------+----------------------+
204
+ | Name | Symbol | Description | Unit | Source |
205
+ +===========+===========================+================================================+==============+======================+
206
+ | ug | :math:`u_{g}` | Gen connection status | | StaticGen.u |
207
+ +-----------+---------------------------+------------------------------------------------+--------------+----------------------+
208
+ | pg0 | :math:`p_{g, 0}` | Gen initial active power | *p.u.* | StaticGen.p0 |
209
+ +-----------+---------------------------+------------------------------------------------+--------------+----------------------+
210
+ | gsh | :math:`g_{sh}` | shunt conductance | | Shunt.g |
211
+ +-----------+---------------------------+------------------------------------------------+--------------+----------------------+
212
+ | buss | :math:`B_{us,s}` | Bus slack | | Slack.bus |
213
+ +-----------+---------------------------+------------------------------------------------+--------------+----------------------+
214
+ | pd | :math:`p_{d}` | active demand | *p.u.* | StaticLoad.p0 |
215
+ +-----------+---------------------------+------------------------------------------------+--------------+----------------------+
216
+ | Cg | :math:`C_{g}` | Gen connection matrix | | MatProcessor.Cg |
217
+ +-----------+---------------------------+------------------------------------------------+--------------+----------------------+
218
+ | Cl | :math:`C_{l}` | Load connection matrix | | MatProcessor.Cl |
219
+ +-----------+---------------------------+------------------------------------------------+--------------+----------------------+
220
+ | CftT | :math:`C_{ft}^T` | Transpose of line connection matrix | | MatProcessor.CftT |
221
+ +-----------+---------------------------+------------------------------------------------+--------------+----------------------+
222
+ | Csh | :math:`C_{sh}` | Shunt connection matrix | | MatProcessor.Csh |
223
+ +-----------+---------------------------+------------------------------------------------+--------------+----------------------+
224
+ | Bbus | :math:`B_{bus}` | Bus admittance matrix | | MatProcessor.Bbus |
225
+ +-----------+---------------------------+------------------------------------------------+--------------+----------------------+
226
+ | Bf | :math:`B_{f}` | Bf matrix | | MatProcessor.Bf |
227
+ +-----------+---------------------------+------------------------------------------------+--------------+----------------------+
228
+ | Pbusinj | :math:`P_{bus}^{inj}` | Bus power injection vector | | MatProcessor.Pbusinj |
229
+ +-----------+---------------------------+------------------------------------------------+--------------+----------------------+
230
+ | Pfinj | :math:`P_{f}^{inj}` | Line power injection vector | | MatProcessor.Pfinj |
231
+ +-----------+---------------------------+------------------------------------------------+--------------+----------------------+
232
+ | c2 | :math:`c_{2}` | Gen cost coefficient 2 | *$/(p.u.^2)* | GCost.c2 |
233
+ +-----------+---------------------------+------------------------------------------------+--------------+----------------------+
234
+ | c1 | :math:`c_{1}` | Gen cost coefficient 1 | *$/(p.u.)* | GCost.c1 |
235
+ +-----------+---------------------------+------------------------------------------------+--------------+----------------------+
236
+ | c0 | :math:`c_{0}` | Gen cost coefficient 0 | *$* | GCost.c0 |
237
+ +-----------+---------------------------+------------------------------------------------+--------------+----------------------+
238
+ | ctrl | :math:`c_{trl}` | Gen controllability | | StaticGen.ctrl |
239
+ +-----------+---------------------------+------------------------------------------------+--------------+----------------------+
240
+ | pmax | :math:`p_{g, max}` | Gen maximum active power | *p.u.* | StaticGen.pmax |
241
+ +-----------+---------------------------+------------------------------------------------+--------------+----------------------+
242
+ | pmin | :math:`p_{g, min}` | Gen minimum active power | *p.u.* | StaticGen.pmin |
243
+ +-----------+---------------------------+------------------------------------------------+--------------+----------------------+
244
+ | ul | :math:`u_{l}` | Line connection status | | Line.u |
245
+ +-----------+---------------------------+------------------------------------------------+--------------+----------------------+
246
+ | rate_a | :math:`R_{ATEA}` | long-term flow limit | *p.u.* | Line.rate_a |
247
+ +-----------+---------------------------+------------------------------------------------+--------------+----------------------+
248
+ | amax | :math:`\theta_{bus, max}` | max line angle difference | | Line.amax |
249
+ +-----------+---------------------------+------------------------------------------------+--------------+----------------------+
250
+ | amin | :math:`\theta_{bus, min}` | min line angle difference | | Line.amin |
251
+ +-----------+---------------------------+------------------------------------------------+--------------+----------------------+
252
+ | zg | :math:`z_{one,g}` | Gen zone | | StaticGen.zone |
253
+ +-----------+---------------------------+------------------------------------------------+--------------+----------------------+
254
+ | zd | :math:`z_{one,d}` | Load zone | | StaticLoad.zone |
255
+ +-----------+---------------------------+------------------------------------------------+--------------+----------------------+
256
+ | R10 | :math:`R_{10}` | 10-min ramp rate | *p.u./h* | StaticGen.R10 |
257
+ +-----------+---------------------------+------------------------------------------------+--------------+----------------------+
258
+ | sd | :math:`s_{d}` | zonal load factor for UC | | UCTSlot.sd |
259
+ +-----------+---------------------------+------------------------------------------------+--------------+----------------------+
260
+ | timeslot | :math:`t_{s,idx}` | Time slot for multi-period UC | | UCTSlot.idx |
261
+ +-----------+---------------------------+------------------------------------------------+--------------+----------------------+
262
+ | R30 | :math:`R_{30}` | 30-min ramp rate | *p.u./h* | StaticGen.R30 |
263
+ +-----------+---------------------------+------------------------------------------------+--------------+----------------------+
264
+ | dsr | :math:`d_{sr}` | spinning reserve requirement in percentage | *%* | SR.demand |
265
+ +-----------+---------------------------+------------------------------------------------+--------------+----------------------+
266
+ | csr | :math:`c_{sr}` | cost for spinning reserve | *$/(p.u.*h)* | SRCost.csr |
267
+ +-----------+---------------------------+------------------------------------------------+--------------+----------------------+
268
+ | cnsr | :math:`c_{nsr}` | cost for non-spinning reserve | *$/(p.u.*h)* | NSRCost.cnsr |
269
+ +-----------+---------------------------+------------------------------------------------+--------------+----------------------+
270
+ | dnsr | :math:`d_{nsr}` | non-spinning reserve requirement in percentage | *%* | NSR.demand |
271
+ +-----------+---------------------------+------------------------------------------------+--------------+----------------------+
272
+ | csu | :math:`c_{su}` | startup cost | *$* | GCost.csu |
273
+ +-----------+---------------------------+------------------------------------------------+--------------+----------------------+
274
+ | csd | :math:`c_{sd}` | shutdown cost | *$* | GCost.csd |
275
+ +-----------+---------------------------+------------------------------------------------+--------------+----------------------+
276
+ | cdp | :math:`c_{d,p}` | penalty for unserved load | *$/(p.u.*h)* | DCost.cdp |
277
+ +-----------+---------------------------+------------------------------------------------+--------------+----------------------+
278
+ | dctrl | :math:`c_{trl,d}` | load controllability | | StaticLoad.ctrl |
279
+ +-----------+---------------------------+------------------------------------------------+--------------+----------------------+
280
+ | td1 | :math:`t_{d1}` | minimum ON duration | *h* | StaticGen.td1 |
281
+ +-----------+---------------------------+------------------------------------------------+--------------+----------------------+
282
+ | td2 | :math:`t_{d2}` | minimum OFF duration | *h* | StaticGen.td2 |
283
+ +-----------+---------------------------+------------------------------------------------+--------------+----------------------+
284
+
285
+
286
+ Config Fields in [UC]
287
+
288
+ +--------+-----------------+-------+------------------------+-----------------+
289
+ | Option | Symbol | Value | Info | Accepted values |
290
+ +========+=================+=======+========================+=================+
291
+ | t | :math:`T_{cfg}` | 1 | time interval in hours | |
292
+ +--------+-----------------+-------+------------------------+-----------------+
293
+
294
+
295
+ .. _UCDG:
296
+
297
+ --------------------------------------------------------------------------------
298
+ UCDG
299
+ --------------------------------------------------------------------------------
300
+ UC with distributed generation :ref:`DG`.
301
+
302
+ Note that UCDG only inlcudes DG output power. If ESD1 is included,
303
+ UCES should be used instead, otherwise there is no SOC.
304
+
305
+ Objective
306
+ ----------------------------------
307
+
308
+ +------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
309
+ | Unit | Expression |
310
+ +======+=====================================================================================================================================================================================================================================+
311
+ | *$* | :math:`min. T_{cfg}^{2} \sum(c_{2} z_{u_{g}}^{2} + T_{cfg} c_{1} z_{u_{g}})+ \sum(u_{g} c_{0} 1_{tl}) + T_{cfg} \sum(c_{su} v_{g,d} + c_{sd} w_{g,d} + c_{sr} p_{r,s} + c_{nsr} p_{r, ns} + c_{d,p} p_{d,u})` |
312
+ +------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
313
+
314
+ Expressions
315
+ ----------------------------------
316
+
317
+ +--------+----------------+-----------------------------------------------------------------+--------+-----------+
318
+ | Name | Description | Expression | Unit | Source |
319
+ +========+================+=================================================================+========+===========+
320
+ | plf | 2D Line flow | :math:`B_{f} \theta_{bus} + P_{f}^{inj}` | *p.u.* | Line |
321
+ +--------+----------------+-----------------------------------------------------------------+--------+-----------+
322
+ | pmaxe | Effective pmax | :math:`c_{trl,n} p_{g, 0} u_{g,d} + c_{trl} p_{g, max} u_{g,d}` | *p.u.* | StaticGen |
323
+ +--------+----------------+-----------------------------------------------------------------+--------+-----------+
324
+ | pmine | Effective pmin | :math:`c_{trl} p_{g, min} u_{g,d} + c_{trl,n} p_{g, 0} u_{g,d}` | *p.u.* | StaticGen |
325
+ +--------+----------------+-----------------------------------------------------------------+--------+-----------+
326
+
327
+ Constraints
328
+ ----------------------------------
329
+
330
+ +---------+-----------------------------------+----------------------------------------------------------------------------------------------------------------------+
331
+ | Name | Description | Expression |
332
+ +=========+===================================+======================================================================================================================+
333
+ | pb | power balance | :math:`B_{bus} \theta_{bus} + P_{bus}^{inj} 1_{tl} + C_{l} (p_{d,s}-p_{d,u}) + C_{sh} g_{sh} 1_{tl} - C_{g} p_g = 0` |
334
+ +---------+-----------------------------------+----------------------------------------------------------------------------------------------------------------------+
335
+ | sbus | align slack bus angle | :math:`c_{sb} \theta_{bus} = 0` |
336
+ +---------+-----------------------------------+----------------------------------------------------------------------------------------------------------------------+
337
+ | pglb | pg min | :math:`-p_g + p_{g, min, e} \leq 0` |
338
+ +---------+-----------------------------------+----------------------------------------------------------------------------------------------------------------------+
339
+ | pgub | pg max | :math:`p_g - p_{g, max, e} \leq 0` |
340
+ +---------+-----------------------------------+----------------------------------------------------------------------------------------------------------------------+
341
+ | plflb | line flow lower bound | :math:`-B_{f} \theta_{bus} - P_{f}^{inj} - R_{ATEA} 1_{tl} \leq 0` |
342
+ +---------+-----------------------------------+----------------------------------------------------------------------------------------------------------------------+
343
+ | plfub | line flow upper bound | :math:`B_{f} \theta_{bus} + P_{f}^{inj} - R_{ATEA} 1_{tl} \leq 0` |
344
+ +---------+-----------------------------------+----------------------------------------------------------------------------------------------------------------------+
345
+ | alflb | line angle difference lower bound | :math:`-C_{ft}^T \theta_{bus} - \theta_{bus, max} 1_{tl} \leq 0` |
346
+ +---------+-----------------------------------+----------------------------------------------------------------------------------------------------------------------+
347
+ | alfub | line angle difference upper bound | :math:`C_{ft}^T \theta_{bus} - \theta_{bus, max} 1_{tl} \leq 0` |
348
+ +---------+-----------------------------------+----------------------------------------------------------------------------------------------------------------------+
349
+ | prsb | spinning reserve balance | :math:`u_{g,d} p_{g, max} 1_{tl} - z_{u_{g}} - p_{r,s} = 0` |
350
+ +---------+-----------------------------------+----------------------------------------------------------------------------------------------------------------------+
351
+ | rsr | spinning reserve requirement | :math:`-S_{g} p_{r,s} + d_{s,r,z} \leq 0` |
352
+ +---------+-----------------------------------+----------------------------------------------------------------------------------------------------------------------+
353
+ | prnsb | non-spinning reserve balance | :math:`1-u_{g,d} p_{g, max} 1_{tl} - p_{r, ns} = 0` |
354
+ +---------+-----------------------------------+----------------------------------------------------------------------------------------------------------------------+
355
+ | rnsr | non-spinning reserve requirement | :math:`-S_{g} p_{r, ns} + d_{nsr} \leq 0` |
356
+ +---------+-----------------------------------+----------------------------------------------------------------------------------------------------------------------+
357
+ | actv | startup action | :math:`u_{g,d} M_{r} - v_{g,d}[:, 1:] = 0` |
358
+ +---------+-----------------------------------+----------------------------------------------------------------------------------------------------------------------+
359
+ | actv0 | initial startup action | :math:`u_{g,d}[:, 0] - u_{g}[:, 0] - v_{g,d}[:, 0] = 0` |
360
+ +---------+-----------------------------------+----------------------------------------------------------------------------------------------------------------------+
361
+ | actw | shutdown action | :math:`-u_{g,d} M_{r} - w_{g,d}[:, 1:] = 0` |
362
+ +---------+-----------------------------------+----------------------------------------------------------------------------------------------------------------------+
363
+ | actw0 | initial shutdown action | :math:`-u_{g,d}[:, 0] + u_{g}[:, 0] - w_{g,d}[:, 0] = 0` |
364
+ +---------+-----------------------------------+----------------------------------------------------------------------------------------------------------------------+
365
+ | zuglb | zug lower bound | :math:`- z_{u_{g}} + p_g \leq 0` |
366
+ +---------+-----------------------------------+----------------------------------------------------------------------------------------------------------------------+
367
+ | zugub | zug upper bound | :math:`z_{u_{g}} - p_g - M_{zug} (1 - u_{g,d}) \leq 0` |
368
+ +---------+-----------------------------------+----------------------------------------------------------------------------------------------------------------------+
369
+ | zugub2 | zug upper bound | :math:`z_{u_{g}} - M_{zug} u_{g,d} \leq 0` |
370
+ +---------+-----------------------------------+----------------------------------------------------------------------------------------------------------------------+
371
+ | don | minimum online duration | :math:`T_{on} v_{g,d} - u_{g,d} \leq 0` |
372
+ +---------+-----------------------------------+----------------------------------------------------------------------------------------------------------------------+
373
+ | doff | minimum offline duration | :math:`T_{off} w_{g,d} - (1 - u_{g,d}) \leq 0` |
374
+ +---------+-----------------------------------+----------------------------------------------------------------------------------------------------------------------+
375
+ | pdumax | unserved demand upper bound | :math:`p_{d,u} - p_{d,s}^{+} c_{trl,d} 1_{tl} \leq 0` |
376
+ +---------+-----------------------------------+----------------------------------------------------------------------------------------------------------------------+
377
+ | cdgb | Select DG power from pg | :math:`C_{DG} p_g - p_{g,DG} = 0` |
378
+ +---------+-----------------------------------+----------------------------------------------------------------------------------------------------------------------+
379
+
380
+ Vars
381
+ ----------------------------------
382
+
383
+ +-------+----------------------+-----------------------------------------+--------+-------------+------------+
384
+ | Name | Symbol | Description | Unit | Source | Properties |
385
+ +=======+======================+=========================================+========+=============+============+
386
+ | pg | :math:`p_g` | 2D Gen power | *p.u.* | StaticGen.p | |
387
+ +-------+----------------------+-----------------------------------------+--------+-------------+------------+
388
+ | vBus | :math:`v_{Bus}` | 2D Bus voltage | *p.u.* | Bus.v | |
389
+ +-------+----------------------+-----------------------------------------+--------+-------------+------------+
390
+ | aBus | :math:`\theta_{bus}` | 2D Bus angle | *rad* | Bus.a | |
391
+ +-------+----------------------+-----------------------------------------+--------+-------------+------------+
392
+ | prs | :math:`p_{r,s}` | 2D Spinning reserve | *p.u.* | StaticGen | nonneg |
393
+ +-------+----------------------+-----------------------------------------+--------+-------------+------------+
394
+ | prns | :math:`p_{r, ns}` | 2D Non-spinning reserve | | StaticGen | nonneg |
395
+ +-------+----------------------+-----------------------------------------+--------+-------------+------------+
396
+ | ugd | :math:`u_{g,d}` | commitment decision | | StaticGen.u | boolean |
397
+ +-------+----------------------+-----------------------------------------+--------+-------------+------------+
398
+ | vgd | :math:`v_{g,d}` | startup action | | StaticGen.u | boolean |
399
+ +-------+----------------------+-----------------------------------------+--------+-------------+------------+
400
+ | wgd | :math:`w_{g,d}` | shutdown action | | StaticGen.u | boolean |
401
+ +-------+----------------------+-----------------------------------------+--------+-------------+------------+
402
+ | zug | :math:`z_{ug}` | Aux var, :math:`z_{ug} = u_{g,d} * p_g` | | StaticGen | pos |
403
+ +-------+----------------------+-----------------------------------------+--------+-------------+------------+
404
+ | pdu | :math:`p_{d,u}` | unserved demand | *p.u.* | StaticLoad | nonneg |
405
+ +-------+----------------------+-----------------------------------------+--------+-------------+------------+
406
+ | pgdg | :math:`p_{g,DG}` | DG output power | *p.u.* | DG | |
407
+ +-------+----------------------+-----------------------------------------+--------+-------------+------------+
408
+
409
+ ExpressionCalcs
410
+ ----------------------------------
411
+
412
+ +------+-------------------+------------------+----------+--------+
413
+ | Name | Description | Expression | Unit | Source |
414
+ +======+===================+==================+==========+========+
415
+ | pi | LMP, dual of <pb> | :math:`\phi[pb]` | *$/p.u.* | Bus |
416
+ +------+-------------------+------------------+----------+--------+
417
+
418
+ Services
419
+ ---------
420
+
421
+ +---------+-----------------------+------------------------------------------------------+-----------+
422
+ | Name | Symbol | Description | Type |
423
+ +=========+=======================+======================================================+===========+
424
+ | csb | :math:`c_{sb}` | select slack bus | VarSelect |
425
+ +---------+-----------------------+------------------------------------------------------+-----------+
426
+ | ctrle | :math:`c_{trl, e}` | Reshaped controllability | NumOpDual |
427
+ +---------+-----------------------+------------------------------------------------------+-----------+
428
+ | nctrl | :math:`c_{trl,n}` | Effective Gen uncontrollability | NumOp |
429
+ +---------+-----------------------+------------------------------------------------------+-----------+
430
+ | nctrle | :math:`c_{trl,n,e}` | Reshaped non-controllability | NumOpDual |
431
+ +---------+-----------------------+------------------------------------------------------+-----------+
432
+ | gs | :math:`S_{g}` | Sum Gen vars vector in shape of zone | ZonalSum |
433
+ +---------+-----------------------+------------------------------------------------------+-----------+
434
+ | ds | :math:`S_{d}` | Sum pd vector in shape of zone | ZonalSum |
435
+ +---------+-----------------------+------------------------------------------------------+-----------+
436
+ | pdz | :math:`p_{d,z}` | zonal total load | NumOpDual |
437
+ +---------+-----------------------+------------------------------------------------------+-----------+
438
+ | tlv | :math:`1_{tl}` | time length vector | NumOp |
439
+ +---------+-----------------------+------------------------------------------------------+-----------+
440
+ | pds | :math:`p_{d,s}` | Scaled load | LoadScale |
441
+ +---------+-----------------------+------------------------------------------------------+-----------+
442
+ | Mr | :math:`M_{r}` | Subtraction matrix for ramping | RampSub |
443
+ +---------+-----------------------+------------------------------------------------------+-----------+
444
+ | RR30 | :math:`R_{30,R}` | Repeated ramp rate | NumHstack |
445
+ +---------+-----------------------+------------------------------------------------------+-----------+
446
+ | dsrpz | :math:`d_{s,r, p, z}` | zonal spinning reserve requirement in percentage | NumOpDual |
447
+ +---------+-----------------------+------------------------------------------------------+-----------+
448
+ | dsr | :math:`d_{s,r,z}` | zonal spinning reserve requirement | NumOpDual |
449
+ +---------+-----------------------+------------------------------------------------------+-----------+
450
+ | dnsrpz | :math:`d_{nsr, p, z}` | zonal non-spinning reserve requirement in percentage | NumOpDual |
451
+ +---------+-----------------------+------------------------------------------------------+-----------+
452
+ | dnsr | :math:`d_{nsr}` | zonal non-spinning reserve requirement | NumOpDual |
453
+ +---------+-----------------------+------------------------------------------------------+-----------+
454
+ | Mzug | :math:`M_{zug}` | 10 times of max of pmax as big M for zug | NumOp |
455
+ +---------+-----------------------+------------------------------------------------------+-----------+
456
+ | Con | :math:`T_{on}` | minimum ON coefficient | MinDur |
457
+ +---------+-----------------------+------------------------------------------------------+-----------+
458
+ | Coff | :math:`T_{off}` | minimum OFF coefficient | MinDur |
459
+ +---------+-----------------------+------------------------------------------------------+-----------+
460
+ | pdsp | :math:`p_{d,s}^{+}` | positive demand | NumOp |
461
+ +---------+-----------------------+------------------------------------------------------+-----------+
462
+ | cd | :math:`C_{DG}` | Select DG power from pg | VarSelect |
463
+ +---------+-----------------------+------------------------------------------------------+-----------+
464
+
465
+ Parameters
466
+ ----------------------------------
467
+
468
+ +-----------+---------------------------+---------------------------------------------------+--------------+----------------------+
469
+ | Name | Symbol | Description | Unit | Source |
470
+ +===========+===========================+===================================================+==============+======================+
471
+ | ug | :math:`u_{g}` | Gen connection status | | StaticGen.u |
472
+ +-----------+---------------------------+---------------------------------------------------+--------------+----------------------+
473
+ | pg0 | :math:`p_{g, 0}` | Gen initial active power | *p.u.* | StaticGen.p0 |
474
+ +-----------+---------------------------+---------------------------------------------------+--------------+----------------------+
475
+ | gsh | :math:`g_{sh}` | shunt conductance | | Shunt.g |
476
+ +-----------+---------------------------+---------------------------------------------------+--------------+----------------------+
477
+ | buss | :math:`B_{us,s}` | Bus slack | | Slack.bus |
478
+ +-----------+---------------------------+---------------------------------------------------+--------------+----------------------+
479
+ | pd | :math:`p_{d}` | active demand | *p.u.* | StaticLoad.p0 |
480
+ +-----------+---------------------------+---------------------------------------------------+--------------+----------------------+
481
+ | Cg | :math:`C_{g}` | Gen connection matrix | | MatProcessor.Cg |
482
+ +-----------+---------------------------+---------------------------------------------------+--------------+----------------------+
483
+ | Cl | :math:`C_{l}` | Load connection matrix | | MatProcessor.Cl |
484
+ +-----------+---------------------------+---------------------------------------------------+--------------+----------------------+
485
+ | CftT | :math:`C_{ft}^T` | Transpose of line connection matrix | | MatProcessor.CftT |
486
+ +-----------+---------------------------+---------------------------------------------------+--------------+----------------------+
487
+ | Csh | :math:`C_{sh}` | Shunt connection matrix | | MatProcessor.Csh |
488
+ +-----------+---------------------------+---------------------------------------------------+--------------+----------------------+
489
+ | Bbus | :math:`B_{bus}` | Bus admittance matrix | | MatProcessor.Bbus |
490
+ +-----------+---------------------------+---------------------------------------------------+--------------+----------------------+
491
+ | Bf | :math:`B_{f}` | Bf matrix | | MatProcessor.Bf |
492
+ +-----------+---------------------------+---------------------------------------------------+--------------+----------------------+
493
+ | Pbusinj | :math:`P_{bus}^{inj}` | Bus power injection vector | | MatProcessor.Pbusinj |
494
+ +-----------+---------------------------+---------------------------------------------------+--------------+----------------------+
495
+ | Pfinj | :math:`P_{f}^{inj}` | Line power injection vector | | MatProcessor.Pfinj |
496
+ +-----------+---------------------------+---------------------------------------------------+--------------+----------------------+
497
+ | c2 | :math:`c_{2}` | Gen cost coefficient 2 | *$/(p.u.^2)* | GCost.c2 |
498
+ +-----------+---------------------------+---------------------------------------------------+--------------+----------------------+
499
+ | c1 | :math:`c_{1}` | Gen cost coefficient 1 | *$/(p.u.)* | GCost.c1 |
500
+ +-----------+---------------------------+---------------------------------------------------+--------------+----------------------+
501
+ | c0 | :math:`c_{0}` | Gen cost coefficient 0 | *$* | GCost.c0 |
502
+ +-----------+---------------------------+---------------------------------------------------+--------------+----------------------+
503
+ | ctrl | :math:`c_{trl}` | Gen controllability | | StaticGen.ctrl |
504
+ +-----------+---------------------------+---------------------------------------------------+--------------+----------------------+
505
+ | pmax | :math:`p_{g, max}` | Gen maximum active power | *p.u.* | StaticGen.pmax |
506
+ +-----------+---------------------------+---------------------------------------------------+--------------+----------------------+
507
+ | pmin | :math:`p_{g, min}` | Gen minimum active power | *p.u.* | StaticGen.pmin |
508
+ +-----------+---------------------------+---------------------------------------------------+--------------+----------------------+
509
+ | ul | :math:`u_{l}` | Line connection status | | Line.u |
510
+ +-----------+---------------------------+---------------------------------------------------+--------------+----------------------+
511
+ | rate_a | :math:`R_{ATEA}` | long-term flow limit | *p.u.* | Line.rate_a |
512
+ +-----------+---------------------------+---------------------------------------------------+--------------+----------------------+
513
+ | amax | :math:`\theta_{bus, max}` | max line angle difference | | Line.amax |
514
+ +-----------+---------------------------+---------------------------------------------------+--------------+----------------------+
515
+ | amin | :math:`\theta_{bus, min}` | min line angle difference | | Line.amin |
516
+ +-----------+---------------------------+---------------------------------------------------+--------------+----------------------+
517
+ | zg | :math:`z_{one,g}` | Gen zone | | StaticGen.zone |
518
+ +-----------+---------------------------+---------------------------------------------------+--------------+----------------------+
519
+ | zd | :math:`z_{one,d}` | Load zone | | StaticLoad.zone |
520
+ +-----------+---------------------------+---------------------------------------------------+--------------+----------------------+
521
+ | R10 | :math:`R_{10}` | 10-min ramp rate | *p.u./h* | StaticGen.R10 |
522
+ +-----------+---------------------------+---------------------------------------------------+--------------+----------------------+
523
+ | sd | :math:`s_{d}` | zonal load factor for UC | | UCTSlot.sd |
524
+ +-----------+---------------------------+---------------------------------------------------+--------------+----------------------+
525
+ | timeslot | :math:`t_{s,idx}` | Time slot for multi-period UC | | UCTSlot.idx |
526
+ +-----------+---------------------------+---------------------------------------------------+--------------+----------------------+
527
+ | R30 | :math:`R_{30}` | 30-min ramp rate | *p.u./h* | StaticGen.R30 |
528
+ +-----------+---------------------------+---------------------------------------------------+--------------+----------------------+
529
+ | dsr | :math:`d_{sr}` | spinning reserve requirement in percentage | *%* | SR.demand |
530
+ +-----------+---------------------------+---------------------------------------------------+--------------+----------------------+
531
+ | csr | :math:`c_{sr}` | cost for spinning reserve | *$/(p.u.*h)* | SRCost.csr |
532
+ +-----------+---------------------------+---------------------------------------------------+--------------+----------------------+
533
+ | cnsr | :math:`c_{nsr}` | cost for non-spinning reserve | *$/(p.u.*h)* | NSRCost.cnsr |
534
+ +-----------+---------------------------+---------------------------------------------------+--------------+----------------------+
535
+ | dnsr | :math:`d_{nsr}` | non-spinning reserve requirement in percentage | *%* | NSR.demand |
536
+ +-----------+---------------------------+---------------------------------------------------+--------------+----------------------+
537
+ | csu | :math:`c_{su}` | startup cost | *$* | GCost.csu |
538
+ +-----------+---------------------------+---------------------------------------------------+--------------+----------------------+
539
+ | csd | :math:`c_{sd}` | shutdown cost | *$* | GCost.csd |
540
+ +-----------+---------------------------+---------------------------------------------------+--------------+----------------------+
541
+ | cdp | :math:`c_{d,p}` | penalty for unserved load | *$/(p.u.*h)* | DCost.cdp |
542
+ +-----------+---------------------------+---------------------------------------------------+--------------+----------------------+
543
+ | dctrl | :math:`c_{trl,d}` | load controllability | | StaticLoad.ctrl |
544
+ +-----------+---------------------------+---------------------------------------------------+--------------+----------------------+
545
+ | td1 | :math:`t_{d1}` | minimum ON duration | *h* | StaticGen.td1 |
546
+ +-----------+---------------------------+---------------------------------------------------+--------------+----------------------+
547
+ | td2 | :math:`t_{d2}` | minimum OFF duration | *h* | StaticGen.td2 |
548
+ +-----------+---------------------------+---------------------------------------------------+--------------+----------------------+
549
+ | gendg | :math:`g_{DG}` | gen of DG | | DG.gen |
550
+ +-----------+---------------------------+---------------------------------------------------+--------------+----------------------+
551
+ | gammapd | :math:`\gamma_{p,DG}` | Ratio of DG.pge w.r.t to that of static generator | | DG.gammap |
552
+ +-----------+---------------------------+---------------------------------------------------+--------------+----------------------+
553
+
554
+
555
+ Config Fields in [UCDG]
556
+
557
+ +--------+-----------------+-------+------------------------+-----------------+
558
+ | Option | Symbol | Value | Info | Accepted values |
559
+ +========+=================+=======+========================+=================+
560
+ | t | :math:`T_{cfg}` | 1 | time interval in hours | |
561
+ +--------+-----------------+-------+------------------------+-----------------+
562
+
563
+
564
+ .. _UCES:
565
+
566
+ --------------------------------------------------------------------------------
567
+ UCES
568
+ --------------------------------------------------------------------------------
569
+ UC with energy storage :ref:`ESD1`.
570
+
571
+ Objective
572
+ ----------------------------------
573
+
574
+ +------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
575
+ | Unit | Expression |
576
+ +======+=====================================================================================================================================================================================================================================+
577
+ | *$* | :math:`min. T_{cfg}^{2} \sum(c_{2} z_{u_{g}}^{2} + T_{cfg} c_{1} z_{u_{g}})+ \sum(u_{g} c_{0} 1_{tl}) + T_{cfg} \sum(c_{su} v_{g,d} + c_{sd} w_{g,d} + c_{sr} p_{r,s} + c_{nsr} p_{r, ns} + c_{d,p} p_{d,u})` |
578
+ +------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
579
+
580
+ Expressions
581
+ ----------------------------------
582
+
583
+ +--------+----------------+-----------------------------------------------------------------+--------+-----------+
584
+ | Name | Description | Expression | Unit | Source |
585
+ +========+================+=================================================================+========+===========+
586
+ | plf | 2D Line flow | :math:`B_{f} \theta_{bus} + P_{f}^{inj}` | *p.u.* | Line |
587
+ +--------+----------------+-----------------------------------------------------------------+--------+-----------+
588
+ | pmaxe | Effective pmax | :math:`c_{trl,n} p_{g, 0} u_{g,d} + c_{trl} p_{g, max} u_{g,d}` | *p.u.* | StaticGen |
589
+ +--------+----------------+-----------------------------------------------------------------+--------+-----------+
590
+ | pmine | Effective pmin | :math:`c_{trl} p_{g, min} u_{g,d} + c_{trl,n} p_{g, 0} u_{g,d}` | *p.u.* | StaticGen |
591
+ +--------+----------------+-----------------------------------------------------------------+--------+-----------+
592
+
593
+ Constraints
594
+ ----------------------------------
595
+
596
+ +---------+-----------------------------------+------------------------------------------------------------------------------------------------------------------------+
597
+ | Name | Description | Expression |
598
+ +=========+===================================+========================================================================================================================+
599
+ | pb | power balance | :math:`B_{bus} \theta_{bus} + P_{bus}^{inj} 1_{tl} + C_{l} (p_{d,s}-p_{d,u}) + C_{sh} g_{sh} 1_{tl} - C_{g} p_g = 0` |
600
+ +---------+-----------------------------------+------------------------------------------------------------------------------------------------------------------------+
601
+ | sbus | align slack bus angle | :math:`c_{sb} \theta_{bus} = 0` |
602
+ +---------+-----------------------------------+------------------------------------------------------------------------------------------------------------------------+
603
+ | pglb | pg min | :math:`-p_g + p_{g, min, e} \leq 0` |
604
+ +---------+-----------------------------------+------------------------------------------------------------------------------------------------------------------------+
605
+ | pgub | pg max | :math:`p_g - p_{g, max, e} \leq 0` |
606
+ +---------+-----------------------------------+------------------------------------------------------------------------------------------------------------------------+
607
+ | plflb | line flow lower bound | :math:`-B_{f} \theta_{bus} - P_{f}^{inj} - R_{ATEA} 1_{tl} \leq 0` |
608
+ +---------+-----------------------------------+------------------------------------------------------------------------------------------------------------------------+
609
+ | plfub | line flow upper bound | :math:`B_{f} \theta_{bus} + P_{f}^{inj} - R_{ATEA} 1_{tl} \leq 0` |
610
+ +---------+-----------------------------------+------------------------------------------------------------------------------------------------------------------------+
611
+ | alflb | line angle difference lower bound | :math:`-C_{ft}^T \theta_{bus} - \theta_{bus, max} 1_{tl} \leq 0` |
612
+ +---------+-----------------------------------+------------------------------------------------------------------------------------------------------------------------+
613
+ | alfub | line angle difference upper bound | :math:`C_{ft}^T \theta_{bus} - \theta_{bus, max} 1_{tl} \leq 0` |
614
+ +---------+-----------------------------------+------------------------------------------------------------------------------------------------------------------------+
615
+ | prsb | spinning reserve balance | :math:`u_{g,d} p_{g, max} 1_{tl} - z_{u_{g}} - p_{r,s} = 0` |
616
+ +---------+-----------------------------------+------------------------------------------------------------------------------------------------------------------------+
617
+ | rsr | spinning reserve requirement | :math:`-S_{g} p_{r,s} + d_{s,r,z} \leq 0` |
618
+ +---------+-----------------------------------+------------------------------------------------------------------------------------------------------------------------+
619
+ | prnsb | non-spinning reserve balance | :math:`1-u_{g,d} p_{g, max} 1_{tl} - p_{r, ns} = 0` |
620
+ +---------+-----------------------------------+------------------------------------------------------------------------------------------------------------------------+
621
+ | rnsr | non-spinning reserve requirement | :math:`-S_{g} p_{r, ns} + d_{nsr} \leq 0` |
622
+ +---------+-----------------------------------+------------------------------------------------------------------------------------------------------------------------+
623
+ | actv | startup action | :math:`u_{g,d} M_{r} - v_{g,d}[:, 1:] = 0` |
624
+ +---------+-----------------------------------+------------------------------------------------------------------------------------------------------------------------+
625
+ | actv0 | initial startup action | :math:`u_{g,d}[:, 0] - u_{g}[:, 0] - v_{g,d}[:, 0] = 0` |
626
+ +---------+-----------------------------------+------------------------------------------------------------------------------------------------------------------------+
627
+ | actw | shutdown action | :math:`-u_{g,d} M_{r} - w_{g,d}[:, 1:] = 0` |
628
+ +---------+-----------------------------------+------------------------------------------------------------------------------------------------------------------------+
629
+ | actw0 | initial shutdown action | :math:`-u_{g,d}[:, 0] + u_{g}[:, 0] - w_{g,d}[:, 0] = 0` |
630
+ +---------+-----------------------------------+------------------------------------------------------------------------------------------------------------------------+
631
+ | zuglb | zug lower bound | :math:`- z_{u_{g}} + p_g \leq 0` |
632
+ +---------+-----------------------------------+------------------------------------------------------------------------------------------------------------------------+
633
+ | zugub | zug upper bound | :math:`z_{u_{g}} - p_g - M_{zug} (1 - u_{g,d}) \leq 0` |
634
+ +---------+-----------------------------------+------------------------------------------------------------------------------------------------------------------------+
635
+ | zugub2 | zug upper bound | :math:`z_{u_{g}} - M_{zug} u_{g,d} \leq 0` |
636
+ +---------+-----------------------------------+------------------------------------------------------------------------------------------------------------------------+
637
+ | don | minimum online duration | :math:`T_{on} v_{g,d} - u_{g,d} \leq 0` |
638
+ +---------+-----------------------------------+------------------------------------------------------------------------------------------------------------------------+
639
+ | doff | minimum offline duration | :math:`T_{off} w_{g,d} - (1 - u_{g,d}) \leq 0` |
640
+ +---------+-----------------------------------+------------------------------------------------------------------------------------------------------------------------+
641
+ | pdumax | unserved demand upper bound | :math:`p_{d,u} - p_{d,s}^{+} c_{trl,d} 1_{tl} \leq 0` |
642
+ +---------+-----------------------------------+------------------------------------------------------------------------------------------------------------------------+
643
+ | cdgb | Select DG power from pg | :math:`C_{DG} p_g - p_{g,DG} = 0` |
644
+ +---------+-----------------------------------+------------------------------------------------------------------------------------------------------------------------+
645
+ | SOClb | SOC lower bound | :math:`-SOC + SOC_{min} \leq 0` |
646
+ +---------+-----------------------------------+------------------------------------------------------------------------------------------------------------------------+
647
+ | SOCub | SOC upper bound | :math:`SOC - SOC_{max} \leq 0` |
648
+ +---------+-----------------------------------+------------------------------------------------------------------------------------------------------------------------+
649
+ | cescb | Select pce from DG | :math:`C_{ESD} p_{g,DG} - p_{c,ESD} = 0` |
650
+ +---------+-----------------------------------+------------------------------------------------------------------------------------------------------------------------+
651
+ | cesdb | Select pde from DG | :math:`C_{ESD} p_{g,DG} - p_{d,ESD} = 0` |
652
+ +---------+-----------------------------------+------------------------------------------------------------------------------------------------------------------------+
653
+ | cdb | Charging decision bound | :math:`u_{c,ESD} + u_{d,ESD} - 1 = 0` |
654
+ +---------+-----------------------------------+------------------------------------------------------------------------------------------------------------------------+
655
+ | zce1 | zce bound 1 | :math:`-z_{c,ESD} + p_{c,ESD} \leq 0` |
656
+ +---------+-----------------------------------+------------------------------------------------------------------------------------------------------------------------+
657
+ | zce2 | zce bound 2 | :math:`z_{c,ESD} - p_{c,ESD} - M_{big} (1-u_{c,ESD}) \leq 0` |
658
+ +---------+-----------------------------------+------------------------------------------------------------------------------------------------------------------------+
659
+ | zce3 | zce bound 3 | :math:`z_{c,ESD} - M_{big} u_{c,ESD} \leq 0` |
660
+ +---------+-----------------------------------+------------------------------------------------------------------------------------------------------------------------+
661
+ | zde1 | zde bound 1 | :math:`-z_{d,ESD} + p_{d,ESD} \leq 0` |
662
+ +---------+-----------------------------------+------------------------------------------------------------------------------------------------------------------------+
663
+ | zde2 | zde bound 2 | :math:`z_{d,ESD} - p_{d,ESD} - M_{big} (1-u_{d,ESD}) \leq 0` |
664
+ +---------+-----------------------------------+------------------------------------------------------------------------------------------------------------------------+
665
+ | zde3 | zde bound 3 | :math:`z_{d,ESD} - M_{big} u_{d,ESD} \leq 0` |
666
+ +---------+-----------------------------------+------------------------------------------------------------------------------------------------------------------------+
667
+ | SOCb | ESD1 SOC balance | :math:`E_{n,R} SOC M_{r,ES} - T_{cfg} \eta_{c,R} z_{c,ESD}[:, 1:] + T_{cfg} R_{\eta_d,R} z_{d,ESD}[:, 1:] = 0` |
668
+ +---------+-----------------------------------+------------------------------------------------------------------------------------------------------------------------+
669
+ | SOCb0 | ESD1 SOC initial balance | :math:`E_n SOC[:, 0] - SOC_{init} - T_{cfg} \eta_c z_{c,ESD}[:, 0] + T_{cfg} \frac{1}{\eta_d} z_{d,ESD}[:, 0] = 0` |
670
+ +---------+-----------------------------------+------------------------------------------------------------------------------------------------------------------------+
671
+ | SOCr | SOC requirement | :math:`SOC[:, -1] - SOC_{init} = 0` |
672
+ +---------+-----------------------------------+------------------------------------------------------------------------------------------------------------------------+
673
+
674
+ Vars
675
+ ----------------------------------
676
+
677
+ +-------+----------------------+----------------------------------------------------------------+--------+-------------+------------+
678
+ | Name | Symbol | Description | Unit | Source | Properties |
679
+ +=======+======================+================================================================+========+=============+============+
680
+ | pg | :math:`p_g` | 2D Gen power | *p.u.* | StaticGen.p | |
681
+ +-------+----------------------+----------------------------------------------------------------+--------+-------------+------------+
682
+ | vBus | :math:`v_{Bus}` | 2D Bus voltage | *p.u.* | Bus.v | |
683
+ +-------+----------------------+----------------------------------------------------------------+--------+-------------+------------+
684
+ | aBus | :math:`\theta_{bus}` | 2D Bus angle | *rad* | Bus.a | |
685
+ +-------+----------------------+----------------------------------------------------------------+--------+-------------+------------+
686
+ | prs | :math:`p_{r,s}` | 2D Spinning reserve | *p.u.* | StaticGen | nonneg |
687
+ +-------+----------------------+----------------------------------------------------------------+--------+-------------+------------+
688
+ | prns | :math:`p_{r, ns}` | 2D Non-spinning reserve | | StaticGen | nonneg |
689
+ +-------+----------------------+----------------------------------------------------------------+--------+-------------+------------+
690
+ | ugd | :math:`u_{g,d}` | commitment decision | | StaticGen.u | boolean |
691
+ +-------+----------------------+----------------------------------------------------------------+--------+-------------+------------+
692
+ | vgd | :math:`v_{g,d}` | startup action | | StaticGen.u | boolean |
693
+ +-------+----------------------+----------------------------------------------------------------+--------+-------------+------------+
694
+ | wgd | :math:`w_{g,d}` | shutdown action | | StaticGen.u | boolean |
695
+ +-------+----------------------+----------------------------------------------------------------+--------+-------------+------------+
696
+ | zug | :math:`z_{ug}` | Aux var, :math:`z_{ug} = u_{g,d} * p_g` | | StaticGen | pos |
697
+ +-------+----------------------+----------------------------------------------------------------+--------+-------------+------------+
698
+ | pdu | :math:`p_{d,u}` | unserved demand | *p.u.* | StaticLoad | nonneg |
699
+ +-------+----------------------+----------------------------------------------------------------+--------+-------------+------------+
700
+ | pgdg | :math:`p_{g,DG}` | DG output power | *p.u.* | DG | |
701
+ +-------+----------------------+----------------------------------------------------------------+--------+-------------+------------+
702
+ | SOC | :math:`SOC` | ESD1 State of Charge | *%* | ESD1 | pos |
703
+ +-------+----------------------+----------------------------------------------------------------+--------+-------------+------------+
704
+ | pce | :math:`p_{c,ESD}` | ESD1 charging power | *p.u.* | ESD1 | nonneg |
705
+ +-------+----------------------+----------------------------------------------------------------+--------+-------------+------------+
706
+ | pde | :math:`p_{d,ESD}` | ESD1 discharging power | *p.u.* | ESD1 | nonneg |
707
+ +-------+----------------------+----------------------------------------------------------------+--------+-------------+------------+
708
+ | uce | :math:`u_{c,ESD}` | ESD1 charging decision | | ESD1 | boolean |
709
+ +-------+----------------------+----------------------------------------------------------------+--------+-------------+------------+
710
+ | ude | :math:`u_{d,ESD}` | ESD1 discharging decision | | ESD1 | boolean |
711
+ +-------+----------------------+----------------------------------------------------------------+--------+-------------+------------+
712
+ | zce | :math:`z_{c,ESD}` | Aux var for charging, :math:`z_{c,ESD}=u_{c,ESD}*p_{c,ESD}` | | ESD1 | nonneg |
713
+ +-------+----------------------+----------------------------------------------------------------+--------+-------------+------------+
714
+ | zde | :math:`z_{d,ESD}` | Aux var for discharging, :math:`z_{d,ESD}=u_{d,ESD}*p_{d,ESD}` | | ESD1 | nonneg |
715
+ +-------+----------------------+----------------------------------------------------------------+--------+-------------+------------+
716
+
717
+ ExpressionCalcs
718
+ ----------------------------------
719
+
720
+ +------+-------------------+------------------+----------+--------+
721
+ | Name | Description | Expression | Unit | Source |
722
+ +======+===================+==================+==========+========+
723
+ | pi | LMP, dual of <pb> | :math:`\phi[pb]` | *$/p.u.* | Bus |
724
+ +------+-------------------+------------------+----------+--------+
725
+
726
+ Services
727
+ ---------
728
+
729
+ +---------+--------------------------+------------------------------------------------------+-----------+
730
+ | Name | Symbol | Description | Type |
731
+ +=========+==========================+======================================================+===========+
732
+ | csb | :math:`c_{sb}` | select slack bus | VarSelect |
733
+ +---------+--------------------------+------------------------------------------------------+-----------+
734
+ | ctrle | :math:`c_{trl, e}` | Reshaped controllability | NumOpDual |
735
+ +---------+--------------------------+------------------------------------------------------+-----------+
736
+ | nctrl | :math:`c_{trl,n}` | Effective Gen uncontrollability | NumOp |
737
+ +---------+--------------------------+------------------------------------------------------+-----------+
738
+ | nctrle | :math:`c_{trl,n,e}` | Reshaped non-controllability | NumOpDual |
739
+ +---------+--------------------------+------------------------------------------------------+-----------+
740
+ | gs | :math:`S_{g}` | Sum Gen vars vector in shape of zone | ZonalSum |
741
+ +---------+--------------------------+------------------------------------------------------+-----------+
742
+ | ds | :math:`S_{d}` | Sum pd vector in shape of zone | ZonalSum |
743
+ +---------+--------------------------+------------------------------------------------------+-----------+
744
+ | pdz | :math:`p_{d,z}` | zonal total load | NumOpDual |
745
+ +---------+--------------------------+------------------------------------------------------+-----------+
746
+ | tlv | :math:`1_{tl}` | time length vector | NumOp |
747
+ +---------+--------------------------+------------------------------------------------------+-----------+
748
+ | pds | :math:`p_{d,s}` | Scaled load | LoadScale |
749
+ +---------+--------------------------+------------------------------------------------------+-----------+
750
+ | Mr | :math:`M_{r}` | Subtraction matrix for ramping | RampSub |
751
+ +---------+--------------------------+------------------------------------------------------+-----------+
752
+ | RR30 | :math:`R_{30,R}` | Repeated ramp rate | NumHstack |
753
+ +---------+--------------------------+------------------------------------------------------+-----------+
754
+ | dsrpz | :math:`d_{s,r, p, z}` | zonal spinning reserve requirement in percentage | NumOpDual |
755
+ +---------+--------------------------+------------------------------------------------------+-----------+
756
+ | dsr | :math:`d_{s,r,z}` | zonal spinning reserve requirement | NumOpDual |
757
+ +---------+--------------------------+------------------------------------------------------+-----------+
758
+ | dnsrpz | :math:`d_{nsr, p, z}` | zonal non-spinning reserve requirement in percentage | NumOpDual |
759
+ +---------+--------------------------+------------------------------------------------------+-----------+
760
+ | dnsr | :math:`d_{nsr}` | zonal non-spinning reserve requirement | NumOpDual |
761
+ +---------+--------------------------+------------------------------------------------------+-----------+
762
+ | Mzug | :math:`M_{zug}` | 10 times of max of pmax as big M for zug | NumOp |
763
+ +---------+--------------------------+------------------------------------------------------+-----------+
764
+ | Con | :math:`T_{on}` | minimum ON coefficient | MinDur |
765
+ +---------+--------------------------+------------------------------------------------------+-----------+
766
+ | Coff | :math:`T_{off}` | minimum OFF coefficient | MinDur |
767
+ +---------+--------------------------+------------------------------------------------------+-----------+
768
+ | pdsp | :math:`p_{d,s}^{+}` | positive demand | NumOp |
769
+ +---------+--------------------------+------------------------------------------------------+-----------+
770
+ | cd | :math:`C_{DG}` | Select DG power from pg | VarSelect |
771
+ +---------+--------------------------+------------------------------------------------------+-----------+
772
+ | REtaD | :math:`\frac{1}{\eta_d}` | | NumOp |
773
+ +---------+--------------------------+------------------------------------------------------+-----------+
774
+ | Mb | :math:`M_{big}` | 10 times of max of pmax as big M | NumOp |
775
+ +---------+--------------------------+------------------------------------------------------+-----------+
776
+ | ces | :math:`C_{ESD}` | Select ESD power from DG | VarSelect |
777
+ +---------+--------------------------+------------------------------------------------------+-----------+
778
+ | Mre | :math:`M_{r,ES}` | Subtraction matrix for SOC | RampSub |
779
+ +---------+--------------------------+------------------------------------------------------+-----------+
780
+ | EnR | :math:`E_{n,R}` | Repeated En as 2D matrix, (ng, ng-1) | NumHstack |
781
+ +---------+--------------------------+------------------------------------------------------+-----------+
782
+ | EtaCR | :math:`\eta_{c,R}` | Repeated Etac as 2D matrix, (ng, ng-1) | NumHstack |
783
+ +---------+--------------------------+------------------------------------------------------+-----------+
784
+ | REtaDR | :math:`R_{\eta_d,R}` | Repeated REtaD as 2D matrix, (ng, ng-1) | NumHstack |
785
+ +---------+--------------------------+------------------------------------------------------+-----------+
786
+
787
+ Parameters
788
+ ----------------------------------
789
+
790
+ +-----------+---------------------------+---------------------------------------------------+--------------+----------------------+
791
+ | Name | Symbol | Description | Unit | Source |
792
+ +===========+===========================+===================================================+==============+======================+
793
+ | ug | :math:`u_{g}` | Gen connection status | | StaticGen.u |
794
+ +-----------+---------------------------+---------------------------------------------------+--------------+----------------------+
795
+ | pg0 | :math:`p_{g, 0}` | Gen initial active power | *p.u.* | StaticGen.p0 |
796
+ +-----------+---------------------------+---------------------------------------------------+--------------+----------------------+
797
+ | gsh | :math:`g_{sh}` | shunt conductance | | Shunt.g |
798
+ +-----------+---------------------------+---------------------------------------------------+--------------+----------------------+
799
+ | buss | :math:`B_{us,s}` | Bus slack | | Slack.bus |
800
+ +-----------+---------------------------+---------------------------------------------------+--------------+----------------------+
801
+ | pd | :math:`p_{d}` | active demand | *p.u.* | StaticLoad.p0 |
802
+ +-----------+---------------------------+---------------------------------------------------+--------------+----------------------+
803
+ | Cg | :math:`C_{g}` | Gen connection matrix | | MatProcessor.Cg |
804
+ +-----------+---------------------------+---------------------------------------------------+--------------+----------------------+
805
+ | Cl | :math:`C_{l}` | Load connection matrix | | MatProcessor.Cl |
806
+ +-----------+---------------------------+---------------------------------------------------+--------------+----------------------+
807
+ | CftT | :math:`C_{ft}^T` | Transpose of line connection matrix | | MatProcessor.CftT |
808
+ +-----------+---------------------------+---------------------------------------------------+--------------+----------------------+
809
+ | Csh | :math:`C_{sh}` | Shunt connection matrix | | MatProcessor.Csh |
810
+ +-----------+---------------------------+---------------------------------------------------+--------------+----------------------+
811
+ | Bbus | :math:`B_{bus}` | Bus admittance matrix | | MatProcessor.Bbus |
812
+ +-----------+---------------------------+---------------------------------------------------+--------------+----------------------+
813
+ | Bf | :math:`B_{f}` | Bf matrix | | MatProcessor.Bf |
814
+ +-----------+---------------------------+---------------------------------------------------+--------------+----------------------+
815
+ | Pbusinj | :math:`P_{bus}^{inj}` | Bus power injection vector | | MatProcessor.Pbusinj |
816
+ +-----------+---------------------------+---------------------------------------------------+--------------+----------------------+
817
+ | Pfinj | :math:`P_{f}^{inj}` | Line power injection vector | | MatProcessor.Pfinj |
818
+ +-----------+---------------------------+---------------------------------------------------+--------------+----------------------+
819
+ | c2 | :math:`c_{2}` | Gen cost coefficient 2 | *$/(p.u.^2)* | GCost.c2 |
820
+ +-----------+---------------------------+---------------------------------------------------+--------------+----------------------+
821
+ | c1 | :math:`c_{1}` | Gen cost coefficient 1 | *$/(p.u.)* | GCost.c1 |
822
+ +-----------+---------------------------+---------------------------------------------------+--------------+----------------------+
823
+ | c0 | :math:`c_{0}` | Gen cost coefficient 0 | *$* | GCost.c0 |
824
+ +-----------+---------------------------+---------------------------------------------------+--------------+----------------------+
825
+ | ctrl | :math:`c_{trl}` | Gen controllability | | StaticGen.ctrl |
826
+ +-----------+---------------------------+---------------------------------------------------+--------------+----------------------+
827
+ | pmax | :math:`p_{g, max}` | Gen maximum active power | *p.u.* | StaticGen.pmax |
828
+ +-----------+---------------------------+---------------------------------------------------+--------------+----------------------+
829
+ | pmin | :math:`p_{g, min}` | Gen minimum active power | *p.u.* | StaticGen.pmin |
830
+ +-----------+---------------------------+---------------------------------------------------+--------------+----------------------+
831
+ | ul | :math:`u_{l}` | Line connection status | | Line.u |
832
+ +-----------+---------------------------+---------------------------------------------------+--------------+----------------------+
833
+ | rate_a | :math:`R_{ATEA}` | long-term flow limit | *p.u.* | Line.rate_a |
834
+ +-----------+---------------------------+---------------------------------------------------+--------------+----------------------+
835
+ | amax | :math:`\theta_{bus, max}` | max line angle difference | | Line.amax |
836
+ +-----------+---------------------------+---------------------------------------------------+--------------+----------------------+
837
+ | amin | :math:`\theta_{bus, min}` | min line angle difference | | Line.amin |
838
+ +-----------+---------------------------+---------------------------------------------------+--------------+----------------------+
839
+ | zg | :math:`z_{one,g}` | Gen zone | | StaticGen.zone |
840
+ +-----------+---------------------------+---------------------------------------------------+--------------+----------------------+
841
+ | zd | :math:`z_{one,d}` | Load zone | | StaticLoad.zone |
842
+ +-----------+---------------------------+---------------------------------------------------+--------------+----------------------+
843
+ | R10 | :math:`R_{10}` | 10-min ramp rate | *p.u./h* | StaticGen.R10 |
844
+ +-----------+---------------------------+---------------------------------------------------+--------------+----------------------+
845
+ | sd | :math:`s_{d}` | zonal load factor for UC | | UCTSlot.sd |
846
+ +-----------+---------------------------+---------------------------------------------------+--------------+----------------------+
847
+ | timeslot | :math:`t_{s,idx}` | Time slot for multi-period UC | | UCTSlot.idx |
848
+ +-----------+---------------------------+---------------------------------------------------+--------------+----------------------+
849
+ | R30 | :math:`R_{30}` | 30-min ramp rate | *p.u./h* | StaticGen.R30 |
850
+ +-----------+---------------------------+---------------------------------------------------+--------------+----------------------+
851
+ | dsr | :math:`d_{sr}` | spinning reserve requirement in percentage | *%* | SR.demand |
852
+ +-----------+---------------------------+---------------------------------------------------+--------------+----------------------+
853
+ | csr | :math:`c_{sr}` | cost for spinning reserve | *$/(p.u.*h)* | SRCost.csr |
854
+ +-----------+---------------------------+---------------------------------------------------+--------------+----------------------+
855
+ | cnsr | :math:`c_{nsr}` | cost for non-spinning reserve | *$/(p.u.*h)* | NSRCost.cnsr |
856
+ +-----------+---------------------------+---------------------------------------------------+--------------+----------------------+
857
+ | dnsr | :math:`d_{nsr}` | non-spinning reserve requirement in percentage | *%* | NSR.demand |
858
+ +-----------+---------------------------+---------------------------------------------------+--------------+----------------------+
859
+ | csu | :math:`c_{su}` | startup cost | *$* | GCost.csu |
860
+ +-----------+---------------------------+---------------------------------------------------+--------------+----------------------+
861
+ | csd | :math:`c_{sd}` | shutdown cost | *$* | GCost.csd |
862
+ +-----------+---------------------------+---------------------------------------------------+--------------+----------------------+
863
+ | cdp | :math:`c_{d,p}` | penalty for unserved load | *$/(p.u.*h)* | DCost.cdp |
864
+ +-----------+---------------------------+---------------------------------------------------+--------------+----------------------+
865
+ | dctrl | :math:`c_{trl,d}` | load controllability | | StaticLoad.ctrl |
866
+ +-----------+---------------------------+---------------------------------------------------+--------------+----------------------+
867
+ | td1 | :math:`t_{d1}` | minimum ON duration | *h* | StaticGen.td1 |
868
+ +-----------+---------------------------+---------------------------------------------------+--------------+----------------------+
869
+ | td2 | :math:`t_{d2}` | minimum OFF duration | *h* | StaticGen.td2 |
870
+ +-----------+---------------------------+---------------------------------------------------+--------------+----------------------+
871
+ | gendg | :math:`g_{DG}` | gen of DG | | DG.gen |
872
+ +-----------+---------------------------+---------------------------------------------------+--------------+----------------------+
873
+ | gammapd | :math:`\gamma_{p,DG}` | Ratio of DG.pge w.r.t to that of static generator | | DG.gammap |
874
+ +-----------+---------------------------+---------------------------------------------------+--------------+----------------------+
875
+ | En | :math:`E_n` | Rated energy capacity | *MWh* | ESD1.En |
876
+ +-----------+---------------------------+---------------------------------------------------+--------------+----------------------+
877
+ | SOCmax | :math:`SOC_{max}` | Maximum allowed value for SOC in limiter | *%* | ESD1.SOCmax |
878
+ +-----------+---------------------------+---------------------------------------------------+--------------+----------------------+
879
+ | SOCmin | :math:`SOC_{min}` | Minimum required value for SOC in limiter | *%* | ESD1.SOCmin |
880
+ +-----------+---------------------------+---------------------------------------------------+--------------+----------------------+
881
+ | SOCinit | :math:`SOC_{init}` | Initial SOC | *%* | ESD1.SOCinit |
882
+ +-----------+---------------------------+---------------------------------------------------+--------------+----------------------+
883
+ | EtaC | :math:`\eta_c` | Efficiency during charging | *%* | ESD1.EtaC |
884
+ +-----------+---------------------------+---------------------------------------------------+--------------+----------------------+
885
+ | EtaD | :math:`\eta_d` | Efficiency during discharging | *%* | ESD1.EtaD |
886
+ +-----------+---------------------------+---------------------------------------------------+--------------+----------------------+
887
+ | genesd | :math:`g_{ESD}` | gen of ESD1 | | ESD1.idx |
888
+ +-----------+---------------------------+---------------------------------------------------+--------------+----------------------+
889
+
890
+
891
+ Config Fields in [UCES]
892
+
893
+ +--------+-----------------+-------+------------------------+-----------------+
894
+ | Option | Symbol | Value | Info | Accepted values |
895
+ +========+=================+=======+========================+=================+
896
+ | t | :math:`T_{cfg}` | 1 | time interval in hours | |
897
+ +--------+-----------------+-------+------------------------+-----------------+
898
+
899
+