+"""Python implementation of the gRPC API Eigen Example client."""
+
+import grpc
+import numpy as np
+
+import ansys.eigen.python.grpc.constants as constants
+import ansys.eigen.python.grpc.generated.grpcdemo_pb2 as grpcdemo_pb2
+import ansys.eigen.python.grpc.generated.grpcdemo_pb2_grpc as grpcdemo_pb2_grpc
+
+
+
+[docs]
+class DemoGRPCClient:
+ """Provides the API Eigen Example client class for interacting via gRPC."""
+
+ def __init__(self, ip="127.0.0.1", port=50051, timeout=1, test=None):
+ """Initialize connection to the API Eigen server.
+
+ Parameters
+ ----------
+ ip : str, optional
+ IP or DNS to which to connect. The default is "127.0.0.1".
+ port : int, optional
+ Port to connect to. The default is 50051.
+ timeout : int, optional
+ Number of seconds to wait before returning a timeout in the connection. The default is 1.
+ test : object, optional
+ Test GRPCDemoStub to connect to. The default is ``None``. This argument is only intended for test purposes.
+
+ Raises
+ ------
+ IOError
+ Error if the client was unable to connect to the server.
+ """
+ # For test purposes, provide a stub directly
+ if test is not None:
+ self._stub = test
+ return
+
+ self._stub = None
+ self._channel_str = "%s:%d" % (ip, port)
+
+ self.channel = grpc.insecure_channel(self._channel_str)
+
+ # Verify connection
+ try:
+ grpc.channel_ready_future(self.channel).result(timeout=timeout)
+ except grpc.FutureTimeoutError:
+ raise IOError("Unable to connect to server at %s" % self._channel_str)
+
+ # Set up the stub
+ self._stub = grpcdemo_pb2_grpc.GRPCDemoStub(self.channel)
+
+ print("Connected to server at %s:%d" % (ip, port))
+
+ # =================================================================================================
+ # PUBLIC METHODS for Client operations
+ # =================================================================================================
+
+
+[docs]
+ def request_greeting(self, name):
+ """Method that requests a greeting from the server.
+
+ Parameters
+ ----------
+ name : str
+ Name of the "client". For example, "Michael".
+ """
+ # Build the greeting request
+ request = grpcdemo_pb2.HelloRequest(name=name)
+
+ # Send the request
+ response = self._stub.SayHello(request)
+
+ # Show the server's response
+ print("The server answered: " + response.message)
+
+
+
+[docs]
+ def flip_vector(self, vector):
+ """Flip the position of a numpy.ndarray vector such that [A, B, C, D] --> [D, C, B, A].
+
+ Parameters
+ ----------
+ vector : numpy.ndarray
+ Vector to flip.
+
+ Returns
+ -------
+ numpy.ndarray
+ Flipped vector.
+ """
+ # Generate the metadata and the amount of chunks per vector
+ md, chunks = self._generate_md("vectors", "vec", vector)
+
+ # Build the stream (i.e. generator)
+ vector_gen = self._generate_vector_stream(chunks, vector)
+
+ # Call the server method and retrieve the result
+ response_iterator = self._stub.FlipVector(vector_gen, metadata=md)
+
+ # Now, convert to a numpy.ndarray to continue nominal operations (outside the client)
+ nparray = self._read_nparray_from_vector(response_iterator)
+
+ # Return only the first element (expecting a single vector)
+ return nparray[0]
+
+
+
+[docs]
+ def add_vectors(self, *args):
+ """Add numpy.ndarray vectors using the Eigen library on the server side.
+
+ Returns
+ -------
+ numpy.ndarray
+ Result of the given numpy.ndarrays.
+ """
+ # Generate the metadata and the amount of chunks per vector
+ md, chunks = self._generate_md("vectors", "vec", *args)
+
+ # Build the stream (i.e. generator)
+ vector_iterator = self._generate_vector_stream(chunks, *args)
+
+ # Call the server method and retrieve the result
+ response_iterator = self._stub.AddVectors(vector_iterator, metadata=md)
+
+ # Now, convert to a numpy.ndarray to continue nominal operations (outside the client)
+ nparray = self._read_nparray_from_vector(response_iterator)
+
+ # Return only the first element (expecting a single vector)
+ return nparray[0]
+
+
+
+[docs]
+ def multiply_vectors(self, *args):
+ """Multiply numpy.ndarray vectors using the Eigen library on the server side.
+
+ Returns
+ -------
+ numpy.ndarray
+ Result of the multiplication of numpy.ndarray vectors. Despite returning a numpy.ndarray, the result only contains one value because it is a dot product.
+ """
+ # Generate the metadata and the amount of chunks per vector
+ md, chunks = self._generate_md("vectors", "vec", *args)
+
+ # Build the stream (generator)
+ vector_iterator = self._generate_vector_stream(chunks, *args)
+
+ # Call the server method and retrieve the result
+ response_iterator = self._stub.MultiplyVectors(vector_iterator, metadata=md)
+
+ # Convert to a numpy.ndarray to continue nominal operations (outside the client)
+ nparray = self._read_nparray_from_vector(response_iterator)
+
+ # Return only the first element (expecting a single vector)
+ return nparray[0]
+
+
+
+[docs]
+ def add_matrices(self, *args):
+ """Add numpy.ndarray matrices using the Eigen library on the server side.
+
+ Returns
+ -------
+ numpy.ndarray
+ Resulting numpy.ndarray of the matrices addition.
+ """
+ # Generate the metadata and the amount of chunks per Matrix
+ md, chunks = self._generate_md("matrices", "mat", *args)
+
+ # Build the stream (i.e. generator)
+ matrix_iterator = self._generate_matrix_stream(chunks, *args)
+
+ # Call the server method and retrieve the result
+ response_iterator = self._stub.AddMatrices(matrix_iterator, metadata=md)
+
+ # Now, convert to a numpy.ndarray to continue nominal operations (outside the client)
+ nparray = self._read_nparray_from_matrix(response_iterator)
+
+ # Return only the first element (expecting a single matrix)
+ return nparray[0]
+
+
+
+[docs]
+ def multiply_matrices(self, *args):
+ """Multiply numpy.ndarray matrices using the Eigen library on the server side.
+
+ Returns
+ -------
+ numpy.ndarray
+ Resulting numpy.ndarray of the matrices' multiplication.
+ """
+ # Generate the metadata and the amount of chunks per matrix
+ md, chunks = self._generate_md("matrices", "mat", *args)
+
+ # Build the stream (i.e. generator)
+ matrix_iterator = self._generate_matrix_stream(chunks, *args)
+
+ # Call the server method and retrieve the result
+ response_iterator = self._stub.MultiplyMatrices(matrix_iterator, metadata=md)
+
+ # Convert to a numpy.ndarray to continue nominal operations (outside the client)
+ nparray = self._read_nparray_from_matrix(response_iterator)
+
+ # Return only the first element (expecting a single matrix)
+ return nparray[0]
+
+
+ # =================================================================================================
+ # PRIVATE METHODS for Client operations
+ # =================================================================================================
+
+ def _generate_md(self, message_type: str, abbrev: str, *args: np.ndarray):
+ # Initialize the metadata and the chunks list for each full message
+ md = []
+ chunks = []
+
+ # Find how many arguments are transmitting
+ md.append(("full-" + message_type, str(len(args))))
+
+ # Loop over all input arguments
+ idx = 1
+ for arg in args:
+ # Perform some argument input sanity checks
+ if message_type == "vectors" and abbrev == "vec":
+ self._sanity_check_vector(arg)
+ elif message_type == "matrices" and abbrev == "mat":
+ self._sanity_check_matrix(arg)
+ else:
+ raise RuntimeError("Invalid usage of _generate_md function.")
+
+ # Check the size of the arrays
+ # If size is surpassed, determine chunks needed
+ if arg.nbytes > constants.MAX_CHUNKSIZE:
+ # Determine how many chunks are needed
+ #
+ # Max amount of elements per chunk
+ max_elems = constants.MAX_CHUNKSIZE // arg.itemsize
+
+ # Bulk number of chunks needed
+ bulk_chunks = arg.size // max_elems
+
+ # The remainder amount of elements (if any)
+ remainder = arg.size % max_elems
+
+ # This list provides the last index up to which to
+ # process in each partial vector or matrix message
+ last_idx_chunk = []
+ for i in range(1, bulk_chunks + 1):
+ last_idx_chunk.append(i * max_elems)
+
+ # Take into account that if there is a remainder, include
+ # one last partial vector or matrix message
+ if remainder != 0:
+ last_idx_chunk.append(arg.size)
+
+ # Append the results
+ md.append((abbrev + str(idx) + "-messages", str(len(last_idx_chunk))))
+ chunks.append(last_idx_chunk)
+
+ else:
+ # Otherwise deal with a single message... Append results.
+ md.append((abbrev + str(idx) + "-messages", str(1)))
+ chunks.append([arg.size])
+
+ # Increase idx by 1
+ idx += 1
+
+ # Return the metadata and the chunks list for each vector or matrix
+ return md, chunks
+
+ def _generate_vector_stream(self, chunks: "list[list[int]]", *args: np.ndarray):
+ # Loop over all input arguments
+ for arg, vector_chunks in zip(args, chunks):
+ # Perform some argument input sanity checks
+ self._sanity_check_vector(arg)
+
+ # If sanity checks are fine... yield the corresponding vector message
+ #
+ # Loop over the chunk indices
+ processed_idx = 0
+ for last_idx_chunk in vector_chunks:
+ # Use tmp_idx in yield function and update the processed_idx afterwards
+ tmp_idx = processed_idx
+ processed_idx = last_idx_chunk
+
+ # Yield!
+ yield grpcdemo_pb2.Vector(
+ data_type=constants.NP_DTYPE_TO_DATATYPE[arg.dtype.type],
+ vector_size=arg.shape[0],
+ vector_as_chunk=arg[tmp_idx:last_idx_chunk].tobytes(),
+ )
+
+ def _generate_matrix_stream(self, chunks: "list[list[int]]", *args: np.ndarray):
+ # Loop over all input arguments
+ for arg, matrix_chunks in zip(args, chunks):
+ # Perform some argument input sanity checks.
+ self._sanity_check_matrix(arg)
+
+ # If sanity checks are fine... yield the corresponding matrix message
+ #
+ # When dealing with matrices, ravel it to a 1D array (avoids copy)
+ arg_as_vec = arg.ravel()
+
+ # Loop over the chunk indices
+ processed_idx = 0
+ for last_idx_chunk in matrix_chunks:
+ # Use tmp_idx in yield function and update the processed_idx afterwards
+ tmp_idx = processed_idx
+ processed_idx = last_idx_chunk
+
+ # Yield
+ yield grpcdemo_pb2.Matrix(
+ data_type=constants.NP_DTYPE_TO_DATATYPE[arg.dtype.type],
+ matrix_rows=arg.shape[0],
+ matrix_cols=arg.shape[1],
+ matrix_as_chunk=arg_as_vec[tmp_idx:last_idx_chunk].tobytes(),
+ )
+
+ def _read_nparray_from_vector(self, response_iterator):
+ # Get the metadata
+ response_md = response_iterator.initial_metadata()
+
+ # Parse the server's metadata
+ full_msg, chunks_per_msg = self._parse_server_metadata(response_md)
+
+ # Initialize the output list
+ resulting_vectors = []
+
+ # Start processing messages independently
+ for msg in range(full_msg):
+ # Init the resulting numpy.ndarray to None, its size and its type
+ result = None
+ result_size = 0
+ result_dtype = None
+
+ # Loop over the available chunks per message
+ for chunk_idx in range(chunks_per_msg[msg]):
+ # Read a message
+ vector = next(response_iterator)
+
+ # If it is the first chunk being processed, parse dtype and size
+ if chunk_idx == 0:
+ if vector.data_type == grpcdemo_pb2.DataType.Value("INTEGER"):
+ result_dtype = np.int32
+ elif vector.data_type == grpcdemo_pb2.DataType.Value("DOUBLE"):
+ result_dtype = np.float64
+
+ result_size = vector.vector_size
+
+ # Parse the chunk
+ if result is None:
+ result = np.frombuffer(vector.vector_as_chunk, dtype=result_dtype)
+ else:
+ tmp = np.frombuffer(vector.vector_as_chunk, dtype=result_dtype)
+ result = np.concatenate((result, tmp))
+
+ # Check if the final vector has the desired size
+ if result.size != result_size:
+ raise RuntimeError("Problems reading server full Vector message...")
+ else:
+ # If everything is fine, append to resulting_vectors list
+ resulting_vectors.append(result)
+
+ # Return the resulting_vectors list
+ return resulting_vectors
+
+ def _read_nparray_from_matrix(self, response_iterator):
+ # Get the metadata
+ response_md = response_iterator.initial_metadata()
+
+ # Parse the server's metadata
+ full_msg, chunks_per_msg = self._parse_server_metadata(response_md)
+
+ # Initialize the output list
+ resulting_matrices = []
+
+ # Start processing messages independently
+ for msg in range(full_msg):
+ # Init the resulting numpy.ndarray to None, its size (rows,cols), and its type
+ result = None
+ result_rows = 0
+ result_cols = 0
+ result_dtype = None
+
+ # Loop over the available chunks per message
+ for chunk_idx in range(chunks_per_msg[msg]):
+ # Read a message
+ matrix = next(response_iterator)
+
+ # If it is the first chunk being processing, parse dtype and size (rows,cols)
+ if chunk_idx == 0:
+ if matrix.data_type == grpcdemo_pb2.DataType.Value("INTEGER"):
+ result_dtype = np.int32
+ elif matrix.data_type == grpcdemo_pb2.DataType.Value("DOUBLE"):
+ result_dtype = np.float64
+
+ result_rows = matrix.matrix_rows
+ result_cols = matrix.matrix_cols
+
+ # Parse the chunk
+ if result is None:
+ result = np.frombuffer(matrix.matrix_as_chunk, dtype=result_dtype)
+ else:
+ tmp = np.frombuffer(matrix.matrix_as_chunk, dtype=result_dtype)
+ result = np.concatenate((result, tmp))
+
+ # Check if the final matrix has the desired size
+ if result.size != result_rows * result_cols:
+ raise RuntimeError("Problems reading server full matrix message...")
+ else:
+ # If everything is fine, append to resulting_matrices list
+ resulting_matrices.append(
+ np.reshape(
+ result,
+ (
+ result_rows,
+ result_cols,
+ ),
+ )
+ )
+
+ # Return the resulting_matrices list
+ return resulting_matrices
+
+ def _sanity_check_vector(self, arg):
+ # Perform some argument input sanity checks.
+ if type(arg) is not np.ndarray:
+ raise RuntimeError("Invalid argument. Only numpy.ndarrays are allowed.")
+ elif arg.dtype.type not in constants.NP_DTYPE_TO_DATATYPE.keys():
+ raise RuntimeError(
+ "Invalid argument. Only numpy.ndarrays of type int32 and float64 are allowed."
+ )
+ elif arg.ndim != 1:
+ raise RuntimeError("Invalid argument. Only 1D numpy.ndarrays are allowed.")
+
+ def _sanity_check_matrix(self, arg):
+ # Perform some argument input sanity checks.
+ if type(arg) is not np.ndarray:
+ raise RuntimeError("Invalid argument. Only numpy.ndarrays are allowed.")
+ elif arg.dtype.type not in constants.NP_DTYPE_TO_DATATYPE.keys():
+ raise RuntimeError(
+ "Invalid argument. Only numpy.ndarrays of type int32 and float64 are allowed."
+ )
+ elif arg.ndim != 2:
+ raise RuntimeError("Invalid argument. Only 2D numpy.ndarrays are allowed.")
+
+ def _parse_server_metadata(self, response_md: "list[tuple]"):
+ # Init the return variables: amount of full messages received
+ # and partial messages per full message
+ full_msg = 0
+ chunks_per_msg = []
+
+ # Find out how many full messages are to be processed
+ for md in response_md:
+ if md[0] == "full-vectors" or md[0] == "full-matrices":
+ full_msg = int(md[1])
+
+ # Identify the chunks per message (only if successful previously)
+ if full_msg != 0:
+ for i in range(1, full_msg + 1):
+ for md in response_md:
+ if md[0] == "vec%d-messages" % i or md[0] == "mat%d-messages" % i:
+ chunks_per_msg.append(int(md[1]))
+
+ return full_msg, chunks_per_msg
+
+
+"""Python implementation of the gRPC API Eigen example server."""
+
+from concurrent import futures
+import logging
+
+import click
+import demo_eigen_wrapper
+import grpc
+import numpy as np
+
+import ansys.eigen.python.grpc.constants as constants
+import ansys.eigen.python.grpc.generated.grpcdemo_pb2 as grpcdemo_pb2
+import ansys.eigen.python.grpc.generated.grpcdemo_pb2_grpc as grpcdemo_pb2_grpc
+
+# =================================================================================================
+# AUXILIARY METHODS for Server operations
+# =================================================================================================
+
+
+
+[docs]
+def check_data_type(dtype, new_dtype):
+ """Check if the new data type is the same as the previous data type.
+
+ Parameters
+ ----------
+ dtype : numpy.type
+ Type of the numpy array before processing.
+ new_dtype : numpy.type
+ Type of the numpy array to be processed.
+
+ Returns
+ -------
+ numpy.type
+ Type of the numpy array.
+
+ Raises
+ ------
+ RuntimeError
+ In case there is already a type and it does not match that of the new_type argument.
+ """
+ if dtype is None:
+ return new_dtype
+ elif dtype != new_dtype:
+ raise RuntimeError(
+ "Error while processing data types... Input arguments are of different nature (such as int32, float64)."
+ )
+ else:
+ return dtype
+
+
+
+
+[docs]
+def check_size(size, new_size):
+ """Check if the new parsed size is the same as the previous size.
+
+ Parameters
+ ----------
+ size : tuple
+ Size of the numpy array before processing.
+ new_size : _type_
+ Size of the numpy array to process.
+
+ Returns
+ -------
+ tuple
+ Size of the numpy array.
+
+ Raises
+ ------
+ RuntimeError
+ In case there is already a size and it does not match that of the new_size argument.
+ """
+ if size is None:
+ return new_size
+ elif size != new_size:
+ raise RuntimeError(
+ "Error while processing data types... Input arguments are of different sizes."
+ )
+ else:
+ return size
+
+
+
+
+[docs]
+class GRPCDemoServicer(grpcdemo_pb2_grpc.GRPCDemoServicer):
+ """Provides methods that implement functionality of the API Eigen Example server."""
+
+ def __init__(self) -> None:
+ """No special init is required for the server... unless data is to be stored in a DB. This is to be determined."""
+ # TODO : is it required to store the input vectors in a DB?
+ super().__init__()
+
+ # =================================================================================================
+ # PUBLIC METHODS for Server operations
+ # =================================================================================================
+
+
+[docs]
+ def SayHello(self, request, context):
+ """Test the greeter method to see if the server is up and running correctly.
+
+ Parameters
+ ----------
+ request : HelloRequest
+ Greeting request sent by the client.
+ context : grpc.ServicerContext
+ gRPC-specific information.
+
+ Returns
+ -------
+ grpcdemo_pb2.HelloReply
+ Reply to greeting by the server.
+ """
+ click.echo("Greeting requested! Requested by: " + request.name)
+
+ # Inform about the size of the message content
+ click.echo("Size of message: " + constants.human_size(request))
+
+ return grpcdemo_pb2.HelloReply(message="Hello, %s!" % request.name)
+
+
+
+[docs]
+ def FlipVector(self, request_iterator, context):
+ """Flip a given vector.
+
+ Parameters
+ ----------
+ request_iterator : iterator
+ Iterator to the stream of vector messages provided.
+ context : grpc.ServicerContext
+ gRPC-specific information.
+
+ Returns
+ -------
+ grpcdemo_pb2.Vector
+ Flipped vector message.
+ """
+ click.echo("Vector flip requested.")
+
+ # Process the metadata
+ md = self._read_client_metadata(context)
+
+ # Process the input messages
+ dtype, size, vector_list = self._get_vectors(request_iterator, md)
+
+ # Flip it --> assuming that only one vector is passed
+ nparray_flipped = np.flip(vector_list[0])
+
+ # Send the response
+ return self._send_vectors(context, nparray_flipped)
+
+
+
+[docs]
+ def AddVectors(self, request_iterator, context):
+ """Add vectors.
+
+ Parameters
+ ----------
+ request_iterator : iterator
+ Iterator to the stream of vector messages provided.
+ context : grpc.ServicerContext
+ gRPC-specific information.
+
+ Returns
+ -------
+ grpcdemo_pb2.Vector
+ Vector message.
+ """
+ click.echo("Vector addition requested.")
+ # Process the metadata
+ md = self._read_client_metadata(context)
+
+ # Process the input messages
+ dtype, size, vector_list = self._get_vectors(request_iterator, md)
+
+ # Create an empty array with the input arguments characteristics (dtype, size)
+ result = np.zeros(size, dtype=dtype)
+
+ # Add all provided vectors using the Eigen library
+ for vector in vector_list:
+ # Casting is needed due to interface with Eigen library... Not the desired approach,
+ # but works. Ideally, vectors should be passed directly, but errors appear
+ cast_vector = np.array(vector, dtype=dtype)
+ result = demo_eigen_wrapper.add_vectors(result, cast_vector)
+
+ # Send the response
+ return self._send_vectors(context, result)
+
+
+
+[docs]
+ def MultiplyVectors(self, request_iterator, context):
+ """Multiply two vectors.
+
+ Parameters
+ ----------
+ request_iterator : iterator
+ Iterator to the stream of vector messages provided.
+ context : grpc.ServicerContext
+ gRPC-specific information.
+
+ Returns
+ -------
+ grpcdemo_pb2.Vector
+ Vector message.
+ """
+ click.echo("Vector dot product requested")
+
+ # Process the metadata
+ md = self._read_client_metadata(context)
+
+ # Process the input messages
+ dtype, size, vector_list = self._get_vectors(request_iterator, md)
+
+ # Check that the vctor list contains a maximum of two vectors
+ if len(vector_list) != 2:
+ raise RuntimeError(
+ "Unexpected number of vectors to be multiplied: "
+ + len(vector_list)
+ + ". Only 2 is valid."
+ )
+
+ # Perform the dot product of the provided vectors using the Eigen library
+ # casting is needed due to interface with Eigen library... Not the desired approach,
+ # but works. Ideally, vectors should be passed directly, but errors appear
+ vec_1 = np.array(vector_list[0], dtype=dtype)
+ vec_2 = np.array(vector_list[1], dtype=dtype)
+ result = demo_eigen_wrapper.multiply_vectors(vec_1, vec_2)
+
+ # Return the result as a numpy.ndarray
+ result = np.array(result, dtype=dtype, ndmin=1)
+
+ # Finally, send the response
+ return self._send_vectors(context, result)
+
+
+
+[docs]
+ def AddMatrices(self, request_iterator, context):
+ """Add matrices.
+
+ Parameters
+ ----------
+ request_iterator : iterator
+ Iterator to the stream of matrix messages provided.
+ context : grpc.ServicerContext
+ gRPC-specific information.
+
+ Returns
+ -------
+ grpcdemo_pb2.Matrix
+ Matrix message.
+ """
+ click.echo("Matrix addition requested!")
+ # Process the metadata
+ md = self._read_client_metadata(context)
+
+ # Process the input messages
+ dtype, size, matrix_list = self._get_matrices(request_iterator, md)
+
+ # Create an empty array with the input arguments characteristics (dtype, size)
+ result = np.zeros(size, dtype=dtype)
+
+ # Add all provided matrices using the Eigen library
+ for matrix in matrix_list:
+ # Casting is needed due to interface with Eigen library... Not the desired approach,
+ # but works. Ideally, we would want to pass matrix directly, but errors appear
+ cast_matrix = np.array(matrix, dtype=dtype)
+ result = demo_eigen_wrapper.add_matrices(result, cast_matrix)
+
+ # Send the response
+ return self._send_matrices(context, result)
+
+
+
+[docs]
+ def MultiplyMatrices(self, request_iterator, context):
+ """Multiply two matrices.
+
+ Parameters
+ ----------
+ request_iterator : iterator
+ Iterator to the stream of Matrix messages provided.
+ context : grpc.ServicerContext
+ gRPC-specific information.
+
+ Returns
+ -------
+ grpcdemo_pb2.Matrix
+ Matrix message.
+ """
+ click.echo("Matrix multiplication requested.")
+
+ # Process the metadata
+ md = self._read_client_metadata(context)
+
+ # Process the input messages
+ dtype, size, matrix_list = self._get_matrices(request_iterator, md)
+
+ # Check that the matrix list contains a maximum of two matrices
+ if len(matrix_list) != 2:
+ raise RuntimeError(
+ "Unexpected number of matrices to be multiplied: "
+ + len(matrix_list)
+ + ". You can only multiple two matrices."
+ )
+
+ # Due to the previous _get_matrices method, the size of all
+ # matrices is the same... check that it is a square matrix. Otherwise, no multiplication
+ # is possible
+ if size[0] != size[1]:
+ raise RuntimeError("Only square matrices are allowed for multiplication.")
+
+ # Perform the matrix multiplication of the provided matrices using the Eigen library
+ # Casting is needed due to interface with Eigen library... Not the desired approach,
+ # but works. Ideally, vector should be passed directly, but errors appear
+ mat_1 = np.array(matrix_list[0], dtype=dtype)
+ mat_2 = np.array(matrix_list[1], dtype=dtype)
+ result = demo_eigen_wrapper.multiply_matrices(mat_1, mat_2)
+
+ # Finally, send the response
+ return self._send_matrices(context, result)
+
+
+ # =================================================================================================
+ # PRIVATE METHODS for Server operations
+ # =================================================================================================
+
+ def _get_vectors(self, request_iterator, md: dict):
+ """Process a stream of vector messages.
+
+ Parameters
+ ----------
+ request_iterator : iterator
+ Iterator to the received request messages of type Vector.
+ md : dict
+ Metadata provided by the client.
+
+ Returns
+ -------
+ np.type, tuple, list of np.array
+ Type of data, size of the vectors, and list of vectors to process.
+ """
+ # First, determine how many full vector messages are to be processed
+ full_msgs = int(md.get("full-vectors"))
+
+ # Initialize the output vector list and some aux vars
+ vector_list = []
+ dtype = None
+ size = None
+
+ # Loop over the expected full messages
+ for msg in range(1, full_msgs + 1):
+
+ # Find out how many partial vector messages constitute this full vector message
+ chunks = int(md.get("vec%d-messages" % msg))
+
+ # Initialize the output vector
+ vector = None
+
+ # Loop over the expected chunks
+ for chunk_msg in range(chunks):
+ # Read the vector message
+ chunk_vec = next(request_iterator)
+
+ # Inform about the size of the message content
+ click.echo(
+ "Size of message: "
+ + constants.human_size(chunk_vec.vector_as_chunk)
+ )
+
+ # If processing the first chunk of the message, fill in some data
+ if chunk_msg == 0:
+ # Check the data type of the incoming vector
+ if chunk_vec.data_type == grpcdemo_pb2.DataType.Value("INTEGER"):
+ dtype = check_data_type(dtype, np.int32)
+ elif chunk_vec.data_type == grpcdemo_pb2.DataType.Value("DOUBLE"):
+ dtype = check_data_type(dtype, np.float64)
+
+ # Check the size of the incoming vector
+ size = check_size(size, (chunk_vec.vector_size,))
+
+ # Parse the chunk
+ if vector is None:
+ vector = np.frombuffer(chunk_vec.vector_as_chunk, dtype=dtype)
+ else:
+ tmp = np.frombuffer(chunk_vec.vector_as_chunk, dtype=dtype)
+ vector = np.concatenate((vector, tmp))
+
+ # Check if the final vector has the desired size
+ if vector.size != size[0]:
+ raise RuntimeError("Problems reading client full vector message...")
+ else:
+ # If everything is fine, append to vector_list
+ vector_list.append(vector)
+
+ # Return the input vector list (as a list of numpy.ndarray)
+ return dtype, size, vector_list
+
+ def _get_matrices(self, request_iterator, md: dict):
+ """Process a stream of matrix messages.
+
+ Parameters
+ ----------
+ request_iterator : iterator
+ Iterator to the received request messages of type ``Matrix``.
+ md : dict
+ Metadata provided by the client.
+
+ Returns
+ -------
+ np.type, tuple, list of np.array
+ Type of data, shape of the matrices, and list of matrices to process.
+ """
+ # Determine how many full matrix messages are to be processed
+ full_msgs = int(md.get("full-matrices"))
+
+ # Initialize the output matrix list and some aux vars
+ matrix_list = []
+ dtype = None
+ size = None
+
+ # Loop over the expected full messages
+ for msg in range(1, full_msgs + 1):
+
+ # Find out how many partial matrix messages constitute this full matrix message
+ chunks = int(md.get("mat%d-messages" % msg))
+
+ # Initialize the output matrix
+ matrix = None
+
+ # Loop over the expected chunks
+ for chunk_msg in range(chunks):
+ # Read the matrix message
+ chunk_mat = next(request_iterator)
+
+ # Inform about the size of the message content
+ click.echo(
+ "Size of message: "
+ + constants.human_size(chunk_mat.matrix_as_chunk)
+ )
+
+ # If processing the first chunk of the message, fill in some data
+ if chunk_msg == 0:
+ # Check the data type of the incoming matrix
+ if chunk_mat.data_type == grpcdemo_pb2.DataType.Value("INTEGER"):
+ dtype = check_data_type(dtype, np.int32)
+ elif chunk_mat.data_type == grpcdemo_pb2.DataType.Value("DOUBLE"):
+ dtype = check_data_type(dtype, np.float64)
+
+ # Check the size of the incoming matrix
+ size = check_size(
+ size,
+ (
+ chunk_mat.matrix_rows,
+ chunk_mat.matrix_cols,
+ ),
+ )
+
+ # Parse the chunk
+ if matrix is None:
+ matrix = np.frombuffer(chunk_mat.matrix_as_chunk, dtype=dtype)
+ else:
+ tmp = np.frombuffer(chunk_mat.matrix_as_chunk, dtype=dtype)
+ matrix = np.concatenate((matrix, tmp))
+
+ # Check if the final matrix has the desired size
+ if matrix.size != size[0] * size[1]:
+ raise RuntimeError("Problems reading client full Matrix message...")
+ else:
+ # If everything is fine, append to matrix_list
+ matrix = np.reshape(matrix, size)
+ matrix_list.append(matrix)
+
+ # Return the input matrix list (as a list of numpy.ndarray)
+ return dtype, size, matrix_list
+
+ def _read_client_metadata(self, context):
+ """Return the metadata as a dictionary.
+
+ Parameters
+ ----------
+ context : grpc.ServicerContext
+ gRPC-specific information.
+
+ Returns
+ -------
+ dict
+ Python-readable metadata in dictionary form.
+ """
+ metadata = context.invocation_metadata()
+ metadata_dict = {}
+ for c in metadata:
+ metadata_dict[c.key] = c.value
+
+ return metadata_dict
+
+ def _generate_md(self, message_type: str, abbrev: str, *args: np.ndarray):
+ """Generate the server metadata sent to the client and determine the number of chunks in which to decompose each message.
+
+ Parameters
+ ----------
+ message_type : str
+ Type of message being sent. Options are``vectors`` and ``matrices``.
+ abbrev : str
+ Abbreviated form of the message being sent. Options are ``vec`` and ``mat``.
+
+ Returns
+ -------
+ list[tuple], list[list[int]]
+ Metadata to be sent by the server and the chunk indices for the list
+ of messages to send.
+
+ Raises
+ ------
+ RuntimeError
+ In case of an invalid use of this function.
+ """
+ # Initialize the metadata and the chunks list for each full message
+ md = []
+ chunks = []
+
+ # Find how many arguments are to be transmitted
+ md.append(("full-" + message_type, str(len(args))))
+
+ # Loop over all input arguments
+ idx = 1
+ for arg in args:
+ # Check the size of the arrays
+ # If size is surpassed, determine chunks needed
+ if arg.nbytes > constants.MAX_CHUNKSIZE:
+ # Let us determine how many chunks we will need
+ #
+ # Max amount of elements per chunk
+ max_elems = constants.MAX_CHUNKSIZE // arg.itemsize
+
+ # Bulk number of chunks needed
+ bulk_chunks = arg.size // max_elems
+
+ # The remainder amount of elements (if any)
+ remainder = arg.size % max_elems
+
+ # This list provides the last index up to which to
+ # process in each partial vector or matrix message
+ last_idx_chunk = []
+ for i in range(1, bulk_chunks + 1):
+ last_idx_chunk.append(i * max_elems)
+
+ # Take into account that if there is a remainder,
+ # include one last partial vector or matrix message.
+ if remainder != 0:
+ last_idx_chunk.append(arg.size)
+
+ # Append the results
+ md.append((abbrev + str(idx) + "-messages", str(len(last_idx_chunk))))
+ chunks.append(last_idx_chunk)
+
+ else:
+ # Otherwise dealing with a single message.. Append results.
+ md.append((abbrev + str(idx) + "-messages", str(1)))
+ chunks.append([arg.size])
+
+ # Increase idx by 1
+ idx += 1
+
+ # Return the metadata and the chunks list for each vector or matrix
+ return md, chunks
+
+ def _send_vectors(self, context: grpc.ServicerContext, *args: np.ndarray):
+ """Send the response vector messages.
+
+ Parameters
+ ----------
+ context : grpc.ServicerContext
+ gRPC context.
+ args : np.ndarray
+ Variable size of np.arrays to transmit.
+
+ Yields
+ ------
+ grpcdemo_pb2.Vector
+ Vector messages streamed (full or partial, depending on the metadata)
+ """
+
+ # Generate the metadata and info on the chunks
+ md, chunks = self._generate_md("vectors", "vec", *args)
+
+ # Send the initial metadata
+ context.send_initial_metadata(md)
+
+ # Loop over all input arguments
+ for arg, vector_chunks in zip(args, chunks):
+ # Loop over the chunk indices
+ processed_idx = 0
+ for last_idx_chunk in vector_chunks:
+ # Use tmp_idx in yield function and update the processed_idx afterwards
+ tmp_idx = processed_idx
+ processed_idx = last_idx_chunk
+
+ # Yield!
+ yield grpcdemo_pb2.Vector(
+ data_type=constants.NP_DTYPE_TO_DATATYPE[arg.dtype.type],
+ vector_size=arg.shape[0],
+ vector_as_chunk=arg[tmp_idx:last_idx_chunk].tobytes(),
+ )
+
+ def _send_matrices(self, context: grpc.ServicerContext, *args: np.ndarray):
+ """Sending the response matrix messages.
+
+ Parameters
+ ----------
+ context : grpc.ServicerContext
+ gRPC context.
+ args : np.ndarray
+ Variable size of np.arrays to transmit.
+
+ Yields
+ ------
+ grpcdemo_pb2.Matrix
+ Matrix messages streamed (full or partial, depending on the metadata)
+ """
+
+ # Generate the metadata and info on the chunks
+ md, chunks = self._generate_md("matrices", "mat", *args)
+
+ # Send the initial metadata
+ context.send_initial_metadata(md)
+
+ # Loop over all input arguments
+ for arg, matrix_chunks in zip(args, chunks):
+ # Since we are dealing with matrices, ravel it to a 1D array (avoids copy)
+ arg_as_vec = arg.ravel()
+
+ # Loop over the chunk indices
+ processed_idx = 0
+ for last_idx_chunk in matrix_chunks:
+ # Use tmp_idx in yield function and update the processed_idx afterwards
+ tmp_idx = processed_idx
+ processed_idx = last_idx_chunk
+
+ # Yield!
+ yield grpcdemo_pb2.Matrix(
+ data_type=constants.NP_DTYPE_TO_DATATYPE[arg.dtype.type],
+ matrix_rows=arg.shape[0],
+ matrix_cols=arg.shape[1],
+ matrix_as_chunk=arg_as_vec[tmp_idx:last_idx_chunk].tobytes(),
+ )
+
+
+
+# =================================================================================================
+# SERVING METHODS for Server operations
+# =================================================================================================
+
+
+
+[docs]
+def serve():
+ """Deploy the API Eigen Example server."""
+ server = grpc.server(futures.ThreadPoolExecutor(max_workers=10))
+ grpcdemo_pb2_grpc.add_GRPCDemoServicer_to_server(GRPCDemoServicer(), server)
+ server.add_insecure_port("[::]:50051")
+ server.start()
+ server.wait_for_termination()
+
+
+
+if __name__ == "__main__":
+ logging.basicConfig()
+ serve()
+
+"""Python implementation of the REST API Eigen example client."""
+
+import json
+
+import numpy as np
+import requests
+
+_EXP_DTYPE = np.dtype("float64")
+"""Expected dtype for numpy arrays."""
+
+
+
+[docs]
+class DemoRESTClient:
+ """Acts as a client to the service provided by the API REST server of this same project.
+ This class has several public methods that allow for direct interaction with the server,
+ without having to care about the formatting of the RESTful queries.
+ """
+
+ # =================================================================================================
+ # PUBLIC METHODS for Client operations
+ # =================================================================================================
+
+ def __init__(self, host, port, user=None, pwd=None, client=None):
+ """Initialize the client.
+
+ Parameters
+ ----------
+ host : str
+ Host (IP/DNS) where the destination server is located.
+ port : int
+ Port that is exposed by the destination server.
+ user : str, optional
+ Username to use in basic authentication. The default is ``None``.
+ pwd : str, optional
+ Password to use in basic authentication. The default is ``None``.
+ client : FlaskClient
+ Flask client, which is to be used only for testing purposes. The default is ``None``.
+ """
+ self._host = host
+ self._port = port
+ self._user = user
+ self._pwd = pwd
+
+ # Depending if we are testing or not... it may be needed to pass the
+ # FlaskClient directly...
+ if client is not None:
+ self._use_test_client = True
+ self._client = client
+ else:
+ self._use_test_client = False
+
+
+[docs]
+ def get_connection_details(self):
+ """Get a simple summary of the connection details."""
+
+ # Check that we are not using a test client
+ if self._use_test_client:
+ print("Using a test client. Unnecessary info.")
+ return
+
+ # First, print the basic details of the connection
+ print(
+ "Connection to host "
+ + self._host
+ + " through port "
+ + str(self._port)
+ + " for using the demo-eigen-wrapper package as a REST Service."
+ )
+
+ # Add, as well, credential details if available
+ if self._user is not None:
+ print(">>> User: " + self._user)
+
+ if self._pwd is not None:
+ print(">>> Pwd: " + self._pwd)
+
+
+
+[docs]
+ def add(self, arg1, arg2):
+ """Add two numpy.ndarrays using the Eigen library (C++), which is exposed via the destination RESTful server.
+
+ Parameters
+ ----------
+ arg1 : numpy.ndarray
+ First numpy.ndarray to consider in the operation.
+ arg2 : numpy.ndarray
+ Second numpy.ndarray to consider in the operation.
+
+ Returns
+ -------
+ numpy.ndarray
+ Sum of adding arg1 and arg2 (arg1 + arg2).
+ """
+ # Check that the provided arguments are inline with the handled parameters by our service
+ arg_dim = self.__check_args(arg1, arg2)
+
+ # Perform the server-related operations
+ return self.__perform_operation(arg1, arg2, arg_dim, "add")
+
+
+
+[docs]
+ def subtract(self, arg1, arg2):
+ """Subtract two numpy.ndarrays using the Eigen library
+ (C++), which is exposed via the destination RESTful server.
+
+ Parameters
+ ----------
+ arg1 : numpy.ndarray
+ First numpy.ndarray to consider in the operation.
+ arg2 : numpy.ndarray
+ Second numpy.ndarray to consider in the operation.
+
+ Returns
+ -------
+ numpy.ndarray
+ The result of subtracting arg2 from arg1 (arg1 - arg2).
+ """
+ # Check that the provided arguments are inline with the handled parameters by our service
+ arg_dim = self.__check_args(arg1, arg2)
+
+ # This operation is not even required to be implemented in the server side...
+ # Just negate arg2... and perform the server-related operations. Pretty easy!
+ return self.__perform_operation(arg1, np.negative(arg2), arg_dim, "add")
+
+
+
+[docs]
+ def multiply(self, arg1, arg2):
+ """Multiply two numpy.ndarrays using the Eigen library (C++), which is exposed via the destination RESTful server.
+
+ Parameters
+ ----------
+ arg1 : numpy.ndarray
+ First numpy.ndarray to consider in the operation.
+ arg2 : numpy.ndarray
+ Second numpy.ndarray to consider in the operation.
+
+ Returns
+ -------
+ numpy.ndarray
+ The result of multiplyng arg1 and arg2 (arg1 * arg2).
+ """
+ # Check that the provided arguments are inline with the handled parameters by our service
+ arg_dim = self.__check_args(arg1, arg2)
+
+ # Perform the server-related operations
+ return self.__perform_operation(arg1, arg2, arg_dim, "multiply")
+
+
+ # =================================================================================================
+ # PRIVATE METHODS for Client operations
+ # =================================================================================================
+
+ def __check_args(self, arg1, arg2):
+ """Check that provided arguments respect the expected inputs by the server. The goal of this
+ private method is to avoid destination server error-throw whenever possible.
+
+ Parameters
+ ----------
+ arg1 : numpy.ndarray
+ First numpy.ndarray to consider in the operation.
+ arg2 : numpy.ndarray
+ Second numpy.ndarray to consider in the operation.
+
+ Returns
+ -------
+ int
+ Shape of the involved numpy.ndarrays.
+
+ Raises
+ ------
+ RuntimeError
+ If the first argument (arg1) is not a numpy.ndarray of type numpy.float64.
+ RuntimeError
+ If the second argument (arg1) is not a numpy.ndarray of type numpy.float64.
+ RuntimeError
+ If the arguments have different shapes.
+ RuntimeError
+ If the dimensions of the arguments are not handled by the destination server.
+ """
+ # Ensure that both arg1 and arg2 are np.ndarrays
+ if (isinstance(arg1, np.ndarray) is not True) or (arg1.dtype is not _EXP_DTYPE):
+ raise RuntimeError(
+ "First argument is not a numpy.ndarray of dtype numpy.float64. Check inputs."
+ )
+ if (isinstance(arg2, np.ndarray) is not True) or (arg2.dtype is not _EXP_DTYPE):
+ raise RuntimeError(
+ "Second argument is not a numpy.ndarray of dtype numpy.float64. Check inputs."
+ )
+
+ # Check as well that both numpy.ndarrays are of the same shape
+ if arg1.shape == arg2.shape:
+ arg_dim = len(arg1.shape)
+ else:
+ raise RuntimeError("Arguments have different shapes. Check inputs.")
+
+ # Return the dimension of the arguments (if it is of the handled types)
+ if arg_dim in (1, 2):
+ return arg_dim
+ else:
+ raise RuntimeError(
+ "Only numpy.ndarrays of 1D (i.e. vectors) or 2D (i.e. matrices) are allowed. Check inputs."
+ )
+
+ def __perform_operation(self, arg1, arg2, arg_dim, ops):
+ """Generalistic private method to handle operations with resources Vectors and Matrices of
+ the destination server.
+
+ Parameters
+ ----------
+ arg1 : numpy.ndarray
+ First numpy.ndarray to consider in the operation.
+ arg2 : numpy.ndarray
+ Second numpy.ndarray to consider in the operation.
+ arg_dim : int
+ Shape of the involved numpy.ndarrays.
+ ops : str
+ Type of operation to carry out. For example, "add" or "multiply".
+
+ Returns
+ -------
+ numpy.ndarray
+ Tesult of the operation requested between arg1 and arg2.
+ """
+ # At this point we must check if we are dealing with a vector or a matrix...
+ # and proceed to perform the requested operation
+ if arg_dim == 1:
+ id1 = self.__post_resource(arg1, "Vectors")
+ id2 = self.__post_resource(arg2, "Vectors")
+ return self.__get_ops_resource(id1, id2, ops, "Vectors")
+ else:
+ id1 = self.__post_resource(arg1, "Matrices")
+ id2 = self.__post_resource(arg2, "Matrices")
+ return self.__get_ops_resource(id1, id2, ops, "Matrices")
+
+ def __post_resource(self, arg, resource):
+ """Generalistic private method to handle the posting of objects to the destination server.
+
+ Parameters
+ ----------
+ arg : numpy.ndarray
+ The numpy.ndarray to post to the destination server.
+ resource : str
+ Type of resource where the posting is to be performed.
+
+ Returns
+ -------
+ int
+ ID of the posted object.
+
+ Raises
+ ------
+ RuntimeError
+ If the Client failed to connect to the destination server.
+ RuntimeError
+ If the Client failed to post the argument to the destination server.
+ """
+ # Perform the post request
+ try:
+ if not self._use_test_client:
+ response = requests.post(
+ self._host + ":" + str(self._port) + "/" + resource,
+ json={"value": arg.tolist()},
+ auth=(self._user, self._pwd),
+ )
+ else:
+ response = self._client.post(
+ "/" + resource,
+ json={"value": arg.tolist()},
+ auth=(self._user, self._pwd),
+ )
+ except (requests.exceptions.ConnectionError):
+ raise RuntimeError(
+ "Could not connect to server... Check server status or connection details."
+ )
+
+ # Check that the status of the response is correct
+ if response.status_code != 201:
+ raise RuntimeError("Client failed to post object in destination Server...")
+
+ # If everything went well... extract the id of the posted object
+ return self.__get_val(json.loads(response.text), "id")
+
+ def __get_ops_resource(self, id1, id2, ops, resource):
+ """_summary_
+
+ Parameters
+ ----------
+ id1 : int
+ ID (in the destination server) of the first argument in the operation.
+ id2 : int
+ ID (in the destination server) of the second argument in the operation.
+ ops : str
+ Type of operation to perform.
+ resource : str
+ Type of resource involved in the operation.
+
+ Returns
+ -------
+ numpy.ndarray
+ Result of the operation requested.
+
+ Raises
+ ------
+ RuntimeError
+ If the Client failed to connect to the destination server.
+ RuntimeError
+ If the Client failed to perform the operation in the destination server.
+ """
+ # Perform the get request
+ try:
+ if not self._use_test_client:
+ response = requests.get(
+ self._host + ":" + str(self._port) + "/" + ops + "/" + resource,
+ json={"id1": id1, "id2": id2},
+ auth=(self._user, self._pwd),
+ )
+ else:
+ response = self._client.get(
+ "/" + ops + "/" + resource,
+ json={"id1": id1, "id2": id2},
+ auth=(self._user, self._pwd),
+ )
+ except (requests.exceptions.ConnectionError):
+ raise RuntimeError(
+ "Could not connect to server... Check server status or connection details."
+ )
+
+ # Check that the status of the response is correct
+ if response.status_code != 200:
+ raise RuntimeError(
+ "Client failed to perform operation in destination Server..."
+ )
+
+ # If everything went well... extract the result of the operation
+ result_aslist = self.__get_val(json.loads(response.text), "result")
+
+ # From the JSON response, when parsed, the result will be considered as a simple
+ # Python object (double, list of doubles...). Convert it to a numpy.ndarray object
+ return np.array(result_aslist, dtype=np.float64)
+
+ def __get_val(self, search_dict, key):
+ """Private method to iterate recursively inside a multidict.
+
+ This method has been gratefully used from https://stackoverflow.com/a/66668504
+
+ Parameters
+ ----------
+ search_dict : dict
+ Dictionary or multiple dictionaries to search.
+ key : str
+ Key to search for.
+
+ Returns
+ -------
+ Any
+ Value of interest.
+ """
+ for elem in search_dict:
+ if elem == key:
+ return search_dict[elem]
+ if isinstance(search_dict[elem], dict):
+ retval = self.__get_val(search_dict[elem], key)
+ if retval is not None:
+ return retval
+
+
+"""Python implementation of the REST API Eigen example database."""
+
+import os
+import sqlite3
+
+import click
+from flask import current_app, g
+
+# =================================================================================================
+# PUBLIC METHODS for DB interaction
+# =================================================================================================
+
+
+
+[docs]
+def init_app_db(app):
+ """Initialize a simple database for storing API REST data."""
+ current_app = app
+ current_app.app_context().push()
+
+ # Initialize the new app's DB, deleting any pre-existing data and build it from scracth
+ __init_db()
+
+ # Register this function so that it is called whenever a response is returned by the application
+ current_app.teardown_appcontext(__close_db)
+
+ # Emit a message informing the user
+ click.echo("Our App's DB has been initialized!")
+
+
+
+
+[docs]
+def get_db():
+ """Get the database instance of the Flask app.
+
+ Returns
+ -------
+ Connection
+ Connection to the app's database.
+ """
+ if "db" not in g:
+ # Check if folder exists... otherwise, create it
+ os.makedirs(os.path.dirname(current_app.config["DATABASE"]), exist_ok=True)
+
+ g.db = sqlite3.connect(
+ current_app.config["DATABASE"], detect_types=sqlite3.PARSE_DECLTYPES
+ )
+ g.db.row_factory = sqlite3.Row
+
+ return g.db
+
+
+
+# =================================================================================================
+# PRIVATE METHODS for DB interaction
+# =================================================================================================
+
+
+def __close_db(*args):
+ """Close the database."""
+ db = g.pop("db", None)
+
+ if db is not None:
+ db.close()
+
+
+def __init_db():
+ """Initialize the database."""
+ db = get_db()
+
+ with current_app.open_resource("restdb/schema.sql") as f:
+ db.executescript(f.read().decode("utf8"))
+
+"""Python implementation of the REST API Eigen example server."""
+
+import json
+from math import floor
+import os
+
+import click
+import demo_eigen_wrapper
+from flask import Flask, jsonify, request
+import numpy as np
+
+from ansys.eigen.python.rest.restdb.db import get_db, init_app_db
+
+#
+#
+# It is necessary to define the environment variable FLASK_APP pointing to this same file
+#
+# For running the app, just call "flask run"
+#
+#
+
+# It would be ideal that Python had switches implemented...
+# ... specially for these constant parameters
+ALLOWED_TYPES = (
+ "vector",
+ "matrix",
+)
+
+ALLOWED_OPS = (
+ "addition",
+ "multiplication",
+)
+
+HUMAN_SIZES = ["B", "KB", "MB", "GB", "TB"]
+
+
+
+[docs]
+def create_app():
+ """Initialize the REST API server.
+
+ Returns
+ -------
+ Flask
+ Instance of the application.
+
+ Raises
+ ------
+ InvalidUsage
+ In case no JSON-format request body was provided.
+ InvalidUsage
+ In case no 'value' is provided within the request body.
+ InvalidUsage
+ In case the given argument is not a string.
+ InvalidUsage
+ In case the given type is not in the ALLOWED_TYPES tuple.
+ """
+ # Create and configure the app
+ app = Flask(__name__, instance_relative_config=True)
+ app.config.from_mapping(
+ SECRET_KEY="dev",
+ DATABASE=os.path.join(app.instance_path, "app.sqlite"),
+ )
+
+ # Tear down previous database and initialize it
+ init_app_db(app)
+
+ # =================================================================================================
+ # PUBLIC METHODS for Server interaction
+ # =================================================================================================
+
+ @app.route("/Vectors", methods=["POST"])
+ def post_vector():
+ """Handles the app's (service's) behavior when accessing the ``Vectors`` resource.
+
+ Returns
+ -------
+ Response
+ Response object containing the ID of the recently posted vector.
+ """
+ # Perform the POST operation using the general method (to avoid code duplications)
+ response_body = __post_eigen_object("vector")
+
+ # Return a successful response with the ID of the created object
+ return response_body, 201
+
+ @app.route("/add/Vectors", methods=["GET"])
+ def add_vectors():
+ """Handles the app's (service's) behavior when accessing the addition
+ operation for the ``Vectors`` resource.
+
+ Returns
+ -------
+ Response
+ Response object containing the vector operation requested.
+ """
+ # Perform the GET operation using the general method (to avoid code duplications)
+ response_body = __ops_eigen_objects("vector", "addition")
+
+ # Return a successful response with the ID of the created object
+ return response_body, 200
+
+ @app.route("/multiply/Vectors", methods=["GET"])
+ def multiply_vectors():
+ """Handles the app's (service's) behavior when accessing the multiplication
+ operation for the ``Vectors`` resource.
+
+ Returns
+ -------
+ Response
+ Response object containing the vector operation requested.
+ """
+ # Perform the GET operation using the general method (to avoid code duplications)
+ response_body = __ops_eigen_objects("vector", "multiplication")
+
+ # Return a successful response with the ID of the created object
+ return response_body, 200
+
+ @app.route("/Matrices", methods=["POST"])
+ def post_matrix():
+ """Handles the app's (service's) behavior when accessing the ``Matrices`` resource
+
+ Returns
+ -------
+ Response
+ Response object containing the ID of the recently posted matrix.
+ """
+ # Perform the POST operation using the general method (to avoid code duplications)
+ response_body = __post_eigen_object("matrix")
+
+ # Return a successful response with the ID of the created object
+ return response_body, 201
+
+ @app.route("/add/Matrices", methods=["GET"])
+ def add_matrices():
+ """Handles the app's (service's) behavior when accessing the addition
+ operation for the ``Matrix`` resource.
+
+ Returns
+ -------
+ Response
+ Response object containing the vector operation requested.
+ """
+ # Perform the GET operation using the general method (to avoid code duplications)
+ response_body = __ops_eigen_objects("matrix", "addition")
+
+ # Return a successful response with the ID of the created object
+ return response_body, 200
+
+ @app.route("/multiply/Matrices", methods=["GET"])
+ def multiply_matrices():
+ """Handles the app's (service's) behavior when accessing the multiplication
+ operation for the ``Matrix`` resource.
+
+ Returns
+ -------
+ Response
+ Response object containing the matrix operation requested.
+ """
+ # Perform the GET operation using the general method (to avoid code duplications)
+ response_body = __ops_eigen_objects("matrix", "multiplication")
+
+ # Return a successful response with the ID of the created object
+ return response_body, 200
+
+ class InvalidUsage(Exception):
+ """Provides the server error class for the API REST server.
+
+ Parameters
+ ----------
+ Exception : class
+ Class from which it inherits.
+
+ Returns
+ -------
+ InvalidUsage
+ Internal server error.
+ """
+
+ status_code = 400
+
+ def __init__(self, message, status_code=None, payload=None):
+ Exception.__init__(self)
+ self.message = message
+ if status_code is not None:
+ self.status_code = status_code
+ self.payload = payload
+
+ def to_dict(self):
+ rv = dict(self.payload or ())
+ rv["message"] = self.message
+ return rv
+
+ @app.errorhandler(InvalidUsage)
+ def handle_invalid_usage(error):
+ """Handles error messages for generating adequate HTTP responses.
+
+ Parameters
+ ----------
+ error : InvalidUsage
+ Incoming error that has been raised.
+
+ Returns
+ -------
+ Response
+ HTTP response with the error information and associated status code.
+ """
+
+ response = jsonify(error.to_dict())
+ response.status_code = error.status_code
+ return response
+
+ # =================================================================================================
+ # PRIVATE METHODS for Server interaction
+ # =================================================================================================
+
+ def __post_eigen_object(type):
+ """Inserts a possible binded object of Eigen (vector or matrix) into the server's database.
+
+ Parameters
+ ----------
+ type : parameter
+ Type of object to insert into the database. It has to be available within the
+ ``ALLOWED_TYPES`` tuple and to be a string.
+
+ Returns
+ -------
+ str
+ JSON-formatted string that contains the ID of the recently inserted object.
+
+ Raises
+ ------
+ InvalidUsage
+ In case no JSON-format request body was provided.
+ InvalidUsage
+ In case no 'value' is provided within the request body.
+ InvalidUsage
+ In case an error was encountered when transforming 'value' into numpy.ndarray.
+ """
+ # Check the argument of this method
+ str_type = __check_value(type, ALLOWED_TYPES)
+
+ # Retrieve the body of the request silently
+ body = request.get_json(silent=True)
+
+ # First check that the request content is in application/json format and
+ # that there are at least some contents within.
+ if body is None:
+ raise InvalidUsage(
+ "No JSON-format (i.e. application/json) body was provided in the request."
+ )
+
+ # Get the object to be inserted into the DB
+ value = body.get("value", None)
+
+ # Check that the object has been indeed provided in the request body
+ if value is None:
+ raise InvalidUsage(
+ "No " + str_type + " has been provided. Expected key: 'value'."
+ )
+
+ # Check that the recently parsed "value" can be transformed into a numpy.ndarray...
+ # Otherwise, throw exception
+ try:
+ np.array(value, dtype=np.float64)
+ except ValueError as error:
+ click.echo(error)
+ raise InvalidUsage(
+ "Error encountered when transforming input string into numpy.ndarray."
+ )
+
+ # Store the value as a string inside the database
+ str_value = json.dumps(value)
+
+ # Insert into DB (as a string) and retrieve the ID of the inserted element
+ db_conn = get_db()
+ cur = db_conn.cursor()
+ cur.execute(
+ "INSERT INTO eigen_db(eigen_type, eigen_value) VALUES (?, ?)",
+ (str_type.upper(), str_value),
+ )
+ db_conn.commit()
+ id_in_db = cur.lastrowid
+
+ # Announce that the object has been added to the DB and..-
+ click.echo(
+ str_type.capitalize()
+ + " with id "
+ + str(id_in_db)
+ + " has been inserted into the server's DB."
+ )
+
+ # Inform about the size of the message content
+ click.echo("Size of message: " + __human_size(request.content_length))
+
+ # ... return the body of the response
+ return json.dumps({str_type: {"id": id_in_db}})
+
+ def __ops_eigen_objects(type, ops):
+ """Handles performing a certain operation on the type of objects provided.
+
+ Parameters
+ ----------
+ type : parameter
+ Type of object to consider in the operation. It has to be available
+ within the ``ALLOWED_TYPES`` tuple and to be a string.
+ ops : parameter
+ Operation to carry out. It has to be available within the ``ALLOWED_OPS``
+ tuple and to be a string.
+
+ Returns
+ -------
+ str
+ JSON-formatted string that contains the result of the operation.
+
+ Raises
+ ------
+ InvalidUsage
+ In case no JSON-format request body was provided.
+ InvalidUsage
+ In case no IDs are provided within the request body.
+ """
+ # Check the arguments of this method
+ str_type = __check_value(type, ALLOWED_TYPES)
+ str_ops = __check_value(ops, ALLOWED_OPS)
+
+ # Retrieve the body of the request silently
+ body = request.get_json(silent=True)
+
+ # Check that the request content is in application/json format and
+ # that there are at least some contents within.
+ if body is None:
+ raise InvalidUsage(
+ "No JSON-format (i.e. application/json) body was provided in the request."
+ )
+
+ # Get the object IDs to be retrieved from the DB
+ id1 = body.get("id1", None)
+ id2 = body.get("id2", None)
+
+ # Check that the object IDs have been provided in the request body
+ if id1 is None or id2 is None:
+ raise InvalidUsage(
+ "Arguments for "
+ + str_ops
+ + " operation with "
+ + str_type
+ + " are not provided. Expected keys: 'id1', 'id2'."
+ )
+
+ # Once the inputs have been verified... perform the operation
+ value = __perform_operation(str_type, str_ops, id1, id2)
+
+ # ... and return the body of the response
+ return json.dumps({str_type + "-" + str_ops: {"result": value}})
+
+ def __check_value(value, allowed_values):
+ """Check to ensure that the provided value is in the ``ALLOWED_*`` tuple
+ and that it is a string.
+
+ Parameters
+ ----------
+ value : parameter
+ Value to process. It has to be available within the ``ALLOWED_*`` tuples
+ provided and has to be a string.
+
+ allowed_values : parameter
+ ``ALLOWED_*`` tuple to consider for evaluation.
+
+ Returns
+ -------
+ str
+ Value argument as a string object.
+
+ Raises
+ ------
+ InvalidUsage
+ In case the given argument is not a string.
+ InvalidUsage
+ In case the given type is not in the ALLOWED_* tuple.
+ """
+ # Check that the provided input is a string
+ if isinstance(value, str) == False:
+ raise InvalidUsage(
+ "The input to __check_value(...) should be a str. Check your implementation."
+ )
+
+ # Work with the "value" arg as a str object
+ str_value = str(value)
+
+ # Check as well that the provided value is one of the allowed values
+ if str_value not in allowed_values:
+ raise InvalidUsage(
+ str_value.capitalize()
+ + " is not one of the allowed values (i.e. ["
+ + ", ".join(allowed_values)
+ + "])."
+ )
+
+ # Return as a str object
+ return str_value
+
+ def __perform_operation(str_type, str_ops, id1, id2):
+ """Retrieve the data from the database DB for performing a certain
+ operation with the eigen-wrapper.
+
+ Parameters
+ ----------
+ str_type : str
+ Type of the objects involved in the operation (vector or matrix).
+ str_ops : str
+ Type of operation to perform. For example, addition or multiplication.
+ id1 : int
+ Dataase identifier for the first object.
+ id2 : int
+ Database identifier for the second object.
+
+ Returns
+ -------
+ double/List(double)
+ Result of the operation.
+ """
+ # Get the values from the DB given the ids (as strings)
+ db_conn = get_db()
+ cur = db_conn.cursor()
+ cur.execute(
+ "SELECT eigen_value FROM eigen_db WHERE id in (?) AND eigen_type in (?)",
+ (id1, str_type.upper()),
+ )
+
+ # Ensure that a value is retrieved for ID1
+ try:
+ str_value1 = cur.fetchone()[0]
+ except TypeError as error:
+ click.echo(error)
+ raise InvalidUsage(
+ "Unexpected error... No values in the database for ID "
+ + str(id1)
+ + " and type "
+ + str_type.capitalize()
+ + "."
+ )
+
+ cur.execute(
+ "SELECT eigen_value FROM eigen_db WHERE id in (?) AND eigen_type in (?)",
+ (id2, str_type.upper()),
+ )
+
+ # Ensure that a value is retrieved for ID2
+ try:
+ str_value2 = cur.fetchone()[0]
+ except TypeError as error:
+ click.echo(error)
+ raise InvalidUsage(
+ "Unexpected error... No values in the database for ID "
+ + str(id2)
+ + " and type "
+ + str_type.capitalize()
+ + "."
+ )
+
+ # Now, convert to np.arrays
+ value1 = np.array(json.loads(str_value1), dtype=np.float64)
+ value2 = np.array(json.loads(str_value2), dtype=np.float64)
+
+ # And finally... perform operation
+ if str_type == "vector" and str_ops == "addition":
+ return demo_eigen_wrapper.add_vectors(value1, value2).tolist()
+ elif str_type == "vector" and str_ops == "multiplication":
+ return demo_eigen_wrapper.multiply_vectors(value1, value2)
+ elif str_type == "matrix" and str_ops == "addition":
+ return demo_eigen_wrapper.add_matrices(value1, value2).tolist()
+ elif str_type == "matrix" and str_ops == "multiplication":
+ return demo_eigen_wrapper.multiply_matrices(value1, value2).tolist()
+ else:
+ # This should not occur
+ return None
+
+ def __human_size(content_length: int):
+ """Show the size of the message in human-readable format.
+
+ Parameters
+ ----------
+ content_length : int
+ Content length of the message.
+
+ Returns
+ -------
+ str
+ Size of the message in human-readable format.
+ """
+ idx = 0
+ while True:
+ if content_length >= 1024:
+ idx += 1
+ content_length = floor(content_length / 1024)
+ else:
+ break
+
+ if idx >= len(HUMAN_SIZES):
+ raise InvalidUsage("Message content above TB level... is not handled.")
+
+ return str(content_length) + HUMAN_SIZES[idx]
+
+ return app
+
+
+
+if __name__ == "__main__":
+ # Create the app
+ app = create_app()
+
+ # When this script is run, deploy the application in 0.0.0.0:5000
+ app.run(host="127.0.0.1", port=5000)
+Short
+ */ + .o-tooltip--left { + position: relative; + } + + .o-tooltip--left:after { + opacity: 0; + visibility: hidden; + position: absolute; + content: attr(data-tooltip); + padding: .2em; + font-size: .8em; + left: -.2em; + background: grey; + color: white; + white-space: nowrap; + z-index: 2; + border-radius: 2px; + transform: translateX(-102%) translateY(0); + transition: opacity 0.2s cubic-bezier(0.64, 0.09, 0.08, 1), transform 0.2s cubic-bezier(0.64, 0.09, 0.08, 1); +} + +.o-tooltip--left:hover:after { + display: block; + opacity: 1; + visibility: visible; + transform: translateX(-100%) translateY(0); + transition: opacity 0.2s cubic-bezier(0.64, 0.09, 0.08, 1), transform 0.2s cubic-bezier(0.64, 0.09, 0.08, 1); + transition-delay: .5s; +} + +/* By default the copy button shouldn't show up when printing a page */ +@media print { + button.copybtn { + display: none; + } +} diff --git a/_static/copybutton.js b/_static/copybutton.js new file mode 100644 index 00000000..8842ce3c --- /dev/null +++ b/_static/copybutton.js @@ -0,0 +1,248 @@ +// Localization support +const messages = { + 'en': { + 'copy': 'Copy', + 'copy_to_clipboard': 'Copy to clipboard', + 'copy_success': 'Copied!', + 'copy_failure': 'Failed to copy', + }, + 'es' : { + 'copy': 'Copiar', + 'copy_to_clipboard': 'Copiar al portapapeles', + 'copy_success': '¡Copiado!', + 'copy_failure': 'Error al copiar', + }, + 'de' : { + 'copy': 'Kopieren', + 'copy_to_clipboard': 'In die Zwischenablage kopieren', + 'copy_success': 'Kopiert!', + 'copy_failure': 'Fehler beim Kopieren', + }, + 'fr' : { + 'copy': 'Copier', + 'copy_to_clipboard': 'Copier dans le presse-papier', + 'copy_success': 'Copié !', + 'copy_failure': 'Échec de la copie', + }, + 'ru': { + 'copy': 'Скопировать', + 'copy_to_clipboard': 'Скопировать в буфер', + 'copy_success': 'Скопировано!', + 'copy_failure': 'Не удалось скопировать', + }, + 'zh-CN': { + 'copy': '复制', + 'copy_to_clipboard': '复制到剪贴板', + 'copy_success': '复制成功!', + 'copy_failure': '复制失败', + }, + 'it' : { + 'copy': 'Copiare', + 'copy_to_clipboard': 'Copiato negli appunti', + 'copy_success': 'Copiato!', + 'copy_failure': 'Errore durante la copia', + } +} + +let locale = 'en' +if( document.documentElement.lang !== undefined + && messages[document.documentElement.lang] !== undefined ) { + locale = document.documentElement.lang +} + +let doc_url_root = DOCUMENTATION_OPTIONS.URL_ROOT; +if (doc_url_root == '#') { + doc_url_root = ''; +} + +/** + * SVG files for our copy buttons + */ +let iconCheck = `` + +// If the user specified their own SVG use that, otherwise use the default +let iconCopy = ``; +if (!iconCopy) { + iconCopy = `` +} + +/** + * Set up copy/paste for code blocks + */ + +const runWhenDOMLoaded = cb => { + if (document.readyState != 'loading') { + cb() + } else if (document.addEventListener) { + document.addEventListener('DOMContentLoaded', cb) + } else { + document.attachEvent('onreadystatechange', function() { + if (document.readyState == 'complete') cb() + }) + } +} + +const codeCellId = index => `codecell${index}` + +// Clears selected text since ClipboardJS will select the text when copying +const clearSelection = () => { + if (window.getSelection) { + window.getSelection().removeAllRanges() + } else if (document.selection) { + document.selection.empty() + } +} + +// Changes tooltip text for a moment, then changes it back +// We want the timeout of our `success` class to be a bit shorter than the +// tooltip and icon change, so that we can hide the icon before changing back. +var timeoutIcon = 2000; +var timeoutSuccessClass = 1500; + +const temporarilyChangeTooltip = (el, oldText, newText) => { + el.setAttribute('data-tooltip', newText) + el.classList.add('success') + // Remove success a little bit sooner than we change the tooltip + // So that we can use CSS to hide the copybutton first + setTimeout(() => el.classList.remove('success'), timeoutSuccessClass) + setTimeout(() => el.setAttribute('data-tooltip', oldText), timeoutIcon) +} + +// Changes the copy button icon for two seconds, then changes it back +const temporarilyChangeIcon = (el) => { + el.innerHTML = iconCheck; + setTimeout(() => {el.innerHTML = iconCopy}, timeoutIcon) +} + +const addCopyButtonToCodeCells = () => { + // If ClipboardJS hasn't loaded, wait a bit and try again. This + // happens because we load ClipboardJS asynchronously. + if (window.ClipboardJS === undefined) { + setTimeout(addCopyButtonToCodeCells, 250) + return + } + + // Add copybuttons to all of our code cells + const COPYBUTTON_SELECTOR = 'div.highlight pre'; + const codeCells = document.querySelectorAll(COPYBUTTON_SELECTOR) + codeCells.forEach((codeCell, index) => { + const id = codeCellId(index) + codeCell.setAttribute('id', id) + + const clipboardButton = id => + `` + codeCell.insertAdjacentHTML('afterend', clipboardButton(id)) + }) + +function escapeRegExp(string) { + return string.replace(/[.*+?^${}()|[\]\\]/g, '\\$&'); // $& means the whole matched string +} + +/** + * Removes excluded text from a Node. + * + * @param {Node} target Node to filter. + * @param {string} exclude CSS selector of nodes to exclude. + * @returns {DOMString} Text from `target` with text removed. + */ +function filterText(target, exclude) { + const clone = target.cloneNode(true); // clone as to not modify the live DOM + if (exclude) { + // remove excluded nodes + clone.querySelectorAll(exclude).forEach(node => node.remove()); + } + return clone.innerText; +} + +// Callback when a copy button is clicked. Will be passed the node that was clicked +// should then grab the text and replace pieces of text that shouldn't be used in output +function formatCopyText(textContent, copybuttonPromptText, isRegexp = false, onlyCopyPromptLines = true, removePrompts = true, copyEmptyLines = true, lineContinuationChar = "", hereDocDelim = "") { + var regexp; + var match; + + // Do we check for line continuation characters and "HERE-documents"? + var useLineCont = !!lineContinuationChar + var useHereDoc = !!hereDocDelim + + // create regexp to capture prompt and remaining line + if (isRegexp) { + regexp = new RegExp('^(' + copybuttonPromptText + ')(.*)') + } else { + regexp = new RegExp('^(' + escapeRegExp(copybuttonPromptText) + ')(.*)') + } + + const outputLines = []; + var promptFound = false; + var gotLineCont = false; + var gotHereDoc = false; + const lineGotPrompt = []; + for (const line of textContent.split('\n')) { + match = line.match(regexp) + if (match || gotLineCont || gotHereDoc) { + promptFound = regexp.test(line) + lineGotPrompt.push(promptFound) + if (removePrompts && promptFound) { + outputLines.push(match[2]) + } else { + outputLines.push(line) + } + gotLineCont = line.endsWith(lineContinuationChar) & useLineCont + if (line.includes(hereDocDelim) & useHereDoc) + gotHereDoc = !gotHereDoc + } else if (!onlyCopyPromptLines) { + outputLines.push(line) + } else if (copyEmptyLines && line.trim() === '') { + outputLines.push(line) + } + } + + // If no lines with the prompt were found then just use original lines + if (lineGotPrompt.some(v => v === true)) { + textContent = outputLines.join('\n'); + } + + // Remove a trailing newline to avoid auto-running when pasting + if (textContent.endsWith("\n")) { + textContent = textContent.slice(0, -1) + } + return textContent +} + + +var copyTargetText = (trigger) => { + var target = document.querySelector(trigger.attributes['data-clipboard-target'].value); + + // get filtered text + let exclude = '.linenos'; + + let text = filterText(target, exclude); + return formatCopyText(text, '>>> ?|\\.\\.\\. ', true, true, true, true, '', '') +} + + // Initialize with a callback so we can modify the text before copy + const clipboard = new ClipboardJS('.copybtn', {text: copyTargetText}) + + // Update UI with error/success messages + clipboard.on('success', event => { + clearSelection() + temporarilyChangeTooltip(event.trigger, messages[locale]['copy'], messages[locale]['copy_success']) + temporarilyChangeIcon(event.trigger) + }) + + clipboard.on('error', event => { + temporarilyChangeTooltip(event.trigger, messages[locale]['copy'], messages[locale]['copy_failure']) + }) +} + +runWhenDOMLoaded(addCopyButtonToCodeCells) \ No newline at end of file diff --git a/_static/copybutton_funcs.js b/_static/copybutton_funcs.js new file mode 100644 index 00000000..dbe1aaad --- /dev/null +++ b/_static/copybutton_funcs.js @@ -0,0 +1,73 @@ +function escapeRegExp(string) { + return string.replace(/[.*+?^${}()|[\]\\]/g, '\\$&'); // $& means the whole matched string +} + +/** + * Removes excluded text from a Node. + * + * @param {Node} target Node to filter. + * @param {string} exclude CSS selector of nodes to exclude. + * @returns {DOMString} Text from `target` with text removed. + */ +export function filterText(target, exclude) { + const clone = target.cloneNode(true); // clone as to not modify the live DOM + if (exclude) { + // remove excluded nodes + clone.querySelectorAll(exclude).forEach(node => node.remove()); + } + return clone.innerText; +} + +// Callback when a copy button is clicked. Will be passed the node that was clicked +// should then grab the text and replace pieces of text that shouldn't be used in output +export function formatCopyText(textContent, copybuttonPromptText, isRegexp = false, onlyCopyPromptLines = true, removePrompts = true, copyEmptyLines = true, lineContinuationChar = "", hereDocDelim = "") { + var regexp; + var match; + + // Do we check for line continuation characters and "HERE-documents"? + var useLineCont = !!lineContinuationChar + var useHereDoc = !!hereDocDelim + + // create regexp to capture prompt and remaining line + if (isRegexp) { + regexp = new RegExp('^(' + copybuttonPromptText + ')(.*)') + } else { + regexp = new RegExp('^(' + escapeRegExp(copybuttonPromptText) + ')(.*)') + } + + const outputLines = []; + var promptFound = false; + var gotLineCont = false; + var gotHereDoc = false; + const lineGotPrompt = []; + for (const line of textContent.split('\n')) { + match = line.match(regexp) + if (match || gotLineCont || gotHereDoc) { + promptFound = regexp.test(line) + lineGotPrompt.push(promptFound) + if (removePrompts && promptFound) { + outputLines.push(match[2]) + } else { + outputLines.push(line) + } + gotLineCont = line.endsWith(lineContinuationChar) & useLineCont + if (line.includes(hereDocDelim) & useHereDoc) + gotHereDoc = !gotHereDoc + } else if (!onlyCopyPromptLines) { + outputLines.push(line) + } else if (copyEmptyLines && line.trim() === '') { + outputLines.push(line) + } + } + + // If no lines with the prompt were found then just use original lines + if (lineGotPrompt.some(v => v === true)) { + textContent = outputLines.join('\n'); + } + + // Remove a trailing newline to avoid auto-running when pasting + if (textContent.endsWith("\n")) { + textContent = textContent.slice(0, -1) + } + return textContent +} diff --git a/_static/css/ansys_sphinx_theme.css b/_static/css/ansys_sphinx_theme.css new file mode 100644 index 00000000..8621c34c --- /dev/null +++ b/_static/css/ansys_sphinx_theme.css @@ -0,0 +1,1089 @@ +/* Provided by the Sphinx base theme template at build time */ + +@import "../basic.css"; +@import url("https://fonts.googleapis.com/css2?family=Lato:ital,wght@0,400;0,700;0,900;1,400;1,700;1,900&family=Open+Sans:ital,wght@0,400;0,600;1,400;1,600&display=swap"); +@import "../sg_gallery.css"; +@import "../design-style.4045f2051d55cab465a707391d5b2007.min.css"; +@import "../styles/pydata-sphinx-theme.css"; + +@font-face { + font-family: "Source Sans Pro Light"; + src: url(../fonts/SourceSansPro-Light.ttf); +} + +@font-face { + font-family: "Source Sans Pro"; + src: url(../fonts/SourceSansPro-Regular.ttf); +} + +:root { + /* Ansys specific changes to the theme */ + + /***************************************************************************** + * Ansys Font family + **/ + /* These are adapted from https://systemfontstack.com/ */ + --pst-font-family-base-system: -apple-system, BlinkMacSystemFont, Segoe UI, + "Helvetica Neue", Arial, sans-serif, Apple Color Emoji, Segoe UI Emoji, + Segoe UI Symbol; + --pst-font-family-monospace-system: "SFMono-Regular", Menlo, Consolas, Monaco, + Liberation Mono, Lucida Console, monospace; + + --pst-font-family-base: "Source Sans Pro", sans-serif, + var(--pst-font-family-base-system); + --pst-font-family-heading: "Source Sans Pro", sans-serif, + var(--pst-font-family-base-system); + --pst-font-family-monospace: monospace, Courier, + var(--pst-font-family-monospace-system); + + /***************************************************************************** + * Ansys compatible colors + * + * Colors are defined in rgb string way, "red, green, blue" + **/ + --ansysGold: rgb(255, 183, 27); /* #FFB71B */ + --ansysBronze: rgb(200, 146, 17); /* #C89211 */ + --pythonBlue: rgb(57, 114, 161); /* #3972a1 */ + + --pst-color-active-navigation: var(--ansysBronze); /* --ansysBronze */ + --pst-color-navbar-link: rgb(255, 255, 255); + --pst-color-navbar-link-hover: var(--ansysBronze); /* --ansysBronze */ + --pst-color-navbar-link-active: var(--ansysGold); /* --ansysBronze */ + --pst-font-size-h1: 48px; + --pst-font-size-h2: 36px; + --pst-font-size-h3: 28px; + --pst-font-size-h4: 20px; + --pst-font-size-h5: 14px; + --pst-font-size-h6: 11px; +} + +html[data-theme="light"] { + /***************************************************************************** + * main colors + */ + --pst-color-primary: #fff; + --pst-color-secondary: rgb(200, 146, 17); + --pst-color-success: rgb(40, 167, 69); + --pst-color-text-base: rgb(0, 0, 0); + --pst-color-text-muted: rgb(26, 24, 24); + --pst-color-border: #a19d9d; + --pst-color-shadow: rgb(216, 216, 216); + --pst-color-info: var(--pst-color-link); + + /***************************************************************************** + * depth colors + */ + --pst-color-on-background: rgb(0, 0, 0); + --pst-color-on-surface: #f2f2f2; + + /***************************************************************************** + * extensions + */ + + --pst-color-panel-background: var(--pst-color-on-background); + + /***************************************************************************** + * layout + */ + + --pst-color-link: #1e6ddc; + --pst-color-link-hover: #32cfea; + --pst-color-inline-code: #000; + --pst-color-target: rgb(255, 255, 255); + + /***************************************************************************** + * color for sphinx-gallery-code output + */ + --pst-color-codecell: #fafae2; + --pst-color-codeout: var(--pst-color-inline-code); + --pst-color-sig: #0965c8; + --pst-color-code-s1: #b35000; + --pst-color-code-c1: #095d0a; + /***************************************************************************** + * sphinx design primary color + */ + --sd-color-primary: var(--pst-color-text-base); + + /***************************************************************************** + * table hovering + */ + --pst-color-table-hover: var(--pst-color-border); + + /***************************************************************************** + * search hide match + */ + --pst-color-search-match: #91969b; +} + +html[data-theme="dark"] { + /***************************************************************************** + * main colors + */ + --pst-color-primary: #d09735; + --pst-color-secondary: #c58e30; + --pst-color-success: rgb(72, 135, 87); + --pst-color-text-base: rgb(201, 209, 217); + --pst-color-text-muted: rgb(192, 192, 192); + --pst-color-border: rgb(192, 192, 192); + --pst-color-shadow: rgb(104, 102, 102); + --pst-color-background: rgb(18, 18, 18); + --pst-color-on-background: rgb(0, 0, 0); + --pst-color-surface: rgb(41, 41, 41); + --pst-color-on-surface: rgb(55, 55, 55); + --pst-color-info: var(--pst-color-secondary); + + /***************************************************************************** + * extensions + */ + + --pst-color-panel-background: var(--pst-color-on-background); + + /***************************************************************************** + * layout + */ + + --pst-color-link: #579ce5; + --pst-color-link-hover: #12b2e2; + --pst-color-inline-code: #fff; + --pst-color-target: rgb(71, 39, 0); + + /***************************************************************************** + * color for sphinx-gallery-code output + */ + --pst-color-codecell: #495057; + --pst-color-codeout: #f2f4f6; + --pst-color-sig: #d6ab1e; + --pst-color-code-s1: #d79a60; + --pst-color-code-c1: #8fb842; + + /***************************************************************************** + * table hovering + */ + --pst-color-table-hover: var(--pst-color-target); + + /***************************************************************************** + * search hide match + */ + --pst-color-search-match: var(--pst-color-primary); +} + +/* +################# +body and content +################# +*/ + +body { + font-family: "Open Sans", sans-serif; +} + +h1, +h2 { + color: var(--pst-color-text-base); +} + +/* +########## +Codecell +########## +*/ + +dt:target, +span.highlighted { + background-color: var(--pst-color-codecell) !important; +} + +.docutils { + color: var(--pst-color-inline-code); + font-family: var(--pst-font-family-monospace); + font-weight: 500; + font-size: 87.5%; +} + +code.literal { + padding: 0.1rem 0.25rem; + padding-top: 0.1rem; + padding-right: 0.25rem; + padding-bottom: 0.1rem; + padding-left: 0.25rem; + background-color: var(--pst-color-on-surface); + border: 1px solid var(--pst-color-border); + border-radius: 0.25rem; +} + +.xref.std.std-ref { + color: var(--pst-color-inline-code); + font-family: "Inconsolata"; + font-weight: normal; + font-style: italic; + padding: 0.1rem 0.25rem; + padding-top: 0.1rem; + padding-right: 0.25rem; + padding-bottom: 0.1rem; + padding-left: 0.25rem; + font-size: 90%; + background-color: var(--pst-color-on-surface); + border: 1px solid var(--pst-color-border); + border-radius: 0.25rem; +} + +.sig { + font-family: "Consolas", "Menlo", "DejaVu Sans Mono", + "Bitstream Vera Sans Mono", monospace; +} + +.sig-name.descname { + color: var(--pst-color-inline-code); +} + +.sig-name { + color: var(--pst-color-sig); +} + +/* Increase empty-space around classes, methods, properties, etc. that are descendants + of other items */ +dl.class dl.py { + margin-top: 2.5em; + margin-bottom: 2.5em; +} + +/* Reduce empty-space around Notes and Examples headings */ +p.rubric { + margin-top: 0.75em; + margin-bottom: 0.75em; +} + +/* +######## +Table +######## +*/ + +.table { + width: 100%; + max-width: 100%; + border-spacing: 0; + border-collapse: collapse; + overflow: hidden; + vertical-align: middle; + color: var(--pst-color-text-base); + /* Disabling scroll bars */ + overflow-y: scroll; + scrollbar-width: none; /* Firefox */ + -ms-overflow-style: none; /* Internet Explorer 10+ */ +} + +tr { + background-color: var(--pst-color-background); +} + +th { + background-color: rgb(255, 183, 27, 0.55); +} + +tr:nth-child(odd), +tr:nth-child(even) { + background-color: var(--pst-color-background); +} + +.table tr:hover td { + background-color: var(--pst-color-table-hover); +} + +div.rendered_html table.dataframe td { + color: var(--pst-color-text-base); +} + +/* +############### +Table-centered +################ +Same as table but with horizontally centered text. + +see examples. +*/ +table.table-centered { + width: 100%; + max-width: 100%; + border-spacing: 0; + border-collapse: collapse; + overflow: hidden; + vertical-align: middle; + text-align: center; + + /* Disabling scroll bars */ + overflow-y: scroll; + scrollbar-width: none; /* Firefox */ + -ms-overflow-style: none; /* Internet Explorer 10+ */ +} + +.table-centered tr { + background-color: var(--pst-color-background); + text-align: center; +} + +.table-centered th { + background-color: rgb(255, 183, 27, 0.55); + text-align: center; +} + +.table-centered tr:nth-child(odd), +.table-centered tr:nth-child(even) { + text-align: center; + background-color: var(--pst-color-background); +} + +.table-centered tr:hover td { + background-color: var(--pst-color-table-hover); + text-align: center; +} + +table.dataframe { + table-layout: auto !important; +} + +/* +################### +longtable-centered +#################### +*/ + +table.longtable-centered { + text-align: center; +} + +.longtable-centered tr { + text-align: center; +} + +.longtable-centered th { + text-align: center; +} + +.longtable-centered tr:nth-child(odd) { + text-align: center; +} + +.longtable-centered tr:nth-child(even) { + text-align: center; +} + +table.longtable-centered tr:hover td { + background-color: var(--pst-color-table-hover); + text-align: center; +} + +/* +######### +DataFrame +######### +*/ + +.dataframe tr { + background-color: var(--pst-color-background); +} + +.dataframe tr:nth-child(odd), +.dataframe tr:nth-child(even) { + background-color: var(--pst-color-background) !important; +} + +.dataframe tr:hover td { + background-color: var(--pst-color-table-hover); +} + +/* +################### +DataFrame-centered +################### +*/ + +.dataframe-centered tr { + background-color: var(--pst-color-background); + text-align: center; +} + +.dataframe-centered tr:nth-child(odd) { + background-color: var(--pst-color-background) !important; + text-align: center; +} + +.dataframe-centered tr:nth-child(even) { + background-color: var(--pst-color-border); + text-align: center; +} + +.dataframe-centered tr:hover td { + background-color: var(--pst-color-border); + text-align: center; +} + +.dataframe thead th { + text-align: center; +} + +/* +############ +data table +############ +*/ + +.dataTables_wrapper .dataTables_paginate .paginate_button.disabled, +.dataTables_wrapper .dataTables_paginate .paginate_button.disabled:hover, +.dataTables_wrapper .dataTables_paginate .paginate_button.disabled:active { + color: var(--pst-color-text-base) !important; +} + +.dataTables_wrapper, +.dataTables_wrapper .dataTables_filter, +.dataTables_wrapper .dataTables_info, +.dataTables_wrapper .dataTables_processing, +.dataTables_wrapper .dataTables_paginate { + color: var(--pst-color-text-base) !important; +} + +table.dataTable tbody th, +table.dataTable tbody td { + background: var(--pst-color-background); +} + +label { + color: var(--pst-color-text-base); +} + +/* +########## +Scroll-bar +########## +*/ + +body::-webkit-scrollbar { + width: 1rem; + height: 1rem; +} + +body::-webkit-scrollbar-thumb { + background: var(--pst-color-border); + border-radius: inherit; +} + +body::-webkit-scrollbar-track { + background: var(--pst-color-background); +} + +.bd-sidebar::-webkit-scrollbar { + width: 0.5rem; + height: 0.5rem; +} + +.bd-sidebar::-webkit-scrollbar-thumb { + background: var(--pst-color-border); + border-radius: inherit; + visibility: hidden !important; +} + +.bd-sidebar::-webkit-scrollbar-track { + background: var(--pst-color-border); + visibility: hidden !important; +} + +.bd-toc::-webkit-scrollbar { + width: 0.5rem; + height: 0.5rem; +} + +.bd-toc::-webkit-scrollbar-thumb { + background: var(--pst-color-border); + border-radius: inherit; +} + +.bd-toc::-webkit-scrollbar-track { + background: var(--pst-color-border); +} + +/* +############ +Autosummary +############ +*/ + +.autosummary tr:nth-child(odd), +.autosummary tr:nth-child(even) { + background-color: var(--pst-color-background); +} + +/* +##################### +ReST :download: links +##################### +*/ +a > code.download { + font-family: var(--pst-font-family-base); + color: var(--pst-color-link); + text-decoration: none; + font-weight: normal; +} + +/* +##################### +Sphinx gallery output +##################### +*/ +.sphx-glr-script-out .highlight pre { + background-color: var(--pst-color-codecell) !important; + color: var(--pst-color-codeout); +} + +.prev-next-area a p.prev-next-title { + color: var(--pst-color-link); + font-weight: 600; + font-size: 1.1em; +} + +.highlight .s1, +.s2, +.kc { + color: var(--pst-color-code-s1) !important; +} + +html[data-theme="dark"] .highlight .kn { + color: #e18fff; + font-weight: normal; +} + +.highlight .c1 { + color: var(--pst-color-code-c1); +} + +html[data-theme="dark"] .highlight .n { + color: #b3d7ff; +} + +html[data-theme="dark"] .highlight .nn { + color: #43d69d; + text-decoration: none; +} +/* +############### +Dropdown button +############### +*/ + +.navbar button.navbar-toggler { + margin-right: 1em; + border-color: rgb(255, 255, 255); + color: rgb(255, 255, 255); +} + +/* +#################################################### +Side column size (first and second column from left) +#################################################### +*/ + +.col-md-3 { + flex: 0 0 20%; + max-width: 20%; +} + +a.headerlink { + color: #222; +} + +@media (min-width: 1200px) { + .container, + .container-lg, + .container-md, + .container-sm, + .container-xl { + max-width: 1200px; + } +} + +@media (min-width: 1600px) { + .container, + .container-lg, + .container-md, + .container-sm, + .container-xl { + max-width: 1600px; + } +} + +/* +############################################ +Navigation column (according to side column) +############################################ +*/ +.col-lg-9 { + padding-right: 5px; + padding-left: 20px; +} +.bd-main .bd-content { + display: flex; + height: 100%; + justify-content: end; +} + +.bd-main .bd-content .bd-article-container .bd-article { + padding-left: 1rem; + padding-top: 1rem; +} +.bd-header .navbar-nav li a.nav-link { + color: #ddd; +} +.bd-header .navbar-nav .dropdown button { + color: #ddd; + display: unset; +} + +/* +################################# +Syntax highlighting in code block +################################# +*/ + +html[data-theme="light"] .highlight .o { + color: #b35000; + font-weight: bold; +} + +/* +############################# +Bold font weight for **code** +############################# +*/ + +b, +strong { + font-weight: 900; +} + +.bd-header .navbar-header-items__start { + width: fit-content; + padding-right: 3rem; +} + +.navbar-nav li a:focus, +.navbar-nav li a:hover, +.navbar-nav li.current > a { + color: white !important; +} + +.navbar-nav .dropdown .dropdown-menu { + min-width: 250px; +} + +/* +########################### +Left side toc-tree hovering +########################### +*/ + +nav.bd-links .active:hover > a { + font-weight: bold; + color: var(--pst-color-text-base); + border-left: 2px solid var(--pst-color-text-base); +} + +nav.bd-links .active > a { + font-weight: bold; + color: var(--pst-color-text-muted) !important; + border-left: 2px solid var(--pst-color-text-base); + border-bottom: none !important; + padding-left: 0.5rem; +} + +nav.bd-links li > a:hover { + font-weight: 900; + color: var(--pst-color-link) !important; +} + +.bd-header .navbar-nav .dropdown button:hover { + color: white; +} + +.dropdown-item:hover { + font-weight: bold; + background-color: transparent; +} + +/* +################## +icon, button, logo +################## +*/ + +button, +input, +optgroup, +select, +textarea, +button:hover { + color: #ddd; +} + +.theme-switch-button { + border-color: #f8f9fa; +} + +button.btn.version-switcher__button { + border-color: var(--pst-color-border); + color: #ddd; +} + +button.version-switcher__button:hover { + color: #f8f8f2; +} + +button.version-switcher__button { + color: #f8f9fa; +} + +.search-button { + color: #ddd; +} + +kbd { + background-color: #f8f9fa; +} + +.theme-switch-button span { + color: #f8f9fa; +} + +.theme-switch-button span:hover { + color: var(--ansysGold); + border-color: white; +} + +.search-button-field { + color: white; + background-color: transparent; +} + +.search-button-field:hover { + color: var(--pst-color-border); +} + +/* make the github logo white */ + +i.fa-github-square:before, +i.fa-square-github:before { + color: white; + font-size: 1rem; +} + +.version-switcher__menu a.list-group-item:hover { + background-color: #d09735 !important; + border-color: var(--pst-color-text-base) !important; + color: #000 !important; +} + +.version-switcher__menu a.list-group-item { + background-color: #f8f9fa; + border-color: var(--pst-color-border); + color: #000; +} + +.fa-wrench:before { + content: "\f0ad"; + color: white; +} + +.navbar-icon-links { + font-size: 1.5rem; + color: white; +} + +html[data-theme="light"] #pst-back-to-top { + background-color: var(--pst-color-link); +} +/* +############################## +image padding before and after +############################## +*/ + +img { + padding-top: 1em; + padding-bottom: 1em; +} + +html[data-theme="dark"] .bd-content img:not(.only-dark):not(.dark-light) { + background: transparent; +} + +img.logo__image { + padding-top: 0rem; + padding-bottom: 0rem; +} + +/* +########################## +Nav-bar entity right side. +########################## +*/ + +nav.bd-links li > a { + color: var(--pst-color-link); + font-size: 0.98rem; +} + +html[data-theme="light"] .highlight pre { + line-height: 125%; + font-size: 0.9em; +} + +html[data-theme="dark"] .highlight pre { + line-height: 125%; + font-size: 0.9em; +} + +.bd-toc { + padding-top: 5em; +} + +#version_switcher_button { + background-color: var(--pst-color-background); +} + +.editthispage a { + color: var(--pst-color-text-base); +} + +.list-group-item.active { + z-index: 2; + color: var(--pst-color-text-base) !important; +} + +/* +############## +Sphinx design +############## +*/ + +blockquote { + background-color: var(--pst-color-background); +} +.sd-sphinx-override, +.sd-sphinx-override * { + font-size: medium; + flex: auto; +} + +/* Sphinx-design tab */ + +/* Common styles for all screen sizes */ +.sd-tab-set > input:not(.focus-visible) + label { + outline: none; + font-size: large; + -webkit-tap-highlight-color: var(--pst-color-background) !important; + color: var(--pst-color-text-base); +} + +.sd-tab-set > input:checked + label + .sd-tab-content { + display: block; + font-size: medium; +} + +.sd-tab-set > input:checked + label + .sd-tab-content { + display: block; + font-size: 0.9rem; +} + +.sd-tab-content { + font-family: var(--pst-font-family-base); +} + +.bd-content .sd-tab-set > input:checked + label, +.bd-content .sd-tab-set > input:not(:checked) + label:hover { + color: var(--pst-color-text-base); + border-color: var(--pst-color-text-base); +} + +/* Media query for medium-sized screens */ +@media screen and (max-width: 768px) { + .sd-tab-set > input:not(.focus-visible) + label { + font-size: medium; + } +} + +/* Media query for small-sized screens */ +@media screen and (max-width: 576px) { + .sd-tab-set > input:not(.focus-visible) + label { + font-size: small; + } +} + +/* Sphinx-design card */ + +/* Common styles for all screen sizes */ +.sd-card .sd-card-text { + font-family: var(--pst-font-family-base) !important; + background-color: var(--pst-color-background) !important; +} + +.bd-content .sd-card .sd-card-header { + border: none; + background-color: transparent; + color: var(--pst-color-text-base) !important; + font-size: var(--pst-font-size-h5); + font-weight: bold; + font-family: var(--pst-font-family-base); + padding: 0.5rem 0rem 0.5rem 0rem; +} + +.sd-card .sd-card-footer .sd-card-text { + max-width: 220px; + margin-left: auto; + margin-right: auto; + font-family: var(--pst-font-family-base); +} + +.bd-content .sd-card .sd-card-body, +.bd-content .sd-card .sd-card-footer, +.bd-content .sd-card .sd-card-text { + background-color: transparent; +} + +html[data-theme="dark"] .sd-shadow-sm { + box-shadow: 0 0.1rem 1rem rgba(250, 250, 250, 0.6) !important; +} + +html[data-theme="dark"] .sd-card-img-top[src*=".png"] { + filter: invert(0.82) brightness(0.8) contrast(1.2); +} + +/* Common styles for all screen sizes */ +.sd-card { + border-radius: 0; + padding: 10px 10px 10px 10px; + font-family: var(--pst-font-family-base) !important; +} + +/* Media query for medium-sized screens */ +@media screen and (max-width: 768px) { + .sd-card .sd-card-header { + font-size: var(--pst-font-size-h6); + } +} + +/* Media query for small-sized screens */ +@media screen and (max-width: 576px) { + .sd-card .sd-card-header { + font-size: var(--pst-font-size-h5); + } + .sd-card { + padding: 5px 5px 5px 5px; + } + .sd-sphinx-override, + .sd-sphinx-override * { + box-sizing: content-box !important; + } +} + +/* +Sphinx-design dropdown +*/ + +.bd-content details.sd-dropdown .sd-summary-title { + border: 1px solid var(--pst-color-text-base) !important; + color: var(--pst-color-text-base) !important; + font-family: var(monospace) !important; + font-size: medium; + text-align: left; + padding-left: 1rem; +} + +details.sd-dropdown summary.sd-card-header + div.sd-summary-content { + background-color: transparent; +} + +/* +################################# +Right side toctree color and font +################################# +*/ +.toc-entry a.nav-link { + padding: 0.125rem 1.5rem; + color: var(--pst-color-link); +} + +.toc-entry a.nav-link.active { + font-weight: bold; + color: var(--pst-color-text-base); + background-color: transparent; + border-left: 2px solid var(--pst-color-text-muted); +} + +.toc-h2 { + font-size: 0.98rem; + padding: 0.05em; +} + +.toc-h3 { + font-size: 0.96rem; +} + +.toc-h4 { + font-size: 0.9rem; +} + +.toc-entry a.nav-link:hover { + color: var(--pst-color-link); + text-decoration: none; + font-weight: 600; +} + +/* +########### +Directives +########### +*/ + +div.deprecated { + border-color: var(--pst-color-danger); + background-color: #dc354514; +} + +div.deprecated, +div.versionadded, +div.versionchanged { + background-color: transparent; +} + +.admonition, +div.admonition { + background-color: var(--pst-color-on-surface); +} + +/* Select only divisions that contain a dataframe, with enough specificity to override pydata css */ +div.nboutput + div.output_area.rendered_html.docutils.container:has(table.dataframe) { + background-color: transparent; +} + +/* +############ +Border lines +############ +*/ +.bd-sidebar-primary, +.bd-sidebar-secondary { + max-height: calc(100vh - var(--pst-header-height) - 1vh); +} + +/* +################# +search hide match +################# +*/ + +div#searchbox p.highlight-link a { + background-color: var(--pst-color-search-match); +} + +.header-article__inner { + padding: 0 1rem; +} diff --git a/_static/css/breadcrumbs.css b/_static/css/breadcrumbs.css new file mode 100644 index 00000000..60fe0155 --- /dev/null +++ b/_static/css/breadcrumbs.css @@ -0,0 +1,70 @@ +/* Provided by the Sphinx base theme template at build time, +styles exclusively for the ansys-sphinx-theme classes. */ + +@import "ansys-sphinx-theme.css"; + +/* +############ +breadcrumbs +############ +*/ + +#breadcrumbs-spacer { + border-right: 10rem solid var(--pst-color-background); +} + +div.related > ul { + padding: 10px 0 20px 0; +} + +*, +:after, +:before { + box-sizing: border-box; +} + +/* +########################### +vesrion warning announcement +############################ +*/ + +#announcement_msg { + display: flex; + justify-content: center; + position: relative; + width: 100%; + padding: 0.5rem 12.5%; + text-align: center; +} + +#announcement_msg :after { + position: absolute; + width: 100%; + height: 100%; + left: 0; + top: 0; + background-color: rgb(223, 95, 114); + opacity: 0.2; + content: ""; + z-index: -1; +} + +#announcement_msg :empty { + display: none; +} + +#announcement_msg p { + font-weight: bold; + margin: auto; + color: black; +} + +html[data-theme="dark"] #announcement_msg :after { + background-color: lightpink; + opacity: 0.5; +} + +#announcement_msg a { + color: #1e6ddc; +} diff --git a/_static/css/meilisearch.css b/_static/css/meilisearch.css new file mode 100644 index 00000000..16b350e2 --- /dev/null +++ b/_static/css/meilisearch.css @@ -0,0 +1,200 @@ +@import "https://cdn.jsdelivr.net/npm/docs-searchbar.js@latest/dist/cdn/docs-searchbar.min.css"; +@import "https://cdnjs.cloudflare.com/ajax/libs/font-awesome/5.15.3/css/all.min.css"; + +div[data-ds-theme] .searchbox { + overflow-y: scroll; + margin: auto; +} + +.docs-searchbar-suggestion--category-header { + background-color: var(--pst-color-border); + border-radius: 7px; + text-align: left; +} + +/* Styles for screens with a width of 576px or less */ +@media screen and (max-width: 576px) { + div[data-ds-theme] .searchbox { + width: 100%; + max-width: 100%; + } + .bd-search input { + width: 100% !important; + } + + .index-select { + width: 30%; + } +} + +/* Styles for screens with a width of 1200px or less */ +@media screen and (min-width: 1200px) { + div[data-ds-theme] .searchbox { + width: 100%; + max-width: 100%; + } + + .bd-search input { + width: 600px !important; + } + .index-select { + width: 250px; + } +} +.dsb-suggestions { + width: 100%; + max-width: 140%; +} + +div[data-ds-theme] .meilisearch-autocomplete .dsb-dropdown-menu { + max-width: 200%; + min-width: 100%; + width: 140%; +} +div[data-ds-theme] .meilisearch-autocomplete .docs-searchbar-suggestion { + width: 100%; +} + +div[data-ds-theme] .searchbox input { + height: 32px; + border-radius: 8px; + font-size: 18px; + font-family: "Open Sans", sans-serif; + box-shadow: 0px 0px 8px darkgrey; +} + +.docs-searchbar-footer { + display: none; +} + +.docs-searchbar-footer { + display: none; +} + +[class*="docs-searchbar-suggestion"] { + text-decoration: none; +} + +.docs-searchbar-suggestion--highlight { + box-shadow: none !important; +} + +.container { + display: flex; + justify-content: center; + align-items: center; +} + +div[data-ds-theme] .meilisearch-autocomplete { + text-align: center; + color: var(--pst-color-text-base); +} + +#search-bar-input { + background-color: var(--pst-color-background); + border: 1px solid var(--pst-color-border); + border-radius: 0.25rem; + color: var(--pst-color-text-base); + font-size: var(--pst-font-size-icon); + position: relative; + padding-left: 3rem; +} + +.meilisearch-autocomplete::before { + content: "\f002"; + font-family: "Font Awesome 6 Free"; + position: absolute; + left: 8px; + top: 50%; + transform: translateY(-50%); + font-size: 1rem; + color: var(--pst-color-border); +} + +.index-select { + color: var(--pst-color-text-base); + background: var(--pst-color-background); + height: 47px; + border: 1px solid var(--pst-color-border); + border-radius: 0.25rem; + font-size: 20px; + font-family: "Open Sans", sans-serif; + box-shadow: 0px 0px 20px var(--pst-color-border); + padding: 0 10px 0px 10px; + margin-left: 5px; +} + +div[data-ds-theme] + .meilisearch-autocomplete + .dsb-dropdown-menu + [class^="dsb-dataset-"] { + position: relative; + border: 1px solid #d9d9d9; + background: var(--pst-color-background); + border-radius: 4px; + padding: 0 8px 8px; +} +div[data-ds-theme] .meilisearch-autocomplete .dsb-dropdown-menu { + max-height: 600px !important; + overflow-y: auto !important; + border: 1px solid #ccc; +} + +div[data-ds-theme] .meilisearch-autocomplete .docs-searchbar-suggestion { + background: var(--pst-color-background); +} + +div[data-ds-theme] + .meilisearch-autocomplete + .docs-searchbar-suggestion--highlight { + color: var(--pst-color-info) !important; + font-weight: 900; + background: transparent; + padding: 0 0.05em; +} + +div[data-ds-theme] + .meilisearch-autocomplete + .docs-searchbar-suggestion--subcategory-column { + width: None; + text-align: left; +} + +div[data-ds-theme] + .meilisearch-autocomplete + .docs-searchbar-suggestion--content { + display: block; +} + +div[data-ds-theme] .meilisearch-autocomplete .docs-searchbar-suggestion--title { + margin-bottom: 4px; + color: var(--pst-color-text-base); + font-size: 0.9em; + font-weight: 700; + width: 100%; +} + +/* Styling the scrollbar */ +div[data-ds-theme] + .meilisearch-autocomplete + .dsb-dropdown-menu::-webkit-scrollbar { + width: 0.5rem; + height: 0.5rem; +} + +div[data-ds-theme] + .meilisearch-autocomplete + .dsb-dropdown-menu::-webkit-scrollbar-thumb { + background: var(--pst-color-text-base); + border-radius: inherit; +} + +div[data-ds-theme] + .meilisearch-autocomplete + .dsb-dropdown-menu::-webkit-scrollbar-track { + background: var(--pst-color-background); +} + +.bd-search { + margin-bottom: 200px; +} diff --git a/_static/doctools.js b/_static/doctools.js new file mode 100644 index 00000000..d06a71d7 --- /dev/null +++ b/_static/doctools.js @@ -0,0 +1,156 @@ +/* + * doctools.js + * ~~~~~~~~~~~ + * + * Base JavaScript utilities for all Sphinx HTML documentation. + * + * :copyright: Copyright 2007-2023 by the Sphinx team, see AUTHORS. + * :license: BSD, see LICENSE for details. + * + */ +"use strict"; + +const BLACKLISTED_KEY_CONTROL_ELEMENTS = new Set([ + "TEXTAREA", + "INPUT", + "SELECT", + "BUTTON", +]); + +const _ready = (callback) => { + if (document.readyState !== "loading") { + callback(); + } else { + document.addEventListener("DOMContentLoaded", callback); + } +}; + +/** + * Small JavaScript module for the documentation. + */ +const Documentation = { + init: () => { + Documentation.initDomainIndexTable(); + Documentation.initOnKeyListeners(); + }, + + /** + * i18n support + */ + TRANSLATIONS: {}, + PLURAL_EXPR: (n) => (n === 1 ? 0 : 1), + LOCALE: "unknown", + + // gettext and ngettext don't access this so that the functions + // can safely bound to a different name (_ = Documentation.gettext) + gettext: (string) => { + const translated = Documentation.TRANSLATIONS[string]; + switch (typeof translated) { + case "undefined": + return string; // no translation + case "string": + return translated; // translation exists + default: + return translated[0]; // (singular, plural) translation tuple exists + } + }, + + ngettext: (singular, plural, n) => { + const translated = Documentation.TRANSLATIONS[singular]; + if (typeof translated !== "undefined") + return translated[Documentation.PLURAL_EXPR(n)]; + return n === 1 ? singular : plural; + }, + + addTranslations: (catalog) => { + Object.assign(Documentation.TRANSLATIONS, catalog.messages); + Documentation.PLURAL_EXPR = new Function( + "n", + `return (${catalog.plural_expr})` + ); + Documentation.LOCALE = catalog.locale; + }, + + /** + * helper function to focus on search bar + */ + focusSearchBar: () => { + document.querySelectorAll("input[name=q]")[0]?.focus(); + }, + + /** + * Initialise the domain index toggle buttons + */ + initDomainIndexTable: () => { + const toggler = (el) => { + const idNumber = el.id.substr(7); + const toggledRows = document.querySelectorAll(`tr.cg-${idNumber}`); + if (el.src.substr(-9) === "minus.png") { + el.src = `${el.src.substr(0, el.src.length - 9)}plus.png`; + toggledRows.forEach((el) => (el.style.display = "none")); + } else { + el.src = `${el.src.substr(0, el.src.length - 8)}minus.png`; + toggledRows.forEach((el) => (el.style.display = "")); + } + }; + + const togglerElements = document.querySelectorAll("img.toggler"); + togglerElements.forEach((el) => + el.addEventListener("click", (event) => toggler(event.currentTarget)) + ); + togglerElements.forEach((el) => (el.style.display = "")); + if (DOCUMENTATION_OPTIONS.COLLAPSE_INDEX) togglerElements.forEach(toggler); + }, + + initOnKeyListeners: () => { + // only install a listener if it is really needed + if ( + !DOCUMENTATION_OPTIONS.NAVIGATION_WITH_KEYS && + !DOCUMENTATION_OPTIONS.ENABLE_SEARCH_SHORTCUTS + ) + return; + + document.addEventListener("keydown", (event) => { + // bail for input elements + if (BLACKLISTED_KEY_CONTROL_ELEMENTS.has(document.activeElement.tagName)) return; + // bail with special keys + if (event.altKey || event.ctrlKey || event.metaKey) return; + + if (!event.shiftKey) { + switch (event.key) { + case "ArrowLeft": + if (!DOCUMENTATION_OPTIONS.NAVIGATION_WITH_KEYS) break; + + const prevLink = document.querySelector('link[rel="prev"]'); + if (prevLink && prevLink.href) { + window.location.href = prevLink.href; + event.preventDefault(); + } + break; + case "ArrowRight": + if (!DOCUMENTATION_OPTIONS.NAVIGATION_WITH_KEYS) break; + + const nextLink = document.querySelector('link[rel="next"]'); + if (nextLink && nextLink.href) { + window.location.href = nextLink.href; + event.preventDefault(); + } + break; + } + } + + // some keyboard layouts may need Shift to get / + switch (event.key) { + case "/": + if (!DOCUMENTATION_OPTIONS.ENABLE_SEARCH_SHORTCUTS) break; + Documentation.focusSearchBar(); + event.preventDefault(); + } + }); + }, +}; + +// quick alias for translations +const _ = Documentation.gettext; + +_ready(Documentation.init); diff --git a/_static/documentation_options.js b/_static/documentation_options.js new file mode 100644 index 00000000..1f706aa4 --- /dev/null +++ b/_static/documentation_options.js @@ -0,0 +1,13 @@ +const DOCUMENTATION_OPTIONS = { + VERSION: '0.0.1', + LANGUAGE: 'en', + COLLAPSE_INDEX: false, + BUILDER: 'html', + FILE_SUFFIX: '.html', + LINK_SUFFIX: '.html', + HAS_SOURCE: true, + SOURCELINK_SUFFIX: '.txt', + NAVIGATION_WITH_KEYS: true, + SHOW_SEARCH_SUMMARY: true, + ENABLE_SEARCH_SHORTCUTS: true, +}; \ No newline at end of file diff --git a/_static/file.png b/_static/file.png new file mode 100644 index 00000000..a858a410 Binary files /dev/null and b/_static/file.png differ diff --git a/_static/fonts/SourceSansPro-Light.ttf b/_static/fonts/SourceSansPro-Light.ttf new file mode 100644 index 00000000..348871ac Binary files /dev/null and b/_static/fonts/SourceSansPro-Light.ttf differ diff --git a/_static/fonts/SourceSansPro-Regular.ttf b/_static/fonts/SourceSansPro-Regular.ttf new file mode 100644 index 00000000..b422bf43 Binary files /dev/null and b/_static/fonts/SourceSansPro-Regular.ttf differ diff --git a/_static/fonts/SourceSansPro-SemiBold.ttf b/_static/fonts/SourceSansPro-SemiBold.ttf new file mode 100644 index 00000000..2908e0d7 Binary files /dev/null and b/_static/fonts/SourceSansPro-SemiBold.ttf differ diff --git a/_static/js/download_target_blank.js b/_static/js/download_target_blank.js new file mode 100644 index 00000000..9f84c70f --- /dev/null +++ b/_static/js/download_target_blank.js @@ -0,0 +1,6 @@ +/* Add target="_blank" attribute to all hyperlinks generated by the ReST :download: directive. + * This will ensure the links open in a new tab. */ + +$(document).ready(function () { + $("a.download").attr("target", "_blank"); +}); diff --git a/_static/js/meilisearch_theme_wrap.js b/_static/js/meilisearch_theme_wrap.js new file mode 100644 index 00000000..db529f19 --- /dev/null +++ b/_static/js/meilisearch_theme_wrap.js @@ -0,0 +1,50 @@ +require.config({ + paths: { + docsSearchBar: + "https://cdn.jsdelivr.net/npm/docs-searchbar.js@2.5.0/dist/cdn/docs-searchbar.min", + }, +}); + +require(["docsSearchBar"], function (docsSearchBar) { + document.body.style.overflow = "hidden !important"; + // Initialize the MeiliSearch bar with the given API key and host + // inspect the first value of index UID as default + + var theSearchBar = docsSearchBar({ + hostUrl: HOST_URL, + apiKey: API_KEY, + indexUid: indexUid, + inputSelector: "#search-bar-input", + debug: true, // Set debug to true if you want to inspect the dropdown + meilisearchOptions: { + limit: 1000, + }, + }); + + // Listen for changes in the dropdown selector and update the index uid and suggestion accordingly + document + .getElementById("indexUidSelector") + .addEventListener("change", function () { + theSearchBar.indexUid = this.value; + theSearchBar.suggestionIndexUid = this.value; + theSearchBar.autocomplete.autocomplete.setVal(""); + }); + + // Listen for changes in the search bar input and update the suggestion accordingly + document + .getElementById("search-bar-input") + .addEventListener("change", function () { + theSearchBar.suggestionIndexUid = + document.getElementById("indexUidSelector").value; + }); + + // Set the focus on the search bar input + document.getElementById("searchbar").focus(); + + // Set the focus on the dropdown selector + document + .getElementById("searchbar") + .addEventListener("indexUidSelector", function () { + theSearchBar.autocomplete.autocomplete.close(); + }); +}); diff --git a/_static/js/table.js b/_static/js/table.js new file mode 100644 index 00000000..a080ead1 --- /dev/null +++ b/_static/js/table.js @@ -0,0 +1,3 @@ +$(document).ready(function () { + $("table.datatable").DataTable(); +}); diff --git a/_static/jupyter-sphinx.css b/_static/jupyter-sphinx.css new file mode 100644 index 00000000..87724dfc --- /dev/null +++ b/_static/jupyter-sphinx.css @@ -0,0 +1,123 @@ +/* Stylesheet for jupyter-sphinx + +These styles mimic the Jupyter HTML styles. + +The default CSS (Cascading Style Sheet) class structure of jupyter-sphinx +is the following: + +jupyter_container + code_cell (optional) + stderr (optional) + output (optional) + +If the code_cell is not displayed, then there is not a jupyter_container, and +the output is provided without CSS. + +This stylesheet attempts to override the defaults of all packaged Sphinx themes +to display jupter-sphinx cells in a Jupyter-like style. + +If you want to adjust the styles, add additional custom CSS to override these +styles. + +After a build, this stylesheet is loaded from ./_static/jupyter-sphinx.css . + +*/ + + +div.jupyter_container { + padding: .4em; + margin: 0 0 .4em 0; + background-color: #FFFF; + border: 1px solid #CCC; + -moz-box-shadow: 2px 2px 4px rgba(87, 87, 87, 0.2); + -webkit-box-shadow: 2px 2px 4px rgba(87, 87, 87, 0.2); + box-shadow: 2px 2px 4px rgba(87, 87, 87, 0.2); +} +.jupyter_container div.code_cell { + border: 1px solid #cfcfcf; + border-radius: 2px; + background-color: #f7f7f7; + margin: 0 0; + overflow: auto; +} + +.jupyter_container div.code_cell pre { + padding: 4px; + margin: 0 0; + background-color: #f7f7f7; + border: none; + background: none; + box-shadow: none; + -webkit-box-shadow: none; /* for nature */ + -moz-box-shadow: none; /* for nature */ +} + +.jupyter_container div.code_cell * { + margin: 0 0; +} +div.jupyter_container div.highlight { + background-color: #f7f7f7; /* for haiku */ +} +div.jupyter_container { + padding: 0; + margin: 0; +} + +/* Prevent alabaster breaking highlight alignment */ +div.jupyter_container .hll { + padding: 0; + margin: 0; +} + +/* overrides for sphinx_rtd_theme */ +.rst-content .jupyter_container div[class^='highlight'], +.document .jupyter_container div[class^='highlight'], +.rst-content .jupyter_container pre.literal-block { + border:none; + margin: 0; + padding: 0; + background: none; + padding: 3px; + background-color: transparent; +} +/* restore Mathjax CSS, as it assumes a vertical margin. */ +.jupyter_container .MathJax_Display { + margin: 1em 0em; + text-align: center; +} +.jupyter_container .stderr { + background-color: #FCC; + border: none; + padding: 3px; +} +.jupyter_container .output { + border: none; +} +.jupyter_container div.output pre { + background-color: white; + background: none; + padding: 4px; + border: none; + box-shadow: none; + -webkit-box-shadow: none; /* for nature */ + -moz-box-shadow: none; /* for nature */ +} +.jupyter_container .code_cell td.linenos { + text-align: right; + padding: 4px 4px 4px 8px; + border-right: 1px solid #cfcfcf; + color: #999; +} +.jupyter_container .output .highlight { + background-color: #ffffff; +} +/* combine sequential jupyter cells, + by moving sequential ones up higher on y-axis */ +div.jupyter_container + div.jupyter_container { + margin: -.5em 0 .4em 0; +} + +/* Fix for sphinx_rtd_theme spacing after jupyter_container #91 */ +.rst-content .jupyter_container { + margin: 0 0 24px 0; +} diff --git a/_static/jupyterlite_badge_logo.svg b/_static/jupyterlite_badge_logo.svg new file mode 100644 index 00000000..5de36d7f --- /dev/null +++ b/_static/jupyterlite_badge_logo.svg @@ -0,0 +1,3 @@ + + + \ No newline at end of file diff --git a/_static/language_data.js b/_static/language_data.js new file mode 100644 index 00000000..250f5665 --- /dev/null +++ b/_static/language_data.js @@ -0,0 +1,199 @@ +/* + * language_data.js + * ~~~~~~~~~~~~~~~~ + * + * This script contains the language-specific data used by searchtools.js, + * namely the list of stopwords, stemmer, scorer and splitter. + * + * :copyright: Copyright 2007-2023 by the Sphinx team, see AUTHORS. + * :license: BSD, see LICENSE for details. + * + */ + +var stopwords = ["a", "and", "are", "as", "at", "be", "but", "by", "for", "if", "in", "into", "is", "it", "near", "no", "not", "of", "on", "or", "such", "that", "the", "their", "then", "there", "these", "they", "this", "to", "was", "will", "with"]; + + +/* Non-minified version is copied as a separate JS file, is available */ + +/** + * Porter Stemmer + */ +var Stemmer = function() { + + var step2list = { + ational: 'ate', + tional: 'tion', + enci: 'ence', + anci: 'ance', + izer: 'ize', + bli: 'ble', + alli: 'al', + entli: 'ent', + eli: 'e', + ousli: 'ous', + ization: 'ize', + ation: 'ate', + ator: 'ate', + alism: 'al', + iveness: 'ive', + fulness: 'ful', + ousness: 'ous', + aliti: 'al', + iviti: 'ive', + biliti: 'ble', + logi: 'log' + }; + + var step3list = { + icate: 'ic', + ative: '', + alize: 'al', + iciti: 'ic', + ical: 'ic', + ful: '', + ness: '' + }; + + var c = "[^aeiou]"; // consonant + var v = "[aeiouy]"; // vowel + var C = c + "[^aeiouy]*"; // consonant sequence + var V = v + "[aeiou]*"; // vowel sequence + + var mgr0 = "^(" + C + ")?" + V + C; // [C]VC... is m>0 + var meq1 = "^(" + C + ")?" + V + C + "(" + V + ")?$"; // [C]VC[V] is m=1 + var mgr1 = "^(" + C + ")?" + V + C + V + C; // [C]VCVC... is m>1 + var s_v = "^(" + C + ")?" + v; // vowel in stem + + this.stemWord = function (w) { + var stem; + var suffix; + var firstch; + var origword = w; + + if (w.length < 3) + return w; + + var re; + var re2; + var re3; + var re4; + + firstch = w.substr(0,1); + if (firstch == "y") + w = firstch.toUpperCase() + w.substr(1); + + // Step 1a + re = /^(.+?)(ss|i)es$/; + re2 = /^(.+?)([^s])s$/; + + if (re.test(w)) + w = w.replace(re,"$1$2"); + else if (re2.test(w)) + w = w.replace(re2,"$1$2"); + + // Step 1b + re = /^(.+?)eed$/; + re2 = /^(.+?)(ed|ing)$/; + if (re.test(w)) { + var fp = re.exec(w); + re = new RegExp(mgr0); + if (re.test(fp[1])) { + re = /.$/; + w = w.replace(re,""); + } + } + else if (re2.test(w)) { + var fp = re2.exec(w); + stem = fp[1]; + re2 = new RegExp(s_v); + if (re2.test(stem)) { + w = stem; + re2 = /(at|bl|iz)$/; + re3 = new RegExp("([^aeiouylsz])\\1$"); + re4 = new RegExp("^" + C + v + "[^aeiouwxy]$"); + if (re2.test(w)) + w = w + "e"; + else if (re3.test(w)) { + re = /.$/; + w = w.replace(re,""); + } + else if (re4.test(w)) + w = w + "e"; + } + } + + // Step 1c + re = /^(.+?)y$/; + if (re.test(w)) { + var fp = re.exec(w); + stem = fp[1]; + re = new RegExp(s_v); + if (re.test(stem)) + w = stem + "i"; + } + + // Step 2 + re = /^(.+?)(ational|tional|enci|anci|izer|bli|alli|entli|eli|ousli|ization|ation|ator|alism|iveness|fulness|ousness|aliti|iviti|biliti|logi)$/; + if (re.test(w)) { + var fp = re.exec(w); + stem = fp[1]; + suffix = fp[2]; + re = new RegExp(mgr0); + if (re.test(stem)) + w = stem + step2list[suffix]; + } + + // Step 3 + re = /^(.+?)(icate|ative|alize|iciti|ical|ful|ness)$/; + if (re.test(w)) { + var fp = re.exec(w); + stem = fp[1]; + suffix = fp[2]; + re = new RegExp(mgr0); + if (re.test(stem)) + w = stem + step3list[suffix]; + } + + // Step 4 + re = /^(.+?)(al|ance|ence|er|ic|able|ible|ant|ement|ment|ent|ou|ism|ate|iti|ous|ive|ize)$/; + re2 = /^(.+?)(s|t)(ion)$/; + if (re.test(w)) { + var fp = re.exec(w); + stem = fp[1]; + re = new RegExp(mgr1); + if (re.test(stem)) + w = stem; + } + else if (re2.test(w)) { + var fp = re2.exec(w); + stem = fp[1] + fp[2]; + re2 = new RegExp(mgr1); + if (re2.test(stem)) + w = stem; + } + + // Step 5 + re = /^(.+?)e$/; + if (re.test(w)) { + var fp = re.exec(w); + stem = fp[1]; + re = new RegExp(mgr1); + re2 = new RegExp(meq1); + re3 = new RegExp("^" + C + v + "[^aeiouwxy]$"); + if (re.test(stem) || (re2.test(stem) && !(re3.test(stem)))) + w = stem; + } + re = /ll$/; + re2 = new RegExp(mgr1); + if (re.test(w) && re2.test(w)) { + re = /.$/; + w = w.replace(re,""); + } + + // and turn initial Y back to y + if (firstch == "y") + w = firstch.toLowerCase() + w.substr(1); + return w; + } +} + diff --git a/_static/minus.png b/_static/minus.png new file mode 100644 index 00000000..d96755fd Binary files /dev/null and b/_static/minus.png differ diff --git a/_static/no_image.png b/_static/no_image.png new file mode 100644 index 00000000..8c2d48d5 Binary files /dev/null and b/_static/no_image.png differ diff --git a/_static/plus.png b/_static/plus.png new file mode 100644 index 00000000..7107cec9 Binary files /dev/null and b/_static/plus.png differ diff --git a/_static/pyansys-logo-black-cropped.png b/_static/pyansys-logo-black-cropped.png new file mode 100644 index 00000000..e28bc3de Binary files /dev/null and b/_static/pyansys-logo-black-cropped.png differ diff --git a/_static/pyansys-logo-white-cropped.png b/_static/pyansys-logo-white-cropped.png new file mode 100644 index 00000000..91b50f98 Binary files /dev/null and b/_static/pyansys-logo-white-cropped.png differ diff --git a/_static/pyansys_dark.png b/_static/pyansys_dark.png new file mode 100644 index 00000000..b0ff9e19 Binary files /dev/null and b/_static/pyansys_dark.png differ diff --git a/_static/pyansys_dark_square.png b/_static/pyansys_dark_square.png new file mode 100644 index 00000000..2b271562 Binary files /dev/null and b/_static/pyansys_dark_square.png differ diff --git a/_static/pyansys_light.png b/_static/pyansys_light.png new file mode 100644 index 00000000..9f31babd Binary files /dev/null and b/_static/pyansys_light.png differ diff --git a/_static/pyansys_light_square.png b/_static/pyansys_light_square.png new file mode 100644 index 00000000..3e0706a5 Binary files /dev/null and b/_static/pyansys_light_square.png differ diff --git a/_static/pygments.css b/_static/pygments.css new file mode 100644 index 00000000..997797f2 --- /dev/null +++ b/_static/pygments.css @@ -0,0 +1,152 @@ +html[data-theme="light"] .highlight pre { line-height: 125%; } +html[data-theme="light"] .highlight td.linenos .normal { color: inherit; background-color: transparent; padding-left: 5px; padding-right: 5px; } +html[data-theme="light"] .highlight span.linenos { color: inherit; background-color: transparent; padding-left: 5px; padding-right: 5px; } +html[data-theme="light"] .highlight td.linenos .special { color: #000000; background-color: #ffffc0; padding-left: 5px; padding-right: 5px; } +html[data-theme="light"] .highlight span.linenos.special { color: #000000; background-color: #ffffc0; padding-left: 5px; padding-right: 5px; } +html[data-theme="light"] .highlight .hll { background-color: #7971292e } +html[data-theme="light"] .highlight { background: #fefefe; color: #545454 } +html[data-theme="light"] .highlight .c { color: #797129 } /* Comment */ +html[data-theme="light"] .highlight .err { color: #d91e18 } /* Error */ +html[data-theme="light"] .highlight .k { color: #7928a1 } /* Keyword */ +html[data-theme="light"] .highlight .l { color: #797129 } /* Literal */ +html[data-theme="light"] .highlight .n { color: #545454 } /* Name */ +html[data-theme="light"] .highlight .o { color: #008000 } /* Operator */ +html[data-theme="light"] .highlight .p { color: #545454 } /* Punctuation */ +html[data-theme="light"] .highlight .ch { color: #797129 } /* Comment.Hashbang */ +html[data-theme="light"] .highlight .cm { color: #797129 } /* Comment.Multiline */ +html[data-theme="light"] .highlight .cp { color: #797129 } /* Comment.Preproc */ +html[data-theme="light"] .highlight .cpf { color: #797129 } /* Comment.PreprocFile */ +html[data-theme="light"] .highlight .c1 { color: #797129 } /* Comment.Single */ +html[data-theme="light"] .highlight .cs { color: #797129 } /* Comment.Special */ +html[data-theme="light"] .highlight .gd { color: #007faa } /* Generic.Deleted */ +html[data-theme="light"] .highlight .ge { font-style: italic } /* Generic.Emph */ +html[data-theme="light"] .highlight .gh { color: #007faa } /* Generic.Heading */ +html[data-theme="light"] .highlight .gs { font-weight: bold } /* Generic.Strong */ +html[data-theme="light"] .highlight .gu { color: #007faa } /* Generic.Subheading */ +html[data-theme="light"] .highlight .kc { color: #7928a1 } /* Keyword.Constant */ +html[data-theme="light"] .highlight .kd { color: #7928a1 } /* Keyword.Declaration */ +html[data-theme="light"] .highlight .kn { color: #7928a1 } /* Keyword.Namespace */ +html[data-theme="light"] .highlight .kp { color: #7928a1 } /* Keyword.Pseudo */ +html[data-theme="light"] .highlight .kr { color: #7928a1 } /* Keyword.Reserved */ +html[data-theme="light"] .highlight .kt { color: #797129 } /* Keyword.Type */ +html[data-theme="light"] .highlight .ld { color: #797129 } /* Literal.Date */ +html[data-theme="light"] .highlight .m { color: #797129 } /* Literal.Number */ +html[data-theme="light"] .highlight .s { color: #008000 } /* Literal.String */ +html[data-theme="light"] .highlight .na { color: #797129 } /* Name.Attribute */ +html[data-theme="light"] .highlight .nb { color: #797129 } /* Name.Builtin */ +html[data-theme="light"] .highlight .nc { color: #007faa } /* Name.Class */ +html[data-theme="light"] .highlight .no { color: #007faa } /* Name.Constant */ +html[data-theme="light"] .highlight .nd { color: #797129 } /* Name.Decorator */ +html[data-theme="light"] .highlight .ni { color: #008000 } /* Name.Entity */ +html[data-theme="light"] .highlight .ne { color: #7928a1 } /* Name.Exception */ +html[data-theme="light"] .highlight .nf { color: #007faa } /* Name.Function */ +html[data-theme="light"] .highlight .nl { color: #797129 } /* Name.Label */ +html[data-theme="light"] .highlight .nn { color: #545454 } /* Name.Namespace */ +html[data-theme="light"] .highlight .nx { color: #545454 } /* Name.Other */ +html[data-theme="light"] .highlight .py { color: #007faa } /* Name.Property */ +html[data-theme="light"] .highlight .nt { color: #007faa } /* Name.Tag */ +html[data-theme="light"] .highlight .nv { color: #d91e18 } /* Name.Variable */ +html[data-theme="light"] .highlight .ow { color: #7928a1 } /* Operator.Word */ +html[data-theme="light"] .highlight .pm { color: #545454 } /* Punctuation.Marker */ +html[data-theme="light"] .highlight .w { color: #545454 } /* Text.Whitespace */ +html[data-theme="light"] .highlight .mb { color: #797129 } /* Literal.Number.Bin */ +html[data-theme="light"] .highlight .mf { color: #797129 } /* Literal.Number.Float */ +html[data-theme="light"] .highlight .mh { color: #797129 } /* Literal.Number.Hex */ +html[data-theme="light"] .highlight .mi { color: #797129 } /* Literal.Number.Integer */ +html[data-theme="light"] .highlight .mo { color: #797129 } /* Literal.Number.Oct */ +html[data-theme="light"] .highlight .sa { color: #008000 } /* Literal.String.Affix */ +html[data-theme="light"] .highlight .sb { color: #008000 } /* Literal.String.Backtick */ +html[data-theme="light"] .highlight .sc { color: #008000 } /* Literal.String.Char */ +html[data-theme="light"] .highlight .dl { color: #008000 } /* Literal.String.Delimiter */ +html[data-theme="light"] .highlight .sd { color: #008000 } /* Literal.String.Doc */ +html[data-theme="light"] .highlight .s2 { color: #008000 } /* Literal.String.Double */ +html[data-theme="light"] .highlight .se { color: #008000 } /* Literal.String.Escape */ +html[data-theme="light"] .highlight .sh { color: #008000 } /* Literal.String.Heredoc */ +html[data-theme="light"] .highlight .si { color: #008000 } /* Literal.String.Interpol */ +html[data-theme="light"] .highlight .sx { color: #008000 } /* Literal.String.Other */ +html[data-theme="light"] .highlight .sr { color: #d91e18 } /* Literal.String.Regex */ +html[data-theme="light"] .highlight .s1 { color: #008000 } /* Literal.String.Single */ +html[data-theme="light"] .highlight .ss { color: #007faa } /* Literal.String.Symbol */ +html[data-theme="light"] .highlight .bp { color: #797129 } /* Name.Builtin.Pseudo */ +html[data-theme="light"] .highlight .fm { color: #007faa } /* Name.Function.Magic */ +html[data-theme="light"] .highlight .vc { color: #d91e18 } /* Name.Variable.Class */ +html[data-theme="light"] .highlight .vg { color: #d91e18 } /* Name.Variable.Global */ +html[data-theme="light"] .highlight .vi { color: #d91e18 } /* Name.Variable.Instance */ +html[data-theme="light"] .highlight .vm { color: #797129 } /* Name.Variable.Magic */ +html[data-theme="light"] .highlight .il { color: #797129 } /* Literal.Number.Integer.Long */ +html[data-theme="dark"] .highlight pre { line-height: 125%; } +html[data-theme="dark"] .highlight td.linenos .normal { color: inherit; background-color: transparent; padding-left: 5px; padding-right: 5px; } +html[data-theme="dark"] .highlight span.linenos { color: inherit; background-color: transparent; padding-left: 5px; padding-right: 5px; } +html[data-theme="dark"] .highlight td.linenos .special { color: #000000; background-color: #ffffc0; padding-left: 5px; padding-right: 5px; } +html[data-theme="dark"] .highlight span.linenos.special { color: #000000; background-color: #ffffc0; padding-left: 5px; padding-right: 5px; } +html[data-theme="dark"] .highlight .hll { background-color: #ffd9002e } +html[data-theme="dark"] .highlight { background: #2b2b2b; color: #f8f8f2 } +html[data-theme="dark"] .highlight .c { color: #ffd900 } /* Comment */ +html[data-theme="dark"] .highlight .err { color: #ffa07a } /* Error */ +html[data-theme="dark"] .highlight .k { color: #dcc6e0 } /* Keyword */ +html[data-theme="dark"] .highlight .l { color: #ffd900 } /* Literal */ +html[data-theme="dark"] .highlight .n { color: #f8f8f2 } /* Name */ +html[data-theme="dark"] .highlight .o { color: #abe338 } /* Operator */ +html[data-theme="dark"] .highlight .p { color: #f8f8f2 } /* Punctuation */ +html[data-theme="dark"] .highlight .ch { color: #ffd900 } /* Comment.Hashbang */ +html[data-theme="dark"] .highlight .cm { color: #ffd900 } /* Comment.Multiline */ +html[data-theme="dark"] .highlight .cp { color: #ffd900 } /* Comment.Preproc */ +html[data-theme="dark"] .highlight .cpf { color: #ffd900 } /* Comment.PreprocFile */ +html[data-theme="dark"] .highlight .c1 { color: #ffd900 } /* Comment.Single */ +html[data-theme="dark"] .highlight .cs { color: #ffd900 } /* Comment.Special */ +html[data-theme="dark"] .highlight .gd { color: #00e0e0 } /* Generic.Deleted */ +html[data-theme="dark"] .highlight .ge { font-style: italic } /* Generic.Emph */ +html[data-theme="dark"] .highlight .gh { color: #00e0e0 } /* Generic.Heading */ +html[data-theme="dark"] .highlight .gs { font-weight: bold } /* Generic.Strong */ +html[data-theme="dark"] .highlight .gu { color: #00e0e0 } /* Generic.Subheading */ +html[data-theme="dark"] .highlight .kc { color: #dcc6e0 } /* Keyword.Constant */ +html[data-theme="dark"] .highlight .kd { color: #dcc6e0 } /* Keyword.Declaration */ +html[data-theme="dark"] .highlight .kn { color: #dcc6e0 } /* Keyword.Namespace */ +html[data-theme="dark"] .highlight .kp { color: #dcc6e0 } /* Keyword.Pseudo */ +html[data-theme="dark"] .highlight .kr { color: #dcc6e0 } /* Keyword.Reserved */ +html[data-theme="dark"] .highlight .kt { color: #ffd900 } /* Keyword.Type */ +html[data-theme="dark"] .highlight .ld { color: #ffd900 } /* Literal.Date */ +html[data-theme="dark"] .highlight .m { color: #ffd900 } /* Literal.Number */ +html[data-theme="dark"] .highlight .s { color: #abe338 } /* Literal.String */ +html[data-theme="dark"] .highlight .na { color: #ffd900 } /* Name.Attribute */ +html[data-theme="dark"] .highlight .nb { color: #ffd900 } /* Name.Builtin */ +html[data-theme="dark"] .highlight .nc { color: #00e0e0 } /* Name.Class */ +html[data-theme="dark"] .highlight .no { color: #00e0e0 } /* Name.Constant */ +html[data-theme="dark"] .highlight .nd { color: #ffd900 } /* Name.Decorator */ +html[data-theme="dark"] .highlight .ni { color: #abe338 } /* Name.Entity */ +html[data-theme="dark"] .highlight .ne { color: #dcc6e0 } /* Name.Exception */ +html[data-theme="dark"] .highlight .nf { color: #00e0e0 } /* Name.Function */ +html[data-theme="dark"] .highlight .nl { color: #ffd900 } /* Name.Label */ +html[data-theme="dark"] .highlight .nn { color: #f8f8f2 } /* Name.Namespace */ +html[data-theme="dark"] .highlight .nx { color: #f8f8f2 } /* Name.Other */ +html[data-theme="dark"] .highlight .py { color: #00e0e0 } /* Name.Property */ +html[data-theme="dark"] .highlight .nt { color: #00e0e0 } /* Name.Tag */ +html[data-theme="dark"] .highlight .nv { color: #ffa07a } /* Name.Variable */ +html[data-theme="dark"] .highlight .ow { color: #dcc6e0 } /* Operator.Word */ +html[data-theme="dark"] .highlight .pm { color: #f8f8f2 } /* Punctuation.Marker */ +html[data-theme="dark"] .highlight .w { color: #f8f8f2 } /* Text.Whitespace */ +html[data-theme="dark"] .highlight .mb { color: #ffd900 } /* Literal.Number.Bin */ +html[data-theme="dark"] .highlight .mf { color: #ffd900 } /* Literal.Number.Float */ +html[data-theme="dark"] .highlight .mh { color: #ffd900 } /* Literal.Number.Hex */ +html[data-theme="dark"] .highlight .mi { color: #ffd900 } /* Literal.Number.Integer */ +html[data-theme="dark"] .highlight .mo { color: #ffd900 } /* Literal.Number.Oct */ +html[data-theme="dark"] .highlight .sa { color: #abe338 } /* Literal.String.Affix */ +html[data-theme="dark"] .highlight .sb { color: #abe338 } /* Literal.String.Backtick */ +html[data-theme="dark"] .highlight .sc { color: #abe338 } /* Literal.String.Char */ +html[data-theme="dark"] .highlight .dl { color: #abe338 } /* Literal.String.Delimiter */ +html[data-theme="dark"] .highlight .sd { color: #abe338 } /* Literal.String.Doc */ +html[data-theme="dark"] .highlight .s2 { color: #abe338 } /* Literal.String.Double */ +html[data-theme="dark"] .highlight .se { color: #abe338 } /* Literal.String.Escape */ +html[data-theme="dark"] .highlight .sh { color: #abe338 } /* Literal.String.Heredoc */ +html[data-theme="dark"] .highlight .si { color: #abe338 } /* Literal.String.Interpol */ +html[data-theme="dark"] .highlight .sx { color: #abe338 } /* Literal.String.Other */ +html[data-theme="dark"] .highlight .sr { color: #ffa07a } /* Literal.String.Regex */ +html[data-theme="dark"] .highlight .s1 { color: #abe338 } /* Literal.String.Single */ +html[data-theme="dark"] .highlight .ss { color: #00e0e0 } /* Literal.String.Symbol */ +html[data-theme="dark"] .highlight .bp { color: #ffd900 } /* Name.Builtin.Pseudo */ +html[data-theme="dark"] .highlight .fm { color: #00e0e0 } /* Name.Function.Magic */ +html[data-theme="dark"] .highlight .vc { color: #ffa07a } /* Name.Variable.Class */ +html[data-theme="dark"] .highlight .vg { color: #ffa07a } /* Name.Variable.Global */ +html[data-theme="dark"] .highlight .vi { color: #ffa07a } /* Name.Variable.Instance */ +html[data-theme="dark"] .highlight .vm { color: #ffd900 } /* Name.Variable.Magic */ +html[data-theme="dark"] .highlight .il { color: #ffd900 } /* Literal.Number.Integer.Long */ \ No newline at end of file diff --git a/_static/scripts/bootstrap.js b/_static/scripts/bootstrap.js new file mode 100644 index 00000000..ef07e0bc --- /dev/null +++ b/_static/scripts/bootstrap.js @@ -0,0 +1,3 @@ +/*! For license information please see bootstrap.js.LICENSE.txt */ +(()=>{"use strict";var t={d:(e,i)=>{for(var n in i)t.o(i,n)&&!t.o(e,n)&&Object.defineProperty(e,n,{enumerable:!0,get:i[n]})},o:(t,e)=>Object.prototype.hasOwnProperty.call(t,e),r:t=>{"undefined"!=typeof Symbol&&Symbol.toStringTag&&Object.defineProperty(t,Symbol.toStringTag,{value:"Module"}),Object.defineProperty(t,"__esModule",{value:!0})}},e={};t.r(e),t.d(e,{afterMain:()=>w,afterRead:()=>b,afterWrite:()=>C,applyStyles:()=>$,arrow:()=>G,auto:()=>r,basePlacements:()=>a,beforeMain:()=>v,beforeRead:()=>m,beforeWrite:()=>A,bottom:()=>n,clippingParents:()=>h,computeStyles:()=>et,createPopper:()=>Dt,createPopperBase:()=>Lt,createPopperLite:()=>$t,detectOverflow:()=>mt,end:()=>c,eventListeners:()=>nt,flip:()=>_t,hide:()=>yt,left:()=>o,main:()=>y,modifierPhases:()=>T,offset:()=>wt,placements:()=>g,popper:()=>u,popperGenerator:()=>kt,popperOffsets:()=>At,preventOverflow:()=>Et,read:()=>_,reference:()=>f,right:()=>s,start:()=>l,top:()=>i,variationPlacements:()=>p,viewport:()=>d,write:()=>E});var i="top",n="bottom",s="right",o="left",r="auto",a=[i,n,s,o],l="start",c="end",h="clippingParents",d="viewport",u="popper",f="reference",p=a.reduce((function(t,e){return t.concat([e+"-"+l,e+"-"+c])}),[]),g=[].concat(a,[r]).reduce((function(t,e){return t.concat([e,e+"-"+l,e+"-"+c])}),[]),m="beforeRead",_="read",b="afterRead",v="beforeMain",y="main",w="afterMain",A="beforeWrite",E="write",C="afterWrite",T=[m,_,b,v,y,w,A,E,C];function O(t){return t?(t.nodeName||"").toLowerCase():null}function x(t){if(null==t)return window;if("[object Window]"!==t.toString()){var e=t.ownerDocument;return e&&e.defaultView||window}return t}function k(t){return t instanceof x(t).Element||t instanceof Element}function L(t){return t instanceof x(t).HTMLElement||t instanceof HTMLElement}function D(t){return"undefined"!=typeof ShadowRoot&&(t instanceof x(t).ShadowRoot||t instanceof ShadowRoot)}const $={name:"applyStyles",enabled:!0,phase:"write",fn:function(t){var e=t.state;Object.keys(e.elements).forEach((function(t){var i=e.styles[t]||{},n=e.attributes[t]||{},s=e.elements[t];L(s)&&O(s)&&(Object.assign(s.style,i),Object.keys(n).forEach((function(t){var e=n[t];!1===e?s.removeAttribute(t):s.setAttribute(t,!0===e?"":e)})))}))},effect:function(t){var e=t.state,i={popper:{position:e.options.strategy,left:"0",top:"0",margin:"0"},arrow:{position:"absolute"},reference:{}};return Object.assign(e.elements.popper.style,i.popper),e.styles=i,e.elements.arrow&&Object.assign(e.elements.arrow.style,i.arrow),function(){Object.keys(e.elements).forEach((function(t){var n=e.elements[t],s=e.attributes[t]||{},o=Object.keys(e.styles.hasOwnProperty(t)?e.styles[t]:i[t]).reduce((function(t,e){return t[e]="",t}),{});L(n)&&O(n)&&(Object.assign(n.style,o),Object.keys(s).forEach((function(t){n.removeAttribute(t)})))}))}},requires:["computeStyles"]};function S(t){return t.split("-")[0]}var I=Math.max,N=Math.min,P=Math.round;function j(){var t=navigator.userAgentData;return null!=t&&t.brands&&Array.isArray(t.brands)?t.brands.map((function(t){return t.brand+"/"+t.version})).join(" "):navigator.userAgent}function M(){return!/^((?!chrome|android).)*safari/i.test(j())}function H(t,e,i){void 0===e&&(e=!1),void 0===i&&(i=!1);var n=t.getBoundingClientRect(),s=1,o=1;e&&L(t)&&(s=t.offsetWidth>0&&P(n.width)/t.offsetWidth||1,o=t.offsetHeight>0&&P(n.height)/t.offsetHeight||1);var r=(k(t)?x(t):window).visualViewport,a=!M()&&i,l=(n.left+(a&&r?r.offsetLeft:0))/s,c=(n.top+(a&&r?r.offsetTop:0))/o,h=n.width/s,d=n.height/o;return{width:h,height:d,top:c,right:l+h,bottom:c+d,left:l,x:l,y:c}}function B(t){var e=H(t),i=t.offsetWidth,n=t.offsetHeight;return Math.abs(e.width-i)<=1&&(i=e.width),Math.abs(e.height-n)<=1&&(n=e.height),{x:t.offsetLeft,y:t.offsetTop,width:i,height:n}}function W(t,e){var i=e.getRootNode&&e.getRootNode();if(t.contains(e))return!0;if(i&&D(i)){var n=e;do{if(n&&t.isSameNode(n))return!0;n=n.parentNode||n.host}while(n)}return!1}function F(t){return x(t).getComputedStyle(t)}function z(t){return["table","td","th"].indexOf(O(t))>=0}function q(t){return((k(t)?t.ownerDocument:t.document)||window.document).documentElement}function R(t){return"html"===O(t)?t:t.assignedSlot||t.parentNode||(D(t)?t.host:null)||q(t)}function V(t){return L(t)&&"fixed"!==F(t).position?t.offsetParent:null}function Y(t){for(var e=x(t),i=V(t);i&&z(i)&&"static"===F(i).position;)i=V(i);return i&&("html"===O(i)||"body"===O(i)&&"static"===F(i).position)?e:i||function(t){var e=/firefox/i.test(j());if(/Trident/i.test(j())&&L(t)&&"fixed"===F(t).position)return null;var i=R(t);for(D(i)&&(i=i.host);L(i)&&["html","body"].indexOf(O(i))<0;){var n=F(i);if("none"!==n.transform||"none"!==n.perspective||"paint"===n.contain||-1!==["transform","perspective"].indexOf(n.willChange)||e&&"filter"===n.willChange||e&&n.filter&&"none"!==n.filter)return i;i=i.parentNode}return null}(t)||e}function K(t){return["top","bottom"].indexOf(t)>=0?"x":"y"}function Q(t,e,i){return I(t,N(e,i))}function X(t){return Object.assign({},{top:0,right:0,bottom:0,left:0},t)}function U(t,e){return e.reduce((function(e,i){return e[i]=t,e}),{})}const G={name:"arrow",enabled:!0,phase:"main",fn:function(t){var e,r=t.state,l=t.name,c=t.options,h=r.elements.arrow,d=r.modifiersData.popperOffsets,u=S(r.placement),f=K(u),p=[o,s].indexOf(u)>=0?"height":"width";if(h&&d){var g=function(t,e){return X("number"!=typeof(t="function"==typeof t?t(Object.assign({},e.rects,{placement:e.placement})):t)?t:U(t,a))}(c.padding,r),m=B(h),_="y"===f?i:o,b="y"===f?n:s,v=r.rects.reference[p]+r.rects.reference[f]-d[f]-r.rects.popper[p],y=d[f]-r.rects.reference[f],w=Y(h),A=w?"y"===f?w.clientHeight||0:w.clientWidth||0:0,E=v/2-y/2,C=g[_],T=A-m[p]-g[b],O=A/2-m[p]/2+E,x=Q(C,O,T),k=f;r.modifiersData[l]=((e={})[k]=x,e.centerOffset=x-O,e)}},effect:function(t){var e=t.state,i=t.options.element,n=void 0===i?"[data-popper-arrow]":i;null!=n&&("string"!=typeof n||(n=e.elements.popper.querySelector(n)))&&W(e.elements.popper,n)&&(e.elements.arrow=n)},requires:["popperOffsets"],requiresIfExists:["preventOverflow"]};function J(t){return t.split("-")[1]}var Z={top:"auto",right:"auto",bottom:"auto",left:"auto"};function tt(t){var e,r=t.popper,a=t.popperRect,l=t.placement,h=t.variation,d=t.offsets,u=t.position,f=t.gpuAcceleration,p=t.adaptive,g=t.roundOffsets,m=t.isFixed,_=d.x,b=void 0===_?0:_,v=d.y,y=void 0===v?0:v,w="function"==typeof g?g({x:b,y}):{x:b,y};b=w.x,y=w.y;var A=d.hasOwnProperty("x"),E=d.hasOwnProperty("y"),C=o,T=i,O=window;if(p){var k=Y(r),L="clientHeight",D="clientWidth";k===x(r)&&"static"!==F(k=q(r)).position&&"absolute"===u&&(L="scrollHeight",D="scrollWidth"),(l===i||(l===o||l===s)&&h===c)&&(T=n,y-=(m&&k===O&&O.visualViewport?O.visualViewport.height:k[L])-a.height,y*=f?1:-1),l!==o&&(l!==i&&l!==n||h!==c)||(C=s,b-=(m&&k===O&&O.visualViewport?O.visualViewport.width:k[D])-a.width,b*=f?1:-1)}var $,S=Object.assign({position:u},p&&Z),I=!0===g?function(t,e){var i=t.x,n=t.y,s=e.devicePixelRatio||1;return{x:P(i*s)/s||0,y:P(n*s)/s||0}}({x:b,y},x(r)):{x:b,y};return b=I.x,y=I.y,f?Object.assign({},S,(($={})[T]=E?"0":"",$[C]=A?"0":"",$.transform=(O.devicePixelRatio||1)<=1?"translate("+b+"px, "+y+"px)":"translate3d("+b+"px, "+y+"px, 0)",$)):Object.assign({},S,((e={})[T]=E?y+"px":"",e[C]=A?b+"px":"",e.transform="",e))}const et={name:"computeStyles",enabled:!0,phase:"beforeWrite",fn:function(t){var e=t.state,i=t.options,n=i.gpuAcceleration,s=void 0===n||n,o=i.adaptive,r=void 0===o||o,a=i.roundOffsets,l=void 0===a||a,c={placement:S(e.placement),variation:J(e.placement),popper:e.elements.popper,popperRect:e.rects.popper,gpuAcceleration:s,isFixed:"fixed"===e.options.strategy};null!=e.modifiersData.popperOffsets&&(e.styles.popper=Object.assign({},e.styles.popper,tt(Object.assign({},c,{offsets:e.modifiersData.popperOffsets,position:e.options.strategy,adaptive:r,roundOffsets:l})))),null!=e.modifiersData.arrow&&(e.styles.arrow=Object.assign({},e.styles.arrow,tt(Object.assign({},c,{offsets:e.modifiersData.arrow,position:"absolute",adaptive:!1,roundOffsets:l})))),e.attributes.popper=Object.assign({},e.attributes.popper,{"data-popper-placement":e.placement})},data:{}};var it={passive:!0};const nt={name:"eventListeners",enabled:!0,phase:"write",fn:function(){},effect:function(t){var e=t.state,i=t.instance,n=t.options,s=n.scroll,o=void 0===s||s,r=n.resize,a=void 0===r||r,l=x(e.elements.popper),c=[].concat(e.scrollParents.reference,e.scrollParents.popper);return o&&c.forEach((function(t){t.addEventListener("scroll",i.update,it)})),a&&l.addEventListener("resize",i.update,it),function(){o&&c.forEach((function(t){t.removeEventListener("scroll",i.update,it)})),a&&l.removeEventListener("resize",i.update,it)}},data:{}};var st={left:"right",right:"left",bottom:"top",top:"bottom"};function ot(t){return t.replace(/left|right|bottom|top/g,(function(t){return st[t]}))}var rt={start:"end",end:"start"};function at(t){return t.replace(/start|end/g,(function(t){return rt[t]}))}function lt(t){var e=x(t);return{scrollLeft:e.pageXOffset,scrollTop:e.pageYOffset}}function ct(t){return H(q(t)).left+lt(t).scrollLeft}function ht(t){var e=F(t),i=e.overflow,n=e.overflowX,s=e.overflowY;return/auto|scroll|overlay|hidden/.test(i+s+n)}function dt(t){return["html","body","#document"].indexOf(O(t))>=0?t.ownerDocument.body:L(t)&&ht(t)?t:dt(R(t))}function ut(t,e){var i;void 0===e&&(e=[]);var n=dt(t),s=n===(null==(i=t.ownerDocument)?void 0:i.body),o=x(n),r=s?[o].concat(o.visualViewport||[],ht(n)?n:[]):n,a=e.concat(r);return s?a:a.concat(ut(R(r)))}function ft(t){return Object.assign({},t,{left:t.x,top:t.y,right:t.x+t.width,bottom:t.y+t.height})}function pt(t,e,i){return e===d?ft(function(t,e){var i=x(t),n=q(t),s=i.visualViewport,o=n.clientWidth,r=n.clientHeight,a=0,l=0;if(s){o=s.width,r=s.height;var c=M();(c||!c&&"fixed"===e)&&(a=s.offsetLeft,l=s.offsetTop)}return{width:o,height:r,x:a+ct(t),y:l}}(t,i)):k(e)?function(t,e){var i=H(t,!1,"fixed"===e);return i.top=i.top+t.clientTop,i.left=i.left+t.clientLeft,i.bottom=i.top+t.clientHeight,i.right=i.left+t.clientWidth,i.width=t.clientWidth,i.height=t.clientHeight,i.x=i.left,i.y=i.top,i}(e,i):ft(function(t){var e,i=q(t),n=lt(t),s=null==(e=t.ownerDocument)?void 0:e.body,o=I(i.scrollWidth,i.clientWidth,s?s.scrollWidth:0,s?s.clientWidth:0),r=I(i.scrollHeight,i.clientHeight,s?s.scrollHeight:0,s?s.clientHeight:0),a=-n.scrollLeft+ct(t),l=-n.scrollTop;return"rtl"===F(s||i).direction&&(a+=I(i.clientWidth,s?s.clientWidth:0)-o),{width:o,height:r,x:a,y:l}}(q(t)))}function gt(t){var e,r=t.reference,a=t.element,h=t.placement,d=h?S(h):null,u=h?J(h):null,f=r.x+r.width/2-a.width/2,p=r.y+r.height/2-a.height/2;switch(d){case i:e={x:f,y:r.y-a.height};break;case n:e={x:f,y:r.y+r.height};break;case s:e={x:r.x+r.width,y:p};break;case o:e={x:r.x-a.width,y:p};break;default:e={x:r.x,y:r.y}}var g=d?K(d):null;if(null!=g){var m="y"===g?"height":"width";switch(u){case l:e[g]=e[g]-(r[m]/2-a[m]/2);break;case c:e[g]=e[g]+(r[m]/2-a[m]/2)}}return e}function mt(t,e){void 0===e&&(e={});var o=e,r=o.placement,l=void 0===r?t.placement:r,c=o.strategy,p=void 0===c?t.strategy:c,g=o.boundary,m=void 0===g?h:g,_=o.rootBoundary,b=void 0===_?d:_,v=o.elementContext,y=void 0===v?u:v,w=o.altBoundary,A=void 0!==w&&w,E=o.padding,C=void 0===E?0:E,T=X("number"!=typeof C?C:U(C,a)),x=y===u?f:u,D=t.rects.popper,$=t.elements[A?x:y],S=function(t,e,i,n){var s="clippingParents"===e?function(t){var e=ut(R(t)),i=["absolute","fixed"].indexOf(F(t).position)>=0&&L(t)?Y(t):t;return k(i)?e.filter((function(t){return k(t)&&W(t,i)&&"body"!==O(t)})):[]}(t):[].concat(e),o=[].concat(s,[i]),r=o[0],a=o.reduce((function(e,i){var s=pt(t,i,n);return e.top=I(s.top,e.top),e.right=N(s.right,e.right),e.bottom=N(s.bottom,e.bottom),e.left=I(s.left,e.left),e}),pt(t,r,n));return a.width=a.right-a.left,a.height=a.bottom-a.top,a.x=a.left,a.y=a.top,a}(k($)?$:$.contextElement||q(t.elements.popper),m,b,p),P=H(t.elements.reference),j=gt({reference:P,element:D,strategy:"absolute",placement:l}),M=ft(Object.assign({},D,j)),B=y===u?M:P,z={top:S.top-B.top+T.top,bottom:B.bottom-S.bottom+T.bottom,left:S.left-B.left+T.left,right:B.right-S.right+T.right},V=t.modifiersData.offset;if(y===u&&V){var K=V[l];Object.keys(z).forEach((function(t){var e=[s,n].indexOf(t)>=0?1:-1,o=[i,n].indexOf(t)>=0?"y":"x";z[t]+=K[o]*e}))}return z}const _t={name:"flip",enabled:!0,phase:"main",fn:function(t){var e=t.state,c=t.options,h=t.name;if(!e.modifiersData[h]._skip){for(var d=c.mainAxis,u=void 0===d||d,f=c.altAxis,m=void 0===f||f,_=c.fallbackPlacements,b=c.padding,v=c.boundary,y=c.rootBoundary,w=c.altBoundary,A=c.flipVariations,E=void 0===A||A,C=c.allowedAutoPlacements,T=e.options.placement,O=S(T),x=_||(O!==T&&E?function(t){if(S(t)===r)return[];var e=ot(t);return[at(t),e,at(e)]}(T):[ot(T)]),k=[T].concat(x).reduce((function(t,i){return t.concat(S(i)===r?function(t,e){void 0===e&&(e={});var i=e,n=i.placement,s=i.boundary,o=i.rootBoundary,r=i.padding,l=i.flipVariations,c=i.allowedAutoPlacements,h=void 0===c?g:c,d=J(n),u=d?l?p:p.filter((function(t){return J(t)===d})):a,f=u.filter((function(t){return h.indexOf(t)>=0}));0===f.length&&(f=u);var m=f.reduce((function(e,i){return e[i]=mt(t,{placement:i,boundary:s,rootBoundary:o,padding:r})[S(i)],e}),{});return Object.keys(m).sort((function(t,e){return m[t]-m[e]}))}(e,{placement:i,boundary:v,rootBoundary:y,padding:b,flipVariations:E,allowedAutoPlacements:C}):i)}),[]),L=e.rects.reference,D=e.rects.popper,$=new Map,I=!0,N=k[0],P=0;P