Major upgrade with several fixes and new features

- Update thunk and fix other code translation issues
- Complement `get_*_array` functions to pass parameters
- Properly implement ActiveCircuit.Buses, ActiveCircuit.CktElements, ActiveCktElement.Properties
- CtrlQueue: Add missing `Push` method
- Several changes to match DSS Python (more_idx branch, lots of new idx properties)
- Expose public methods to allow using the `methods` function
- Update iterable classes to match current DSS Python
- Add new methods from DSS C-API (Transformers.LossesByType, Transformers.AllLossesByType, DSS.AllowEditor)
- Tentative fix for `CktElement.Variablei`
- Tweak doc strings
- More error checking

Author: PMeira

+DSS_MATLAB/Base.m

@@ -14,7 +14,13 @@
             end
         end
     end
+
+    methods (Access = public)
+
+    end
+
     methods
+
         function obj = CheckForError(obj)
             error = calllib('dss_capi_v7', 'Error_Get_Number');
             if error ~= 0

+DSS_MATLAB/IActiveClass.m

@@ -20,6 +20,9 @@
         NumElements
     end
 
+    methods (Access = public)
+
+    end
     methods
 
         function result = get.ActiveClassName(obj)

+DSS_MATLAB/IBus.m

@@ -19,7 +19,7 @@
     %    SeqVoltages - (read-only) Double Array of sequence voltages at this bus.
     %    TotalMiles - (read-only) Total length of line downline from this bus, in miles. For recloser siting algorithm.
     %    VLL - (read-only) For 2- and 3-phase buses, returns array of complex numbers represetin L-L voltages in volts. Returns -1.0 for 1-phase bus. If more than 3 phases, returns only first 3.
-    %    VMagAngle - (read-only) Variant Array of doubles containing voltages in Magnitude (VLN), angle (deg) 
+    %    VMagAngle - (read-only) Variant Array of doubles containing voltages in Magnitude (VLN), angle (deg)
     %    Voc - (read-only) Open circuit voltage; Complex array.
     %    Voltages - (read-only) Complex array of voltages at this bus.
     %    YscMatrix - (read-only) Complex array of Ysc matrix at bus. Column by column.
@@ -70,7 +70,7 @@
         y
     end
 
-    methods
+    methods (Access = public)
 
         function result = GetUniqueNodeNumber(obj, StartNumber)
             result = calllib('dss_capi_v7', 'Bus_GetUniqueNodeNumber', StartNumber);
@@ -80,6 +80,9 @@
             result = (calllib('dss_capi_v7', 'Bus_ZscRefresh') ~= 0);
         end
 
+    end
+    methods
+
         function result = get.Coorddefined(obj)
             % (read-only) False=0 else True. Indicates whether a coordinate has been defined for this bus
             result = (calllib('dss_capi_v7', 'Bus_Get_Coorddefined') ~= 0);

+DSS_MATLAB/ICNData.m

@@ -2,12 +2,13 @@
     % ICNData: DSS MATLAB interface class to DSS C-API
     % 
     % Properties:
-    %    AllNames - (read-only) Array of strings with names of all devices
+    %    AllNames - Array of strings with all CNData names
+    %    Count - Number of CNData objects
+    %    First - Set first object of CNData; returns 0 if none.
+    %    Name - Get/sets the name of the current active CNData
+    %    Next - Sets next CNData active; returns 0 if no more.
+    %    idx - Sets next CNData active; returns 0 if no more.
     %    Conductors - (read-only) Array of strings with names of all conductors in the active CNData object
-    %    Count - (read-only) Number of CNData
-    %    First - 
-    %    Next - 
-    %    Name - Name of active CNData
     %    EmergAmps - Emergency ampere rating
     %    NormAmps - Normal Ampere rating
     %    Rdc - 
@@ -29,11 +30,12 @@
 
     properties
         AllNames
-        Conductors
         Count
         First
-        Next
         Name
+        Next
+        idx
+        Conductors
         EmergAmps
         NormAmps
         Rdc
@@ -54,40 +56,55 @@
         RStrand
     end
 
+    methods (Access = public)
+
+    end
     methods
 
         function result = get.AllNames(obj)
-            % (read-only) Array of strings with names of all devices
+            % Array of strings with all CNData names
             result = DSS_MATLAB.get_string_array('CNData_Get_AllNames');
         end
 
-        function result = get.Conductors(obj)
-            % (read-only) Array of strings with names of all conductors in the active CNData object
-            result = DSS_MATLAB.get_string_array('CNData_Get_Conductors');
-        end
-
         function result = get.Count(obj)
-            % (read-only) Number of CNData
+            % Number of CNData objects
             result = calllib('dss_capi_v7', 'CNData_Get_Count');
         end
 
         function result = get.First(obj)
+            % Set first object of CNData; returns 0 if none.
             result = calllib('dss_capi_v7', 'CNData_Get_First');
         end
 
-        function result = get.Next(obj)
-            result = calllib('dss_capi_v7', 'CNData_Get_Next');
-        end
-
         function result = get.Name(obj)
-            % Name of active CNData
+            % Get/sets the name of the current active CNData
             result = calllib('dss_capi_v7', 'CNData_Get_Name');
         end
         function obj = set.Name(obj, Value)
             calllib('dss_capi_v7', 'CNData_Set_Name', Value);
             obj.CheckForError();
         end
 
+        function result = get.Next(obj)
+            % Sets next CNData active; returns 0 if no more.
+            result = calllib('dss_capi_v7', 'CNData_Get_Next');
+        end
+
+        function result = get.idx(obj)
+            % Get/set active CNData by index;  1..Count
+            result = calllib('dss_capi_v7', 'CNData_Get_idx');
+        end
+        function obj = set.idx(obj, Value)
+            calllib('dss_capi_v7', 'CNData_Set_idx', Value);
+            obj.CheckForError();
+        end
+
+
+        function result = get.Conductors(obj)
+            % (read-only) Array of strings with names of all conductors in the active CNData object
+            result = DSS_MATLAB.get_string_array('CNData_Get_Conductors');
+        end
+
         function result = get.EmergAmps(obj)
             % Emergency ampere rating
             result = calllib('dss_capi_v7', 'CNData_Get_EmergAmps');

+DSS_MATLAB/ICapControls.m

@@ -2,19 +2,20 @@
     % ICapControls: DSS MATLAB interface class to DSS C-API
     % 
     % Properties:
-    %    AllNames - (read-only) Array of strings with all CapControl names.
+    %    AllNames - Array of strings with all CapControl names
+    %    Count - Number of CapControl objects
+    %    First - Set first object of CapControl; returns 0 if none.
+    %    Name - Get/sets the name of the current active CapControl
+    %    Next - Sets next CapControl active; returns 0 if no more.
+    %    idx - Sets next CapControl active; returns 0 if no more.
     %    CTratio - Transducer ratio from pirmary current to control current.
     %    Capacitor - Name of the Capacitor that is controlled.
-    %    Count - (read-only) Number of CapControls in Active Circuit
     %    DeadTime - 
     %    Delay - Time delay [s] to switch on after arming.  Control may reset before actually switching.
     %    DelayOff - Time delay [s] before swithcing off a step. Control may reset before actually switching.
-    %    First - (read-only) Sets the first CapControl as active. Return 0 if none.
     %    Mode - Type of automatic controller.
     %    MonitoredObj - Full name of the element that PT and CT are connected to.
     %    MonitoredTerm - Terminal number on the element that PT and CT are connected to.
-    %    Name - Sets a CapControl active by name.
-    %    Next - (read-only) Gets the next CapControl in the circut. Returns 0 if none.
     %    OFFSetting - Threshold to switch off a step. See Mode for units.
     %    ONSetting - Threshold to arm or switch on a step.  See Mode for units.
     %    PTratio - Transducer ratio from primary feeder to control voltage.
@@ -27,18 +28,19 @@
 
     properties
         AllNames
+        Count
+        First
+        Name
+        Next
+        idx
         CTratio
         Capacitor
-        Count
         DeadTime
         Delay
         DelayOff
-        First
         Mode
         MonitoredObj
         MonitoredTerm
-        Name
-        Next
         OFFSetting
         ONSetting
         PTratio
@@ -47,17 +49,54 @@
         Vmin
     end
 
-    methods
+    methods (Access = public)
 
         function obj = Reset(obj)
             calllib('dss_capi_v7', 'CapControls_Reset');
         end
 
+    end
+    methods
+
         function result = get.AllNames(obj)
-            % (read-only) Array of strings with all CapControl names.
+            % Array of strings with all CapControl names
             result = DSS_MATLAB.get_string_array('CapControls_Get_AllNames');
         end
 
+        function result = get.Count(obj)
+            % Number of CapControl objects
+            result = calllib('dss_capi_v7', 'CapControls_Get_Count');
+        end
+
+        function result = get.First(obj)
+            % Set first object of CapControl; returns 0 if none.
+            result = calllib('dss_capi_v7', 'CapControls_Get_First');
+        end
+
+        function result = get.Name(obj)
+            % Get/sets the name of the current active CapControl
+            result = calllib('dss_capi_v7', 'CapControls_Get_Name');
+        end
+        function obj = set.Name(obj, Value)
+            calllib('dss_capi_v7', 'CapControls_Set_Name', Value);
+            obj.CheckForError();
+        end
+
+        function result = get.Next(obj)
+            % Sets next CapControl active; returns 0 if no more.
+            result = calllib('dss_capi_v7', 'CapControls_Get_Next');
+        end
+
+        function result = get.idx(obj)
+            % Get/set active CapControl by index;  1..Count
+            result = calllib('dss_capi_v7', 'CapControls_Get_idx');
+        end
+        function obj = set.idx(obj, Value)
+            calllib('dss_capi_v7', 'CapControls_Set_idx', Value);
+            obj.CheckForError();
+        end
+
+
         function result = get.CTratio(obj)
             % Transducer ratio from pirmary current to control current.
             result = calllib('dss_capi_v7', 'CapControls_Get_CTratio');
@@ -76,11 +115,6 @@
             obj.CheckForError();
         end
 
-        function result = get.Count(obj)
-            % (read-only) Number of CapControls in Active Circuit
-            result = calllib('dss_capi_v7', 'CapControls_Get_Count');
-        end
-
         function result = get.DeadTime(obj)
             result = calllib('dss_capi_v7', 'CapControls_Get_DeadTime');
         end
@@ -107,11 +141,6 @@
             obj.CheckForError();
         end
 
-        function result = get.First(obj)
-            % (read-only) Sets the first CapControl as active. Return 0 if none.
-            result = calllib('dss_capi_v7', 'CapControls_Get_First');
-        end
-
         function result = get.Mode(obj)
             % Type of automatic controller.
             result = calllib('dss_capi_v7', 'CapControls_Get_Mode');
@@ -139,20 +168,6 @@
             obj.CheckForError();
         end
 
-        function result = get.Name(obj)
-            % Sets a CapControl active by name.
-            result = calllib('dss_capi_v7', 'CapControls_Get_Name');
-        end
-        function obj = set.Name(obj, Value)
-            calllib('dss_capi_v7', 'CapControls_Set_Name', Value);
-            obj.CheckForError();
-        end
-
-        function result = get.Next(obj)
-            % (read-only) Gets the next CapControl in the circut. Returns 0 if none.
-            result = calllib('dss_capi_v7', 'CapControls_Get_Next');
-        end
-
         function result = get.OFFSetting(obj)
             % Threshold to switch off a step. See Mode for units.
             result = calllib('dss_capi_v7', 'CapControls_Get_OFFSetting');