LightSim2Grid 0.8.1.dev0__tar.gz → 0.9.0__tar.gz

{LightSim2Grid-0.8.1.dev0 → lightsim2grid-0.9.0/LightSim2Grid.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: LightSim2Grid
-Version: 0.8.1.dev0
+Version: 0.9.0
 Summary: LightSim2Grid implements a c++ backend targeting the Grid2Op platform.
 Home-page: https://github.com/BDonnot/lightsim2grid/
 Author: Benjamin Donnot
@@ -27,8 +27,11 @@ Description-Content-Type: text/markdown
 License-File: LICENSE
 License-File: LICENSE.md
 License-File: AUTHORS.txt
-Requires-Dist: pandapower>=2.8
-Requires-Dist: pytest
+Requires-Dist: setuptools
+Requires-Dist: pip
+Requires-Dist: pybind11
+Requires-Dist: scipy
+Requires-Dist: numpy
 Provides-Extra: docs
 Requires-Dist: numpydoc>=0.9.2; extra == "docs"
 Requires-Dist: sphinx<7,>=2.4.4; extra == "docs"
@@ -50,7 +53,7 @@ Requires-Dist: numba; extra == "recommended"
 Provides-Extra: test
 Requires-Dist: grid2op>=1.6.4; extra == "test"
 Requires-Dist: numba; extra == "test"
-Requires-Dist: pandapower>=2.8.0; extra == "test"
+Requires-Dist: pandapower>=2.14.0; extra == "test"
 Requires-Dist: packaging; extra == "test"
 Requires-Dist: pypowsybl; extra == "test"
 
@@ -122,7 +125,7 @@ from lightsim2grid.newtonpf import newtonpf
 V, converged, iterations, J = newtonpf(Ybus, V, Sbus, ref, weights, pv, pq, ppci, options)
 ```
 
-This function uses the KLU algorithm and a c++ implementation of a Newton solver for speed.
+This function uses the KLU algorithm (when available) and a c++ implementation of a Newton solver for speed.
 
 ## Installation (from pypi official repository, recommended)
 
@@ -130,12 +133,13 @@ Since version 0.5.3, lightsim2grid is can be installed like most python packages
 `python -m pip install lightsim2grid`
 
 It includes faster grid2op backend and the `SuiteSparse` faster `KLU` solver, even on windows. This is definitely the 
-easiest method to install lightsim2grid on your system and have it running without too much issues.
+easiest method to install lightsim2grid on your system and have it running.
 
 Note though that these packages have been compiled on a different platform that the one you are using. You might still
-get some benefit (in terms of performances) to install it from your on your machine.
+get some benefit (in terms of performances) to install it from your on your machine with the proper compilations flags (
+see section [6.1 Customization of the compilation](#Customization-of-the-compilation) for more information)
 
-Pypi packages are available for linux, windows and macos with python versions: 
+Pypi packages are available for linux (`x86_64` cpu architecture), windows (`x86_64` cpu architecture) and macos (`x86_64` cpu architecture) with python versions: 
 
 - 3.7
 - 3.8
@@ -144,8 +148,17 @@ Pypi packages are available for linux, windows and macos with python versions:
 - 3.11 (lightsim2grid >= 0.7.1)
 - 3.12 (lightsim2grid >= 0.7.5)
 
+
+As from version 0.8.2, we also distribute windows `arm64` and macos `arm64` binaries of lightsim2grid that can be installed
+directly with pip too (requires python >= 3.8 for macos and python >= 3.9 for windows). We do not currently produce `arm64` (`aarch64`) linux binaries because it takes too long to build. If you really want them, let us know and we'll see what we can do.
+
+
 **NB** on some version of MacOs (thanks Apple !), especially the one using M1 or M2 chip, lightsim2grid is only available
-on pypi starting from version 0.7.3
+on pypi starting from version 0.7.3 We attempted to deliver arm64 lightsim2grid version but we could not test them. So if you 
+want a reliable working and tested version of lightsim2grid on newest version of macos (with M1 or M2 chips for example) please
+use lightsim2grid >= 0.8.2
+
+**NB** we do not currently build any 32 bits lightsim2grid libraries.
 
 ## Installation (from source, for more advanced user)
 
@@ -278,7 +291,7 @@ For example: `export PATH_NICSLU=/home/user/Documents/cktso`
 
 #### Enable 03 optimization
 By default, at least on ubuntu, only the "-O2" compiler flags is used. To use the O3 optimization flag, you need
-to specify the `__COMPLILE_O3` environment variable: `set __COMPLILE_O3=1` before the compilation (so before
+to specify the `__O3_OPTIM` environment variable: `set __O3_OPTIM=1` (or `$Env:__O3_OPTIM=1` in powershell) before the compilation (so before
 `python3 setup.py build` or `python -m pip install -e .`)
 
 This compilation argument will increase the compilation time, but will make the package faster.

{LightSim2Grid-0.8.1.dev0 → lightsim2grid-0.9.0}/LightSim2Grid.egg-info/SOURCES.txt

@@ -483,23 +483,28 @@ lightsim2grid/physical_law_checker.py
 lightsim2grid/securityAnalysis.py
 lightsim2grid/timeSerie.py
 lightsim2grid/_utils/__init__.py
+lightsim2grid/compilation_options/__init__.py
 lightsim2grid/elements/__init__.py
 lightsim2grid/gridmodel/__init__.py
-lightsim2grid/gridmodel/_aux_add_dc_line.py
-lightsim2grid/gridmodel/_aux_add_gen.py
-lightsim2grid/gridmodel/_aux_add_line.py
-lightsim2grid/gridmodel/_aux_add_load.py
-lightsim2grid/gridmodel/_aux_add_sgen.py
-lightsim2grid/gridmodel/_aux_add_shunt.py
-lightsim2grid/gridmodel/_aux_add_slack.py
-lightsim2grid/gridmodel/_aux_add_storage.py
-lightsim2grid/gridmodel/_aux_add_trafo.py
-lightsim2grid/gridmodel/_aux_check_legit.py
-lightsim2grid/gridmodel/_pp_bus_to_ls_bus.py
-lightsim2grid/gridmodel/from_pypowsybl.py
-lightsim2grid/gridmodel/initGridModel.py
+lightsim2grid/gridmodel/from_pandapower/__init__.py
+lightsim2grid/gridmodel/from_pandapower/_aux_add_dc_line.py
+lightsim2grid/gridmodel/from_pandapower/_aux_add_gen.py
+lightsim2grid/gridmodel/from_pandapower/_aux_add_line.py
+lightsim2grid/gridmodel/from_pandapower/_aux_add_load.py
+lightsim2grid/gridmodel/from_pandapower/_aux_add_sgen.py
+lightsim2grid/gridmodel/from_pandapower/_aux_add_shunt.py
+lightsim2grid/gridmodel/from_pandapower/_aux_add_slack.py
+lightsim2grid/gridmodel/from_pandapower/_aux_add_storage.py
+lightsim2grid/gridmodel/from_pandapower/_aux_add_trafo.py
+lightsim2grid/gridmodel/from_pandapower/_aux_check_legit.py
+lightsim2grid/gridmodel/from_pandapower/_pp_bus_to_ls_bus.py
+lightsim2grid/gridmodel/from_pandapower/initGridModel.py
+lightsim2grid/gridmodel/from_pypowsybl/__init__.py
+lightsim2grid/gridmodel/from_pypowsybl/_from_pypowsybl.py
 lightsim2grid/newtonpf/__init__.py
 lightsim2grid/newtonpf/newtonpf.py
+lightsim2grid/rewards/__init__.py
+lightsim2grid/rewards/n1ContingencyReward.py
 lightsim2grid/solver/__init__.py
 src/BaseConstants.cpp
 src/BaseConstants.h

{LightSim2Grid-0.8.1.dev0 → lightsim2grid-0.9.0}/LightSim2Grid.egg-info/requires.txt

@@ -1,5 +1,8 @@
-pandapower>=2.8
-pytest
+setuptools
+pip
+pybind11
+scipy
+numpy
 
 [benchmark]
 tabulate
@@ -25,6 +28,6 @@ numba
 [test]
 grid2op>=1.6.4
 numba
-pandapower>=2.8.0
+pandapower>=2.14.0
 packaging
 pypowsybl

{LightSim2Grid-0.8.1.dev0/LightSim2Grid.egg-info → lightsim2grid-0.9.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: LightSim2Grid
-Version: 0.8.1.dev0
+Version: 0.9.0
 Summary: LightSim2Grid implements a c++ backend targeting the Grid2Op platform.
 Home-page: https://github.com/BDonnot/lightsim2grid/
 Author: Benjamin Donnot
@@ -27,8 +27,11 @@ Description-Content-Type: text/markdown
 License-File: LICENSE
 License-File: LICENSE.md
 License-File: AUTHORS.txt
-Requires-Dist: pandapower>=2.8
-Requires-Dist: pytest
+Requires-Dist: setuptools
+Requires-Dist: pip
+Requires-Dist: pybind11
+Requires-Dist: scipy
+Requires-Dist: numpy
 Provides-Extra: docs
 Requires-Dist: numpydoc>=0.9.2; extra == "docs"
 Requires-Dist: sphinx<7,>=2.4.4; extra == "docs"
@@ -50,7 +53,7 @@ Requires-Dist: numba; extra == "recommended"
 Provides-Extra: test
 Requires-Dist: grid2op>=1.6.4; extra == "test"
 Requires-Dist: numba; extra == "test"
-Requires-Dist: pandapower>=2.8.0; extra == "test"
+Requires-Dist: pandapower>=2.14.0; extra == "test"
 Requires-Dist: packaging; extra == "test"
 Requires-Dist: pypowsybl; extra == "test"
 
@@ -122,7 +125,7 @@ from lightsim2grid.newtonpf import newtonpf
 V, converged, iterations, J = newtonpf(Ybus, V, Sbus, ref, weights, pv, pq, ppci, options)
 ```
 
-This function uses the KLU algorithm and a c++ implementation of a Newton solver for speed.
+This function uses the KLU algorithm (when available) and a c++ implementation of a Newton solver for speed.
 
 ## Installation (from pypi official repository, recommended)
 
@@ -130,12 +133,13 @@ Since version 0.5.3, lightsim2grid is can be installed like most python packages
 `python -m pip install lightsim2grid`
 
 It includes faster grid2op backend and the `SuiteSparse` faster `KLU` solver, even on windows. This is definitely the 
-easiest method to install lightsim2grid on your system and have it running without too much issues.
+easiest method to install lightsim2grid on your system and have it running.
 
 Note though that these packages have been compiled on a different platform that the one you are using. You might still
-get some benefit (in terms of performances) to install it from your on your machine.
+get some benefit (in terms of performances) to install it from your on your machine with the proper compilations flags (
+see section [6.1 Customization of the compilation](#Customization-of-the-compilation) for more information)
 
-Pypi packages are available for linux, windows and macos with python versions: 
+Pypi packages are available for linux (`x86_64` cpu architecture), windows (`x86_64` cpu architecture) and macos (`x86_64` cpu architecture) with python versions: 
 
 - 3.7
 - 3.8
@@ -144,8 +148,17 @@ Pypi packages are available for linux, windows and macos with python versions:
 - 3.11 (lightsim2grid >= 0.7.1)
 - 3.12 (lightsim2grid >= 0.7.5)
 
+
+As from version 0.8.2, we also distribute windows `arm64` and macos `arm64` binaries of lightsim2grid that can be installed
+directly with pip too (requires python >= 3.8 for macos and python >= 3.9 for windows). We do not currently produce `arm64` (`aarch64`) linux binaries because it takes too long to build. If you really want them, let us know and we'll see what we can do.
+
+
 **NB** on some version of MacOs (thanks Apple !), especially the one using M1 or M2 chip, lightsim2grid is only available
-on pypi starting from version 0.7.3
+on pypi starting from version 0.7.3 We attempted to deliver arm64 lightsim2grid version but we could not test them. So if you 
+want a reliable working and tested version of lightsim2grid on newest version of macos (with M1 or M2 chips for example) please
+use lightsim2grid >= 0.8.2
+
+**NB** we do not currently build any 32 bits lightsim2grid libraries.
 
 ## Installation (from source, for more advanced user)
 
@@ -278,7 +291,7 @@ For example: `export PATH_NICSLU=/home/user/Documents/cktso`
 
 #### Enable 03 optimization
 By default, at least on ubuntu, only the "-O2" compiler flags is used. To use the O3 optimization flag, you need
-to specify the `__COMPLILE_O3` environment variable: `set __COMPLILE_O3=1` before the compilation (so before
+to specify the `__O3_OPTIM` environment variable: `set __O3_OPTIM=1` (or `$Env:__O3_OPTIM=1` in powershell) before the compilation (so before
 `python3 setup.py build` or `python -m pip install -e .`)
 
 This compilation argument will increase the compilation time, but will make the package faster.

{LightSim2Grid-0.8.1.dev0 → lightsim2grid-0.9.0}/README.md

@@ -66,7 +66,7 @@ from lightsim2grid.newtonpf import newtonpf
 V, converged, iterations, J = newtonpf(Ybus, V, Sbus, ref, weights, pv, pq, ppci, options)
 ```
 
-This function uses the KLU algorithm and a c++ implementation of a Newton solver for speed.
+This function uses the KLU algorithm (when available) and a c++ implementation of a Newton solver for speed.
 
 ## Installation (from pypi official repository, recommended)
 
@@ -74,12 +74,13 @@ Since version 0.5.3, lightsim2grid is can be installed like most python packages
 `python -m pip install lightsim2grid`
 
 It includes faster grid2op backend and the `SuiteSparse` faster `KLU` solver, even on windows. This is definitely the 
-easiest method to install lightsim2grid on your system and have it running without too much issues.
+easiest method to install lightsim2grid on your system and have it running.
 
 Note though that these packages have been compiled on a different platform that the one you are using. You might still
-get some benefit (in terms of performances) to install it from your on your machine.
+get some benefit (in terms of performances) to install it from your on your machine with the proper compilations flags (
+see section [6.1 Customization of the compilation](#Customization-of-the-compilation) for more information)
 
-Pypi packages are available for linux, windows and macos with python versions: 
+Pypi packages are available for linux (`x86_64` cpu architecture), windows (`x86_64` cpu architecture) and macos (`x86_64` cpu architecture) with python versions: 
 
 - 3.7
 - 3.8
@@ -88,8 +89,17 @@ Pypi packages are available for linux, windows and macos with python versions:
 - 3.11 (lightsim2grid >= 0.7.1)
 - 3.12 (lightsim2grid >= 0.7.5)
 
+
+As from version 0.8.2, we also distribute windows `arm64` and macos `arm64` binaries of lightsim2grid that can be installed
+directly with pip too (requires python >= 3.8 for macos and python >= 3.9 for windows). We do not currently produce `arm64` (`aarch64`) linux binaries because it takes too long to build. If you really want them, let us know and we'll see what we can do.
+
+
 **NB** on some version of MacOs (thanks Apple !), especially the one using M1 or M2 chip, lightsim2grid is only available
-on pypi starting from version 0.7.3
+on pypi starting from version 0.7.3 We attempted to deliver arm64 lightsim2grid version but we could not test them. So if you 
+want a reliable working and tested version of lightsim2grid on newest version of macos (with M1 or M2 chips for example) please
+use lightsim2grid >= 0.8.2
+
+**NB** we do not currently build any 32 bits lightsim2grid libraries.
 
 ## Installation (from source, for more advanced user)
 
@@ -222,7 +232,7 @@ For example: `export PATH_NICSLU=/home/user/Documents/cktso`
 
 #### Enable 03 optimization
 By default, at least on ubuntu, only the "-O2" compiler flags is used. To use the O3 optimization flag, you need
-to specify the `__COMPLILE_O3` environment variable: `set __COMPLILE_O3=1` before the compilation (so before
+to specify the `__O3_OPTIM` environment variable: `set __O3_OPTIM=1` (or `$Env:__O3_OPTIM=1` in powershell) before the compilation (so before
 `python3 setup.py build` or `python -m pip install -e .`)
 
 This compilation argument will increase the compilation time, but will make the package faster.

{LightSim2Grid-0.8.1.dev0 → lightsim2grid-0.9.0}/lightsim2grid/__init__.py

@@ -1,13 +1,14 @@
-# Copyright (c) 2020, RTE (https://www.rte-france.com)
+# Copyright (c) 2020-2024, RTE (https://www.rte-france.com)
 # See AUTHORS.txt
 # This Source Code Form is subject to the terms of the Mozilla Public License, version 2.0.
 # If a copy of the Mozilla Public License, version 2.0 was not distributed with this file,
 # you can obtain one at http://mozilla.org/MPL/2.0/.
 # SPDX-License-Identifier: MPL-2.0
 # This file is part of LightSim2grid, LightSim2grid implements a c++ backend targeting the Grid2Op platform.
-__version__ = "0.8.1.dev0"
 
-__all__ = ["newtonpf", "SolverType", "ErrorType", "solver"]
+__version__ = "0.9.0"
+
+__all__ = ["newtonpf", "SolverType", "ErrorType", "solver", "compilation_options"]
 
 # import directly from c++ module
 from lightsim2grid.solver import SolverType
@@ -19,7 +20,6 @@ try:
 except ImportError as exc_:
     # grid2op is not installed, the Backend will not be available
     pass
-    print(f"LightSimBackend import error: {exc_}")
 
 try:
     from lightsim2grid.physical_law_checker import PhysicalLawChecker
@@ -27,7 +27,6 @@ try:
 except ImportError as exc_:
     # grid2op is not installed, the PhysicalLawChecker will not be available
     pass
-    print(f"PhysicalLawChecker import error: {exc_}")
 
 try:
     from lightsim2grid.timeSerie import TimeSerie
@@ -36,7 +35,6 @@ try:
 except ImportError as exc_:
     # grid2op is not installed, the TimeSeries module will not be available
     pass
-    print(f"TimeSerie import error: {exc_}")
 
 try:
     from lightsim2grid.contingencyAnalysis import ContingencyAnalysis
@@ -45,4 +43,10 @@ try:
 except ImportError as exc_:
     # grid2op is not installed, the SecurtiyAnalysis module will not be available
     pass
-    print(f"ContingencyAnalysis import error: {exc_}")
+    
+try:
+    from lightsim2grid.rewards import *
+    __all__.append("rewards")
+except ImportError as exc_:
+    # grid2op is not installed, the SecurtiyAnalysis module will not be available
+    pass

lightsim2grid-0.9.0/lightsim2grid/_utils/__init__.py

@@ -0,0 +1,136 @@
+# this class is defined to avoid circular references when using grid2op -> pandapower -> lightsim2grid -> grid2op
+# this module is lazily imported by the LightSimBackend and should not be used anywhere else, 
+# as the name states
+
+import warnings
+
+try:
+    import grid2op
+    from grid2op.Backend import PandaPowerBackend
+    class _DoNotUseAnywherePandaPowerBackend(PandaPowerBackend):
+        """used to duplicate the class attributes of PandaPowerBackend"""
+        shunts_data_available = True
+        
+    if not hasattr(PandaPowerBackend, "_clear_grid_dependant_class_attributes"):
+        # not available in python 3.7
+        warnings.warn("This is a compatibility mode, please avoid using it and migrate to python >=3.10 ideally.")
+        def f(cls):
+            cls._INIT_GRID_CLS = None  # do not modify that, this is handled by grid2op automatically
+            cls._PATH_GRID_CLASSES = None  # especially do not modify that
+            
+            cls.glop_version = grid2op.__version__
+
+            cls.SUB_COL = 0
+            cls.LOA_COL = 1
+            cls.GEN_COL = 2
+            cls.LOR_COL = 3
+            cls.LEX_COL = 4
+            cls.STORAGE_COL = 5
+
+            cls.attr_list_vect = None
+            cls.attr_list_set = {}
+            cls.attr_list_json = []
+            cls.attr_nan_list_set = set()
+
+            # class been init
+            cls._IS_INIT = False
+
+            # name of the objects
+            cls.env_name = "unknown"
+            cls.name_load = None
+            cls.name_gen = None
+            cls.name_line = None
+            cls.name_sub = None
+            cls.name_storage = None
+
+            cls.n_gen = -1
+            cls.n_load = -1
+            cls.n_line = -1
+            cls.n_sub = -1
+            cls.n_storage = -1
+
+            cls.sub_info = None
+            cls.dim_topo = -1
+
+            # to which substation is connected each element
+            cls.load_to_subid = None
+            cls.gen_to_subid = None
+            cls.line_or_to_subid = None
+            cls.line_ex_to_subid = None
+            cls.storage_to_subid = None
+
+            # which index has this element in the substation vector
+            cls.load_to_sub_pos = None
+            cls.gen_to_sub_pos = None
+            cls.line_or_to_sub_pos = None
+            cls.line_ex_to_sub_pos = None
+            cls.storage_to_sub_pos = None
+
+            # which index has this element in the topology vector
+            cls.load_pos_topo_vect = None
+            cls.gen_pos_topo_vect = None
+            cls.line_or_pos_topo_vect = None
+            cls.line_ex_pos_topo_vect = None
+            cls.storage_pos_topo_vect = None
+
+            # "convenient" way to retrieve information of the grid
+            cls.grid_objects_types = None
+            # to which substation each element of the topovect is connected
+            cls._topo_vect_to_sub = None
+
+            # list of attribute to convert it from/to a vector
+            cls._vectorized = None
+
+            # redispatch data, not available in all environment
+            cls.redispatching_unit_commitment_availble = False
+            cls.gen_type = None
+            cls.gen_pmin = None
+            cls.gen_pmax = None
+            cls.gen_redispatchable = None
+            cls.gen_max_ramp_up = None
+            cls.gen_max_ramp_down = None
+            cls.gen_min_uptime = None
+            cls.gen_min_downtime = None
+            cls.gen_cost_per_MW = None  # marginal cost (in currency / (power.step) and not in $/(MW.h) it would be $ / (MW.5mins) )
+            cls.gen_startup_cost = None  # start cost (in currency)
+            cls.gen_shutdown_cost = None  # shutdown cost (in currency)
+            cls.gen_renewable = None
+
+            # storage unit static data
+            cls.storage_type = None
+            cls.storage_Emax = None
+            cls.storage_Emin = None
+            cls.storage_max_p_prod = None
+            cls.storage_max_p_absorb = None
+            cls.storage_marginal_cost = None
+            cls.storage_loss = None
+            cls.storage_charging_efficiency = None
+            cls.storage_discharging_efficiency = None
+
+            # grid layout
+            cls.grid_layout = None
+
+            # shunt data, not available in every backend
+            cls.n_shunt = None
+            cls.name_shunt = None
+            cls.shunt_to_subid = None
+
+            # alarm / alert
+            cls.assistant_warning_type = None
+            
+            # alarms
+            cls.dim_alarms = 0
+            cls.alarms_area_names = []
+            cls.alarms_lines_area = {}
+            cls.alarms_area_lines = []
+
+            # alerts
+            cls.dim_alerts = 0
+            cls.alertable_line_names = []
+            cls.alertable_line_ids = []
+        setattr(_DoNotUseAnywherePandaPowerBackend, "_clear_grid_dependant_class_attributes", classmethod(f))
+            
+        
+except ImportError as exc_:
+    # grid2op is not installed, we do not use it.
+    pass

lightsim2grid-0.9.0/lightsim2grid/compilation_options/__init__.py

@@ -0,0 +1,37 @@
+# Copyright (c) 2024, RTE (https://www.rte-france.com)
+# See AUTHORS.txt
+# This Source Code Form is subject to the terms of the Mozilla Public License, version 2.0.
+# If a copy of the Mozilla Public License, version 2.0 was not distributed with this file,
+# you can obtain one at http://mozilla.org/MPL/2.0/.
+# SPDX-License-Identifier: MPL-2.0
+# This file is part of LightSim2grid, LightSim2grid implements a c++ backend targeting the Grid2Op platform.
+
+__all__ = ["klu_solver_available",
+           "nicslu_solver_available",
+           "cktso_solver_available",
+           "compiled_march_native",
+           "compiled_o3_optim",
+           "version",
+           "lightsim2grid_lib"]
+
+from lightsim2grid_cpp import klu_solver_available
+from lightsim2grid_cpp import nicslu_solver_available
+from lightsim2grid_cpp import cktso_solver_available
+from lightsim2grid_cpp import compiled_march_native
+from lightsim2grid_cpp import compiled_o3_optim
+from lightsim2grid_cpp import version
+from lightsim2grid_cpp import __file__ as lightsim2grid_lib
+
+try:
+    from lightsim2grid_cpp import nicslu_lib
+    __all__.append("nicslu_lib")
+except ImportError :
+    # NICSLU linear solver is not available
+    pass
+
+try:
+    from lightsim2grid_cpp import cktso_lib
+    __all__.append("cktso_lib")
+except ImportError :
+    # CKTSO linear solver is not available
+    pass