cloudpss 4.1.1b9__py3-none-any.whl → 4.5.1__py3-none-any.whl

cloudpss/__init__.py

@@ -1,5 +1,5 @@
 # coding=UTF-8
-from cloudpss.ieslab import IESLabSimulation, IESLabPlan
+from cloudpss.ieslab import IESLabSimulation, IESLabPlan, IESLabOpt
 from .verify import setToken
 from .runner import Runner, Result, EMTResult, PowerFlowResult
 from .model import Model, ModelRevision, ModelTopology
@@ -9,11 +9,10 @@ from . import function
 from .job import Job
 from .function import FunctionExecution
 from .version import __version__
-from .dslab import DSLab
 __all__ = [
     'setToken', 'Model', 'ModelRevision', 'ModelTopology', 'Runner', 'Result',
     'PowerFlowResult', 'EMTResult', 'MatlabDataEncoder', 'DateTimeEncode',
-    'function', 'Project', 'currentJob', 'IESLabSimulation', 'IESLabPlan','__version__','Job','DSLab'
+    'function', 'Project', 'currentJob', 'IESLabSimulation', 'IESLabPlan','IESLabOpt','__version__','Job'
 ]
 
 

cloudpss/asyncio/job/job.py

@@ -72,13 +72,13 @@ class Job(JobBase):
         variables = {"input": {"id": id, "timeout": timeout}}
         await graphql_request(query, variables)
         
-    async def view(self, viewType:F)->F:
+    async def result(self, resultType:F)->F:
         """
         获取当前运行实例的输出
         """
         receiver = await self.read()
         sender = await self.write()
-        self._result= viewType(receiver, sender)
+        self._result= resultType(receiver, sender)
         return self._result
     
     async def write(self, sender=None, dev=False, **kwargs) -> MessageStreamSender:

cloudpss/function/functionExecution.py

@@ -99,6 +99,26 @@ class FunctionExecution(object):
         self._args = val
 
     @staticmethod
+    def __listObj2Array(data):
+        arr=[]
+        for item in data:
+            if type(item) is list:
+                arr.append(FunctionExecution.__listObj2Array(item))
+            elif type(item) is dict and ('ɵid' in item or '?id' in item ):
+                a = list(range(len(item)-1))
+                for k, v in item.items():
+                    if k == 'ɵid' or k == '?id':
+                        continue
+                    k = int(k)
+                    if type(v) is list:
+                        a[k] = FunctionExecution.__listObj2Array(v)
+                    else:
+                        a[k] = v
+                arr.append(a)       
+            else:
+                arr.append(item)
+        return arr
+    @staticmethod
     def __loadArgs():
         """加载当前任务参数
 
@@ -110,9 +130,12 @@ class FunctionExecution(object):
             if k.startswith('CLOUDPSS_JOB_ARG-'):
                 s = k.split('-')
                 key = bytes.decode(bytes.fromhex(s[1]))
-                # print(key, v, flush=True)
-
-                args[key] = json.loads(v)
+                data = json.loads(v)
+                
+                if type(data) is list:
+                    data = FunctionExecution.__listObj2Array(data)
+                
+                args[key] = data
         return args
 
     def feedDog(self):

cloudpss/ieslab/DataManageModel.py

@@ -83,46 +83,21 @@ class DataManageModel(object):
             
             :return: 无
         '''
-        try:
-            r = request('GET',
-                    self._dataManageUrl,
-                    params={
-                        "simulationId": self.simulationId
-                        ,
-                    })
-            data = json.loads(r.text)
-            info = data['info']
-            for kind,value in info.items():
-                if kind =='Weather':
-                    continue
-                
-                for k,data in value.items():
-                    self._kindItemDataMap[k]=value
-                    for val in data:
-                        self._itemDataMap[str(val['timeid'])]=val
-                        self._itemDataMap[str(val['id'])]=val
-                        self._kindIdMap[str(val['timeid'])]=k
-                        self._kindIdMap[str(val['id'])]=k
-        except Exception as e:
-            print('获取数据失败',e)
-            pass
-
-        # list = ['thermalLoads', 'electricLoads', 'fuels', 'typhoon', 'rainfall', 'earthquake', 'extremeCold']
-        # for kind,value in self._kindUrlMap.items():
-        #     try:
-            
-        #         if kind in list:
-        #             dataList = self._fetchItemData(self._kindUrlMap[kind], None)
-        #         else:
-        #             dataList = self._fetchItemData(self._kindUrlMap[kind], kind)
-        #     except Exception as e:
-        #         pass
-        #     self._kindItemDataMap[kind]=dataList
-        #     for val in dataList:
-        #         self._itemDataMap[str(val['timeid'])]=val
-        #         self._itemDataMap[str(val['id'])]=val
-        #         self._kindIdMap[str(val['timeid'])]=kind
-        #         self._kindIdMap[str(val['id'])]=kind
+        list = ['thermalLoads', 'heatingLoad', 'coolingLoad', 'electricLoads', 'fuels', 'typhoon', 'rainfall', 'earthquake', 'extremeCold', 'HydrogenLoad']
+        for kind,value in self._kindUrlMap.items():
+            try:
+                if kind in list:
+                    dataList = self._fetchItemData(self._kindUrlMap[kind], None)
+                else:
+                    dataList = self._fetchItemData(self._kindUrlMap[kind], kind)
+            except Exception as e:
+                pass
+            self._kindItemDataMap[kind]=dataList
+            for val in dataList:
+                self._itemDataMap[str(val['timeid'])]=val
+                self._itemDataMap[str(val['id'])]=val
+                self._kindIdMap[str(val['timeid'])]=kind
+                self._kindIdMap[str(val['id'])]=kind
 
     def GetDataItem(self, ID: str):
         '''
@@ -132,6 +107,7 @@ class DataManageModel(object):
             
             :return: dict类型，为源数据的引用，返回该数据项的信息
         '''
+
         data = self._itemDataMap.get(str(ID),None)
         
         assert (data is not None), "找不到数据"
@@ -175,7 +151,7 @@ class DataManageModel(object):
             self._kindIdMap[str(data['id'])]=kind
             self._itemDataMap[str(data['timeid'])]=data
             self._itemDataMap[str(data['id'])]=data
-            if kind in ['thermalLoads', 'electricLoads', 'fuels']:
+            if kind in ['thermalLoads', 'heatingLoad','coolingLoad', 'electricLoads', 'fuels']:
                 dataList = self._fetchItemData(self._kindUrlMap[kind], None)
                 self._kindItemDataMap[kind] = dataList
                 return dataList[-1]['id']
@@ -362,7 +338,7 @@ class IESSimulationDataManageModel(DataManageModel):
         "台风灾害": "typhoon",
         "降雨灾害": "rainfall",
         "地震灾害": "earthquake",
-        "极寒灾害": "extremeCold"
+        "极寒灾害": "extremeCold",
     }
     _kindUrlMap = {
         "PhotovoltaicSys": "api/ieslab-simulation/rest/dpcs/",
@@ -392,7 +368,7 @@ class IESSimulationDataManageModel(DataManageModel):
         "typhoon":  "api/ieslab-simulation/rest/typhoon/",
         "rainfall": "api/ieslab-simulation/rest/rainfall/",
         "earthquake": "api/ieslab-simulation/rest/earthquake/",
-        "extremeCold": "api/ieslab-simulation/rest/extremeCold/"
+        "extremeCold": "api/ieslab-simulation/rest/extremeCold/",
     }
     pass
 
@@ -412,6 +388,7 @@ class IESPlanDataManageModel(DataManageModel):
         "吸收式制冷机": "AbsorptionChiller",
         "蓄电池": "Battery",
         "储水罐": "WaterTank",
+        "蓄冰空调": "IceStorageAC",
         "变压器": "Transformer",
         "传输线": "TransferLine",
         "模块化多电平变流器": "MMC",
@@ -429,7 +406,8 @@ class IESPlanDataManageModel(DataManageModel):
         "台风灾害": "typhoon",
         "降雨灾害": "rainfall",
         "地震灾害": "earthquake",
-        "极寒灾害": "extremeCold"
+        "极寒灾害": "extremeCold",
+        "换热器": "HeatExchanger",
     }
     _kindUrlMap = {
         "PhotovoltaicSys": "api/ieslab-plan/rest/dpcs/",
@@ -438,10 +416,11 @@ class IESPlanDataManageModel(DataManageModel):
         "HeatPump": "api/ieslab-plan/rest/dhscs/",
         "GasBoiler": "api/ieslab-plan/rest/dhscs/",
         "HPSolarCollector": "api/ieslab-plan/rest/dhscs/",
-        "CompRefrg": "api/ieslab-plan/rest/dhscs/",
+        "CompRefrg": "api/ieslab-simulation/rest/dhscs/",
         "AbsorptionChiller": "api/ieslab-plan/rest/dhscs/",
         "Battery": "api/ieslab-plan/rest/escs/",
         "WaterTank": "api/ieslab-plan/rest/escs/",
+        "IceStorageAC": "api/ieslab-plan/rest/escs/",
         "Transformer": "api/ieslab-plan/rest/dstcs/",
         "TransferLine": "api/ieslab-plan/rest/dstcs/",
         "MMC": "api/ieslab-plan/rest/dstcs/",
@@ -459,6 +438,100 @@ class IESPlanDataManageModel(DataManageModel):
         "typhoon":  "api/ieslab-plan/rest/typhoon/",
         "rainfall": "api/ieslab-plan/rest/rainfall/",
         "earthquake": "api/ieslab-plan/rest/earthquake/",
-        "extremeCold": "api/ieslab-plan/rest/extremeCold/"
+        "extremeCold": "api/ieslab-plan/rest/extremeCold/",
+        "HeatExchanger": "api/ieslab-plan/rest/hstcs/",
+    }
+    pass
+
+class IESOptDataManageModel(DataManageModel):
+    _baseUri = 'api/ieslab-opt/'
+    _weatherUrl = 'api/ieslab-opt/rest/weather_data/'
+    _kindNameMap = {
+        "光伏": "PhotovoltaicSys",
+        "风机": "WindPowerGenerator",
+        "燃料发电机组": "GasTurbine",
+        "空气源热泵": "HeatPump",
+        "燃气锅炉": "GasBoiler",
+        "太阳能集热器": "HPSolarCollector",
+        "单工况制冷机": "SingleConChiller",
+        "双工况制冷机": "DualConChiller",
+        "吸收式制冷机": "AbsorptionChiller",
+        "蓄电池": "Battery",
+        "蓄冰槽": "IceStorageAC",
+        "变压器": "Transformer",
+        "传输线": "TransferLine",
+        "模块化多电平变流器": "MMC",
+        "离心泵": "CentrifugalPump",
+        "管道": "Pipe",
+        "热负荷": "heatingLoad",
+        "冷负荷": "coolingLoad",
+        "电负荷": "electricLoads",
+        "燃料": "fuels",
+        "热": "HVACHeating",
+        "冷": "HVACCooling",
+        "常数电价": "常数电价",
+        "分时电价": "分时电价",
+        "阶梯电价": "阶梯电价",
+        "分时阶梯电价": "分时阶梯电价",
+        "台风灾害": "typhoon",
+        "降雨灾害": "rainfall",
+        "地震灾害": "earthquake",
+        "极寒灾害": "extremeCold",
+        "PEM燃料电池": "PEMF",
+        "SOFC": "SOFC",
+        "碱性电解槽": "ALK",
+        "PEM电解槽": "PEME",
+        "SOEC": "SOEC",
+        "储氢罐": "HydrogenTank",
+        "储热罐": "HeatStoTank",
+        "换热器": "HeatExchanger",
+        "氢气压缩设备": "HydrogenCompression",
+        "氢负荷": "HydrogenLoad",
+        "氢": "HydrogenProductionFuels",
+        "运氢槽车": "HydrogenTanker"
+    }
+    _kindUrlMap = {
+        "PhotovoltaicSys": "api/ieslab-opt/rest/dpcs/",
+        "WindPowerGenerator": "api/ieslab-opt/rest/dpcs/",
+        "GasTurbine": "api/ieslab-opt/rest/dpcs/",
+        "HeatPump": "api/ieslab-opt/rest/dhscs/",
+        "GasBoiler": "api/ieslab-opt/rest/dhscs/",
+        "HPSolarCollector": "api/ieslab-opt/rest/dhscs/",
+        "SingleConChiller": "api/ieslab-opt/rest/dhscs/",
+        "DualConChiller": "api/ieslab-opt/rest/dhscs/",
+        "AbsorptionChiller": "api/ieslab-opt/rest/dhscs/",
+        "Battery": "api/ieslab-opt/rest/escs/",
+        "IceStorageAC": "api/ieslab-opt/rest/escs/",
+        "Transformer": "api/ieslab-opt/rest/dstcs/",
+        "TransferLine": "api/ieslab-opt/rest/dstcs/",
+        "MMC": "api/ieslab-opt/rest/dstcs/",
+        "CentrifugalPump": "api/ieslab-opt/rest/hstcs/",
+        "Pipe": "api/ieslab-opt/rest/hstcs/",
+        "heatingLoad": "api/ieslab-opt/rest/heatingLoad/",
+        "coolingLoad": "api/ieslab-opt/rest/coolingLoad/",
+        "electricLoads": "api/ieslab-opt/rest/electricLoads/",
+        "fuels": "api/ieslab-opt/rest/fuels/",
+        "HVACHeating": "api/ieslab-opt/rest/hots/",
+        "HVACCooling": "api/ieslab-opt/rest/colds/",
+        "常数电价": "api/ieslab-opt/rest/elects/",
+        "分时电价": "api/ieslab-opt/rest/elects/",
+        "阶梯电价": "api/ieslab-opt/rest/elects/",
+        "分时阶梯电价": "api/ieslab-opt/rest/elects/",
+        "typhoon":  "api/ieslab-opt/rest/typhoon/",
+        "rainfall": "api/ieslab-opt/rest/rainfall/",
+        "earthquake": "api/ieslab-opt/rest/earthquake/",
+        "extremeCold": "api/ieslab-opt/rest/extremeCold/",
+        "HydrogenTank": "api/ieslab-opt/rest/escs/",
+        "HeatStoTank": "api/ieslab-opt/rest/escs/",
+        "HeatExchanger": "api/ieslab-opt/rest/hstcs/",
+        "HydrogenCompression": "api/ieslab-opt/rest/hsec/",
+        "HydrogenLoad": "api/ieslab-opt/rest/hydrogenLoad/",
+        "HydrogenProductionFuels": "api/ieslab-opt/rest/hydrogen/",
+        "HydrogenTanker": "api/ieslab-opt/rest/hydrogen/",
+        "PEMF": "api/ieslab-opt/rest/dhscs/",
+        "SOFC": "api/ieslab-opt/rest/dhscs/",
+        "ALK": "api/ieslab-opt/rest/hpc/",
+        "PEME": "api/ieslab-opt/rest/hpc/",
+        "SOEC": "api/ieslab-opt/rest/hpc/",
     }
     pass

cloudpss/ieslab/EvaluationModel.py

@@ -1,13 +1,14 @@
 import time
-from cloudpss.runner.runner import HttpRunner, Runner
-from cloudpss.runner.IESLabEvaluationResult import IESLabEvaluationResult
+from cloudpss.runner.runner import HttpRunner, Runner, HttpOPTRunner
+from cloudpss.runner.IESLabEvaluationResult import IESLabPlanEvaluationResult, IESLabOptEvaluationResult
 from ..utils import request
 import json
 from enum import IntEnum, unique
 
 class IESLabEvaluationModel(object):
-    _baseUri = 'api/ieslab-plan/rest/'
-    _taskUri = 'api/ieslab-plan/taskmanager/getSimuLastTasks'
+    _baseUri = ''
+    _taskUri = ''
+    _runUri = ''
     _kindNameMap = {
         "投资组成": "investmentbanchandproportion",
         "资金来源": "capitalsource",
@@ -123,16 +124,16 @@ class IESLabEvaluationModel(object):
                 dict_result[v] = list['results']
         return dict_result
 
-    def run(self, planID, type=None) -> Runner[IESLabEvaluationResult]:
+    def run(self, planID, type=None) -> HttpRunner[IESLabPlanEvaluationResult]:
         '''
             运行方案评估
 
             :param planID int类型，表示优化方案的ID，数值位于0~优化方案数量之间
             :params type:  string类型，任务类型：环保评价/能效评价
 
-            :return: Runner[IESLabEvaluationResult]
+            :return: Runner[IESLabPlanEvaluationResult]
         '''
-        url = 'api/ieslab-plan/taskmanager/saveDataToclickhouse'
+        url =  self._runUri
         CMD_TYPE = type if type is None else self._evaluationType[type]
         try:
             timeId = int(time.time() * 1000)
@@ -172,7 +173,7 @@ class IESLabEvaluationModel(object):
         '''
         return self.run(planID, 'energyEvaluation')
 
-    def GetRunner(self, planID) -> Runner[IESLabEvaluationResult]:
+    def GetRunner(self, planID) -> Runner[IESLabPlanEvaluationResult]:
         '''
             获得运行实例
 
@@ -186,4 +187,74 @@ class IESLabEvaluationModel(object):
 @unique
 class OptimizationMode(IntEnum):
     经济性 = 0
-    环保性 = 1
+    环保性 = 1
+
+
+class IESLabPlanEvaluationModel(IESLabEvaluationModel):
+    _baseUri = 'api/ieslab-plan/rest/'
+    _taskUri = 'api/ieslab-plan/taskmanager/getSimuLastTasks'
+    _runUri = 'api/ieslab-plan/taskmanager/saveDataToclickhouse'
+
+    def run(self, planID, type=None) -> HttpRunner[IESLabPlanEvaluationResult]:
+        '''
+            运行方案评估
+
+            :param planID int类型，表示优化方案的ID，数值位于0~优化方案数量之间
+            :params type:  string类型，任务类型：环保评价/能效评价
+
+            :return: HttpRunner[IESLabEvaluationResult]
+        '''
+        url =  self._runUri
+        CMD_TYPE = type if type is None else self._evaluationType[type]
+        try:
+            timeId = int(time.time() * 1000)
+            r = request('GET',
+                        url,
+                        params={
+                            "simuid": self.simulationId,
+                            "planId": planID,
+                            "CMD_TYPE": CMD_TYPE
+                        })
+            data = json.loads(r.text)
+            return HttpRunner({'rid': 'function/ieslab/evaluation'},
+                self.simulationId,
+                timeId=timeId,
+                planId=planID,
+                cmdType=CMD_TYPE)
+        except:
+            raise Exception('方案评估开始计算失败')
+
+
+class IESLabOptEvaluationModel(IESLabEvaluationModel):
+    _baseUri = 'api/ieslab-opt/rest/'
+    _taskUri = 'api/ieslab-opt/taskmanager/getSimuLastTasks'
+    _runUri = 'api/ieslab-opt/taskmanager/saveDataToclickhouse'
+
+    def run(self, planID, type=None) -> HttpOPTRunner[IESLabOptEvaluationResult]:
+        '''
+            运行方案评估
+
+            :param planID int类型，表示优化方案的ID，数值位于0~优化方案数量之间
+            :params type:  string类型，任务类型：环保评价/能效评价
+
+            :return: HttpRunner[IESLabEvaluationResult]
+        '''
+        url =  self._runUri
+        CMD_TYPE = type if type is None else self._evaluationType[type]
+        try:
+            timeId = int(time.time() * 1000)
+            r = request('GET',
+                        url,
+                        params={
+                            "simuid": self.simulationId,
+                            "planId": planID,
+                            "CMD_TYPE": CMD_TYPE
+                        })
+            data = json.loads(r.text)
+            return HttpOPTRunner({'rid': 'function/ieslab/evaluation'},
+                self.simulationId,
+                timeId=timeId,
+                planId=planID,
+                cmdType=CMD_TYPE)
+        except:
+            raise Exception('方案评估开始计算失败')

cloudpss/ieslab/IESLabOpt.py

@@ -0,0 +1,235 @@
+import json
+
+from cloudpss.ieslab.DataManageModel import IESOptDataManageModel
+from cloudpss.ieslab.EvaluationModel import IESLabOptEvaluationModel
+from cloudpss.ieslab.PlanModel import IESLabOptModel
+from cloudpss.runner.IESLabTypicalDayResult import IESLabTypicalDayResult
+from ..utils import request
+from ..model.model import Model
+from cloudpss.runner.runner import  Runner
+from cloudpss.runner.IESLabPlanResult import IESLabOptResult
+from cloudpss.runner.IESLabEvaluationResult import IESLabOptEvaluationResult
+
+class IESLabOpt(object):
+    def __init__(self, project={}):
+        '''
+            初始化
+        '''
+        self.id = project.get('id', None)
+        self.name = project.get('name', None)
+        self.__modelRid = project.get('model', None)
+        self.project_group = project.get('project_group', None)
+        self.start_date = project.get('start_date', None)
+        self.end_date = project.get('end_date', None)
+        if self.__modelRid is not None:
+            self.model = Model.fetch(self.__modelRid)
+        self.dataManageModel = IESOptDataManageModel(self.id)
+        self.planModel = IESLabOptModel(self.id, self.model.rid)
+        self.evaluationModel = IESLabOptEvaluationModel(self.id)
+        self.currentPlanResult = IESLabOptResult(self.id)
+        self.currentEvaluationResult = IESLabOptEvaluationResult(self.id)
+
+    @staticmethod
+    def fetch(simulationId):
+        '''
+            获取算例信息
+
+            :params: simulationId string类型，代表数据项的算例id
+
+            :return: IESLabOpt
+        '''
+        try:
+            r = request('GET',
+                        'api/ieslab-opt/rest/simu/{0}/'.format(simulationId))
+            project = json.loads(r.text)
+            return IESLabOpt(project)
+        except:
+            raise Exception('未查询到当前算例')
+
+    def __run(self, job=None, name=None):
+        '''
+            调用仿真 
+
+            :params job:  调用仿真时使用的计算方案，不指定将使用算例保存时选中的计算方案
+            :params name:  任务名称，为空时使用项目的参数方案名称和计算方案名称
+
+            :return: 返回一个运行实例
+        '''
+        if job is None:
+            currentJob = self.model.context['currentJob']
+            job = self.model.jobs[currentJob]
+        job['args']['simulationId'] = self.id
+        return self.model.run(job, name=name)
+
+    def iesLabTypicalDayRun(self, job=None, name=None, **kwargs)->Runner[IESLabTypicalDayResult]:
+        '''
+            运行典型日计算 
+
+            :params job:  调用仿真时使用的计算方案，不指定将使用算例保存时选中的计算方案
+            :params name:  任务名称，为空时使用项目的参数方案名称和计算方案名称
+
+            :return: Runner[IESLabTypicalDayResult]
+        '''
+        if job is None:
+            currentJob = self.model.context['currentJob']
+            job = self.model.jobs[currentJob]
+            if job['rid'] != 'function/CloudPSS/ieslab-gmm-opt':
+                for j in self.model.jobs:
+                    if j['rid'] == 'job-definition/ies/ies-gmm-opt' or j['rid'] == 'job-definition/cloudpss/ieslab-gmm-opt':
+                        j['rid'] = 'function/CloudPSS/ieslab-gmm-opt'
+                        job = j
+        if job is None:
+            raise Exception("找不到默认的综合能源系统规划典型日生成算法的计算方案")
+        if job['rid'] != 'function/CloudPSS/ieslab-gmm-opt':
+            raise Exception("不是综合能源系统规划典型日生成算法的计算方案")
+        return self.__run(job=job, name=name)
+
+    def iesLabEvaluationRun(self, planId, type=None):
+        '''
+            运行方案评估
+
+            :param planID int类型，表示优化方案的ID，数值位于0~优化方案数量之间
+            :param type string类型，表示评估类型，可选值为：能效评价、环保评价
+
+            :return: 方案评估运行实例
+
+        '''
+        return self.evaluationModel.run(planId, type)
+
+    def iesLabEnergyEvaluationRun(self, planId):
+        '''
+            运行能效评价
+
+            :param planID int类型，表示优化方案的ID，数值位于0~优化方案数量之间
+
+            :return: 能效评价运行实例
+
+        '''
+        return self.evaluationModel.EnergyEvaluationRun(planId)
+
+    def iesLabEnvironmentalEvaluationRun(self, planId):
+        '''
+            运行环保评价
+
+            :param planID int类型，表示优化方案的ID，数值位于0~优化方案数量之间
+
+            :return: 环保评价运行实例
+        '''
+        return self.evaluationModel.EnvironmentalEvaluationRun(planId)
+
+    def iesLabOptRun(self):
+        '''
+            生成方案优选算例
+
+            :return: 方案优选运行实例
+        '''
+        return self.planModel.run()
+    
+    def iesLabOptKill(self):
+        '''
+            停止并删除方案优选算例
+
+            :return: Boolean
+        '''
+        return self.planModel.kill()
+    
+    def createProjectGroup(self, name):
+        '''
+            创建项目组
+
+            :params name: 项目组名称
+
+            :return: 返回一个创建的项目组
+        '''
+
+    @staticmethod
+    def createProjectGroup(group_name, desc=None, createById=None):
+        '''
+            创建项目组
+
+            :params group_name: String 项目组名称 
+            :params desc: String 项目组描述 可选参数
+            :params createById Int 父项目组id  可选参数，如果是从已有项目组导入的项目组，必填此项
+
+            :return: Int 返回创建的项目组id
+        '''
+        try:
+            if createById is None: 
+                isImport = 0
+            else:
+                isImport = 1
+            payload = {
+                'group_name': group_name,
+                'desc': desc,
+                'isImport': isImport,
+                'createById': createById,
+            }
+            r = request(
+                'POST', 'api/ieslab-opt/rest/projectgroup/', data=json.dumps(payload))
+            project = json.loads(r.text)
+            return project.get('id', None)
+        except Exception as e:
+            raise Exception('创建项目组失败')
+
+    @staticmethod  
+    def createProject(name, project_group, start_date, end_date, construction_cycle, desc=None, createById=None):
+        '''
+            创建项目
+
+            :params name: String 项目名称 
+            :params project_group: Int 父项目组id
+            :param start_date: Int 项目开始年限，范围在[1500,3000]之间
+            :param end_date: Int 项目结束年限，范围在项目开始时间之后且不超过五十年
+            :param construction_cycle: Int 项目建设周期(年), 必须小于等于 项目结束年限 - 项目开始年限
+            :params desc: String 项目描述, 可选参数
+            :params createById Int 父项目id, 可选参数, 如果是从已有项目导入的项目，必填此项
+
+            :return: Int 返回创建的项目id
+        '''
+        try:
+            if start_date < 1500 or start_date > 3000:
+                raise Exception('项目开始年限错误，范围在[1500,3000]之间')
+            if end_date < start_date or end_date > start_date + 50:
+                raise Exception('项目结束年限错误，范围在项目开始时间之后且不超过五十年')
+            if construction_cycle > end_date - start_date:
+                raise Exception('项目建设周期错误，必须小于等于 项目结束年限 - 项目开始年限')
+            if createById is None: 
+                payload = {
+                    'name': name,
+                    'project_group': project_group,
+                    'start_date': start_date,
+                    'end_date': end_date,
+                    'construction_cycle': construction_cycle,
+                    'desc': desc
+                }
+            else:
+                payload = {
+                    'name': name,
+                    'project_group': project_group,
+                    'start_date': start_date,
+                    'end_date': end_date,
+                    'construction_cycle': construction_cycle,
+                    'desc': desc,
+                    'createById': createById
+                }
+            r = request(
+                'POST', 'api/ieslab-opt/rest/simu/', data=json.dumps(payload))
+            project = json.loads(r.text)
+            return project.get('id', None)
+        except Exception as e:
+            raise Exception('创建项目失败')
+
+
+    @staticmethod
+    def getProjectList():
+        '''
+            获取项目组列表
+
+            :return: 返回项目组列表
+        '''
+        try:
+            r = request('GET', 'api/ieslab-opt/rest/projectgroup/?mode=simu')
+            project = json.loads(r.text)
+            return project
+        except Exception as e:
+            raise Exception('获取项目组列表失败')