transformer basic sketch

Author: amzhao16

README.md

@@ -23,7 +23,7 @@ NOTE: will be moved to Dai lab repository
 
 # Overview
 
-TODO: Provide a short overview of the project here.
+PyGridSim aims to provide accessible access to tools like OpenDSS, AltDSS using Python. The goal is to create large-scale electrical circuits representing residential neighborhoods (and other scenarios) using an intuitive interface, without any background in OpenDSS software.
 
 # Install
 
@@ -88,7 +88,7 @@ for more details about this process.
 In this short tutorial we will guide you through a series of steps that will help you
 getting started with **PyGridSim**.
 
-TODO: Create a step by step guide here.
+TODO: Create a step by step guide here. Also figure out how to ensure prerequisites properly.
 
 # What's next?
 

pygridsim/__pycache__/core.cpython-312.pyc

@@ -1,15 +1,20 @@
 from core import PyGridSim
-from enums import LineType, SourceType
+from enums import LineType, SourceType, LoadType
+from altdss import altdss
 
 """
 Goal: to be able to very easily make a scalable circuit that represents a residential district
 """
 
 circuit = PyGridSim()
-circuit.add_source_nodes(num=1)
-circuit.add_load_nodes(num=4)
-circuit.add_lines([("source0", "load0"), ("source0", "load2")], LineType.INDUSTRIAL_LV_LINE)
+circuit.add_source_nodes(num_in_batch=10, source_type=SourceType.SOLAR_PANEL)
+circuit.add_load_nodes(num=4, load_type=LoadType.HOUSE)
+circuit.add_lines([("source", "load0"), ("source", "load3")], LineType.MV_LINE)
+circuit.add_transformers([("source", "load0")])
 circuit.solve()
 print(circuit.results(["BusVMag"]))
 
-# using solar panel leads to a lot lower kv obviously
+"""
+print(circuit.view_load_nodes())
+print(circuit.view_source_node())
+"""

pygridsim/__pycache__/defaults.cpython-312.pyc

@@ -5,7 +5,8 @@
 from parameters import make_load_node, make_source_node
 from queries import query_solution
 from lines import make_line
-from enums import LineType, SourceType
+from transformers import make_transformer
+from enums import LineType, SourceType, LoadType
 
 """Main module."""
 
@@ -14,14 +15,12 @@ def __init__(self):
 		"""
 		Initialize OpenDSS/AltDSS engine. Creates an Empty Circuit
 		"""
-		self.load_nodes = []
 		self.num_loads = 0
-		self.source_nodes = []
-		self.num_sources = 0
 		self.num_lines = 0
+		self.num_transformers = 0
 		altdss('new circuit.IEEE13Nodeckt')
 
-	def add_load_nodes(self, load_params = {}, num = 1):
+	def add_load_nodes(self, load_params = {}, load_type: LoadType = LoadType.HOUSE, num = 1):
 		"""
 		When the user wants to manually add nodes, or make nodes with varying parameters.
 
@@ -34,30 +33,26 @@ def add_load_nodes(self, load_params = {}, num = 1):
 		"""
 		load_nodes = []
 		for i in range(num):
-			load_nodes.append(make_load_node(load_params, self.num_loads))
+			make_load_node(load_params, load_type, self.num_loads)
 			self.num_loads += 1
-		self.load_nodes += load_nodes
 		return load_nodes
 
-	def add_source_nodes(self, source_params = {}, num = 1, source_type: SourceType = SourceType.TURBINE):
+	def add_source_nodes(self, source_params = {}, source_type: SourceType = SourceType.TURBINE, num_in_batch = 1):
 		"""
 		When the user wants to manually add nodes, or make nodes with varying parameters.
 
 		Args:
 			source_params: load parameters for these manual additions
 			lines: which nodes these new sources are connected to
-			num (optional): number of sources to create with these parameters
+			num (optional): number of sources to create with these parameters (removed for now)
+			num_in_batch: how many to batch together directly (so they can't be connected to lines separately, etc.
+				most common use case is if a house has 20 solar panels it's more useful to group them together)
 		Return:
 			List of source_nodes
 		"""
-		source_nodes = []
-		for i in range(num):
-			source_nodes.append(make_source_node(source_params, self.num_sources, source_type))
-			self.num_sources += 1
-		self.source_nodes += source_nodes
-		return source_nodes
-	
-	def add_lines(self, connections, line_type: LineType = LineType.RESIDENTIAL_LV_LINE, params = {}):
+		return make_source_node(source_params, source_type, num_in_batch=num_in_batch)
+
+	def add_lines(self, connections, line_type: LineType = LineType.LV_LINE, params = {}):
 		"""
 		Specify all lines that the user wants to add. If redundant lines, doesn't add anything
 
@@ -69,6 +64,17 @@ def add_lines(self, connections, line_type: LineType = LineType.RESIDENTIAL_LV_L
 			make_line(src, dst, line_type, self.num_lines, params)
 			self.num_lines += 1
 
+	def add_transformers(self, connections, params = {}):
+		"""
+		Specify all transformers that the user wants to add, same input style as lines.
+
+		Args:
+			connections: a list of new transformers to add (where to add them), with these params
+		"""
+		for src, dst in connections:
+			make_transformer(src, dst, self.num_transformers, params)
+			self.num_transformers += 1
+
 
 	def view_load_nodes(self, indices = []):
 		"""
@@ -78,17 +84,36 @@ def view_load_nodes(self, indices = []):
 			indices (optional): Which indices to view the nodes at.
 				If none given, display all
 		"""
+		load_nodes = []
+		if not indices:
+			indices = [i for i in range(self.num_loads)]
+		
+		for idx in indices:
+			load_obj = altdss.Load["load" + str(idx)]
+			load_info = {}
+			load_info["name"] = "load" + str(idx)
+			load_info["kV"] = load_obj.kV
+			load_info["kW"] = load_obj.kW
+			load_info["kVar"] = load_obj.kvar
+			load_nodes.append(load_info)
+		return load_nodes
 
 
-	def view_source_nodes(self, indices = []):
+	def view_source_node(self):
 		"""
 		View source nodes (what their parameters are) at the given indices.
 
 		Args:
 			indices (optional): Which indices to view the nodes at.
 				If none given, display all
-		"""
-	
+		
+		TODO once capability for more source nodes is initialized
+		"""
+		source_obj = altdss.Vsource["source"]
+		source_info = {}
+		source_info["name"] = "source"
+		source_info["kV"] = source_obj.BasekV
+		return source_info
 
 	def solve(self):
 		"""

pygridsim/__pycache__/enums.cpython-312.pyc

@@ -29,29 +29,33 @@
 
 """
 Load Nodes
+kW: around 30 kWH a day, divide by 24 hours
+kVar is like around 0.2 or 0.1 of what kVar is 
 """
-HOUSE_KV = [120, 240]
-HOUSE_KW = [1, 1.4]
-HOUSE_KVAR = 0.6 # unclear
+HOUSE_KV = [.12, .24]
+HOUSE_KW = [1, 1.5]
+HOUSE_KVAR = [0.5, 1] # unclear
+
+COMMERCIAL_KV = [.24, .48]
+COMMERCIAL_KW = [10, 50]
+COMMERCIAL_KVAR = [5, 10]
+
+INDUSTRIAL_KV = [.24, .48]
+INDUSTRIAL_KW = [30, 100]
+INDUSTRIAL_KVAR = [20, 25]
 
 """
 Source Nodes
 TODO also fuel cells, other less common forms of energy later
 """
 
-TURBINE_BASE_KV = [0.55,0.7]
-SOLAR_PANEL_BASE_KV = [0.0005, 0.0006] # per solar panel
+TURBINE_BASE_KV = [3000,4000]
+SOLAR_PANEL_BASE_KV = [0.2, 0.4] # per solar panel
 
 """
 Units: KM
 LV = Low Voltage, MV = Medium Voltage
-Based on IEEE standards
-"""
-RESIDENTIAL_LV_LINE_LENGTH = [0.05, 0.3]
-RESIDENTIAL_MV_LINE_LENGTH = [1, 10]
-RURAL_LV_LINE_LENGTH = [0.1 ,0.5]
-RURAL_MV_LINE_LENGTH = [10, 50]
-INDUSTRIAL_LV_LINE_LENGTH = [0.01, 0.2]
-INDUSTRIAL_MV_LINE_LENGTH = [1,5]
-URBAN_LV_LINE_LENGTH = [0.02, 0.2]
-URBAN_MV_LINE_LENGTH = [1,10]
+"""
+LV_LINE_LENGTH = [30, 60]
+MV_LINE_LENGTH = [60, 160]
+HV_LINE_LENGTH = [160,300]