Fix Installation.rst (#787)

* Fix Installation.rst

* Update doc/source/Resources/Installation.rst

Co-authored-by: Maxime Rey <[email protected]>

* improved documentation

* improved toolkit.py

Co-authored-by: Maxime Rey <[email protected]>

Author: maxcapodi78

doc/source/Resources/Installation.rst

@@ -45,19 +45,23 @@ Installing Pyaedt from Bat File
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 Ansys Electronics Desktop already includes a CPython 3.7 that could be used to run pyaedt.
 User can download the following batch file and run in local machine.
+
+:download:`PyAEDT Environment with IDE bat file <pyaedt_with_IDE.bat>`
+
 The batch file works on Windows and executes the following steps:
-1. Create a python virtual environment in your %APPDATA% folder. To do that it uses CPython in your latest version of AEDT installed in your machine.
-2. Install Pyaedt.
-3. Install Spyder.
-4. Install Jupyter Lab.
-5. Create a symbolic link from pyaedt installation to Ansys PersonalLib. In this way scripts can be run also within AEDT.
+
+1. Create a python virtual environment in your ``%APPDATA%`` folder. To do that, use CPython in your latest version of AEDT installed on your machine.
+2. Install ``pyaedt``.
+3. Install ``spyder``.
+4. Install ``Jupyter Lab``.
+5. Create a symbolic link from pyaedt installation to Ansys AEDT ``PersonalLib``. In this way scripts can be run also within AEDT.
 6. Update pyaedt
 7. Run the tool you choose (Spyder, Jupyter or simple console).
 
 Steps from 1 to 5 are executed only first time. Step 6 is executed only running the command with
 the following option:
-    pyaedt_with_IDE.bat -update
+
+``pyaedt_with_IDE.bat -update``
 
 With this approach users can have a complete IDE to write Pyaedt Scripts in Windows with a simple batch file.
 
-:download:`PyAEDT Environment with IDE <pyaedt_with_IDE.bat>`

doc/source/create_documentation.bat

@@ -1 +1 @@
-sphinx-build -b html -a . ../../../PyAEDT-docs -j auto
+sphinx-build -b html -a . ../../../PyAEDT-docs_dev -j auto

pyaedt/generic/toolkit.py

@@ -713,16 +713,11 @@ class WPFToolkit(Window):
 
     def __init__(self, toolkit_file, aedt_design=None, parent_design_name=None):
 
-        my_path = os.path.abspath(os.path.dirname(__file__))
+        self.toolkit_file = toolkit_file
+        self._aedtdesign = None
         self.aedtdesign = aedt_design
-        self.toolkit_name = os.path.basename(toolkit_file).replace(".py", "")
-        if self.aedtdesign:
-            self.settings_manager = WPFToolkitSettings(aedtdesign=self.aedtdesign, toolkit_name=self.toolkit_name)
-        else:
-            self.settings_manager = WPFToolkitSettings(working_directory=my_path, toolkit_name=self.toolkit_name)
-
+        self.parent_design_name = parent_design_name
         self.window = None
-
         self.ui = UIObjectGetter(self)
         my_path = os.path.abspath(os.path.dirname(__file__))
         self.toolkit_directory = os.path.abspath(os.path.dirname(toolkit_file))
@@ -731,19 +726,6 @@ def __init__(self, toolkit_file, aedt_design=None, parent_design_name=None):
         sys.path.append(self.aedtlib_directory)
         self.image_path = os.path.join(self.aedtlib_directory, "misc")
 
-        if parent_design_name:
-            self.parent_design_name = parent_design_name
-            if not parent_design_name in self.aedtdesign.design_list:
-                orig_design_name = self.aedtdesign.design_name
-                if self.parent_design_name != orig_design_name:
-                    self._write_parent_link()
-                    self.aedtdesign.duplicate_design(self.parent_design_name)
-                    self.aedtdesign.save_project()
-            else:
-                self.aedtdesign.set_active_design(parent_design_name)
-        else:
-            self.parent_design_name = self.aedtdesign.design_name
-
         self.dsoconfigfile = os.path.join(self.toolkit_directory, "dso.cfg")
 
         # Read existing settings and update the library path
@@ -752,6 +734,50 @@ def __init__(self, toolkit_file, aedt_design=None, parent_design_name=None):
         # LOCAL_INSTALL = self.aedtdesign.odesktop.GetExeDir()
         # self.desktopjob = os.path.join(LOCAL_INSTALL, "desktopjob.exe")
 
+    @property
+    def aedtdesign(self):
+        """Return Aedt Object."""
+        return self._aedtdesign
+
+    @aedtdesign.setter
+    def aedtdesign(self, design):
+        my_path = os.path.abspath(os.path.dirname(__file__))
+        self._aedtdesign = design
+        self.toolkit_name = os.path.basename(self.toolkit_file).replace(".py", "")
+        if self._aedtdesign:
+            self.settings_manager = WPFToolkitSettings(aedtdesign=self._aedtdesign, toolkit_name=self.toolkit_name)
+            self._parent_design_name = self._aedtdesign.design_name
+        else:
+            self.settings_manager = WPFToolkitSettings(working_directory=my_path, toolkit_name=self.toolkit_name)
+            self._parent_design_name = None
+
+    @property
+    def parent_design_name(self):
+        """Aedt Design Name."""
+
+        if self.aedtdesign:
+            self._parent_design_name = self.aedtdesign.design_name
+        else:
+            self._parent_design_name = None
+        return self._parent_design_name
+
+    @parent_design_name.setter
+    def parent_design_name(self, design_name=None):
+        if not self.aedtdesign:
+            self._parent_design_name = None
+        elif design_name:
+            self._parent_design_name = design_name
+            if not design_name in self.aedtdesign.design_list:
+                orig_design_name = self.aedtdesign.design_name
+                if self._parent_design_name != orig_design_name:
+                    self._write_parent_link()
+                    self.aedtdesign.duplicate_design(self._parent_design_name)
+                    self.aedtdesign.save_project()
+            else:
+                self.aedtdesign.set_active_design(design_name)
+        else:
+            self._parent_design_name = self.aedtdesign.design_name
+
     @property
     def results_path(self):
         """Results folder path."""
@@ -810,6 +836,41 @@ def _add_line_to_xml(self, line_to_add):
                 f.write(line)
         shutil.move(self.xaml_file[:-5] + "_tmp.xaml", self.xaml_file)
 
+    @aedt_exception_handler
+    def edit_window_size(self, width=800, height=600, title="PyAEDT WPF Application", background="#FFD1CFCF"):
+        """Edit the Wpf windows size.
+
+        Parameters
+        ----------
+        width : int, optional
+            Windows width.
+        height : int, optional
+            Windows height.
+        title : str, optional
+            Windows title.
+        background : str, optional
+            Windows color in hex mode.
+
+        Returns
+        -------
+        bool
+            `True` if succeeded.
+        """
+        with open(self.xaml_file, "r") as file:
+            file = file.readlines()
+        line_to_add = '        Title="{}" Height="{}" Width="{}" Background="{}">'.format(
+            title, height, width, background
+        )
+
+        with open(self.xaml_file[:-5] + "_tmp.xaml", "w") as f:
+            for line in file:
+                if "       Title=" in line:
+                    f.write(line_to_add + "\n")
+                else:
+                    f.write(line)
+        shutil.move(self.xaml_file[:-5] + "_tmp.xaml", self.xaml_file)
+        return True
+
     @aedt_exception_handler
     def add_label(self, name, content, x_pos, y_pos):
         """Adds a label to Wpf.