Circuit

class ansys.aedt.core.circuit.Circuit(project=None, design=None, solution_type=None, setup=None, version=None, non_graphical=False, new_desktop=False, close_on_exit=False, student_version=False, machine='', port=0, aedt_process_id=None, remove_lock=False)

Provides the Circuit application interface.

Parameters:

projectstr, optional

Name of the project to select or the full path to the project or AEDTZ archive to open. The default is None, in which case an attempt is made to get an active project. If no projects are present, an empty project is created.

designstr, optional

Name of the design to select. The default is None, in which case an attempt is made to get an active design. If no designs are present, an empty design is created.

solution_typestr, optional

Solution type to apply to the design. The default is None, in which case the default type is applied.

setupstr, optional

Name of the setup to use as the nominal. The default is None, in which case the active setup is used or nothing is used.

versionstr, int, float, optional

Version of AEDT to use. The default is None, in which case the active version or latest installed version is used. This parameter is ignored when Script is launched within AEDT. Examples of input values are 232, 23.2,``2023.2``,``”2023.2”``.

non_graphicalbool, optional

Whether to run AEDT in non-graphical mode. The default is False, in which case AEDT is launched in graphical mode. This parameter is ignored when a script is launched within AEDT.

new_desktopbool, optional

Whether to launch an instance of AEDT in a new thread, even if another instance of the specified_version is active on the machine. The default is False. This parameter is ignored when a script is launched within AEDT.

close_on_exitbool, optional

Whether to release AEDT on exit. The default is False.

student_versionbool, optional

Whether to open the AEDT student version. The default is False. This parameter is ignored when Script is launched within AEDT.

machinestr, optional

Machine name to which connect the oDesktop Session. Works only in 2022 R2 or later. The remote server must be up and running with the command “ansysedt.exe -grpcsrv portnum”. If a machine is “localhost”, the server also starts if not present.

portint, optional

Port number on which to start the oDesktop communication on an already existing server. This parameter is ignored when creating a new server. It works only in 2022 R2 or later. The remote server must be up and running with the command “ansysedt.exe -grpcsrv portnum”.

aedt_process_idint, optional

Process ID for the instance of AEDT to point PyAEDT at. The default is None. This parameter is only used when new_desktop = False.

remove_lockbool, optional

Whether to remove lock to project before opening it or not. The default is False, which means to not unlock the existing project if needed and raise an exception.

Examples

Create an instance of Circuit and connect to an existing Circuit design or create a new Circuit design if one does not exist.

>>> from ansys.aedt.core import Circuit
>>> aedtapp = Circuit()

Create an instance of Circuit and link to a project named "projectname". If this project does not exist, create one with this name.

>>> aedtapp = Circuit(projectname)

Create an instance of Circuit and link to a design named "designname" in a project named "projectname".

>>> aedtapp = Circuit(projectname,designame)

Create an instance of Circuit and open the specified project, which is "myfie.aedt".

>>> aedtapp = Circuit("myfile.aedt")

Create an instance of Circuit using the 2023 R2 version and open the specified project, which is "myfile.aedt".

>>> aedtapp = Circuit(version=2023.2, project="myfile.aedt")

Create an instance of Circuit using the 2023 R2 student version and open the specified project, which is named "myfile.aedt".

>>> aedtapp = Circuit(version="2023.2", project="myfile.aedt", student_version=True)

Methods

Circuit.activate_variable_optimization(name)	Activate optimization analysis for a variable and optionally set up ranges.
Circuit.activate_variable_sensitivity(name)	Activate sensitivity analysis for a variable and optionally set up ranges.
Circuit.activate_variable_statistical(name)	Activate statitistical analysis for a variable and optionally set up ranges.
Circuit.activate_variable_tuning(name[, ...])	Activate tuning analysis for a variable and optionally set up ranges.
Circuit.add_error_message(text[, level])	Add a type 0 "Error" message to either the global, active project, or active design level of the message mmanager tree.
Circuit.add_from_toolkit(toolkit[, draw])	Add a new toolkit to the current application.
Circuit.add_info_message(text[, level])	Add a type 0 "Info" message to either the global, active project, or active design level of the message manager tree.
Circuit.add_netlist_datablock(input_file[, name])	Add a new netlist data block to the circuit schematic.
Circuit.add_warning_message(text[, level])	Add a type 0 "Warning" message to either the global, active project, or active design level of the message manager tree.
Circuit.analyze([setup, cores, tasks, gpus, ...])	Solve the active design.
Circuit.analyze_setup([name, cores, tasks, ...])	Analyze a design setup.
Circuit.archive_project([project_path, ...])	Archive the AEDT project and add a message.
Circuit.assign_current_sinusoidal_excitation_to_ports(ports)	Assign a current sinusoidal excitation to circuit ports.
Circuit.assign_power_sinusoidal_excitation_to_ports(ports)	Assign a power sinusoidal excitation to circuit ports.
Circuit.assign_voltage_frequency_dependent_excitation_to_ports(...)	Assign a frequency dependent excitation to circuit ports from a frequency dependent source (FDS format).
Circuit.assign_voltage_sinusoidal_excitation_to_ports(ports)	Assign a voltage sinusoidal excitation to circuit ports.
Circuit.autosave_disable()	Disable autosave in AEDT.
Circuit.autosave_enable()	Enable autosave in AEDT.
Circuit.browse_log_file([input_file])	Save the most recent log file in a new directory.
Circuit.change_automatically_use_causal_materials([...])	Enable or disable the automatic use of causal materials for lossy dielectrics.
Circuit.change_design_settings(settings)	Set Design Settings.
Circuit.change_material_override([...])	Enable or disable the material override in the project.
Circuit.change_property(aedt_object, ...)	Change a property.
Circuit.change_validation_settings([...])	Update the validation design settings.
Circuit.check_beta_option_enabled(beta_option)	Check if a beta option is enabled.
Circuit.check_if_project_is_loaded(input_file)	Check if a project path is already loaded in active Desktop.
Circuit.clean_proj_folder([directory, name])	Delete a project folder.
Circuit.close_desktop()	Close AEDT and release it.
Circuit.close_project([name, save])	Close an AEDT project.
Circuit.connect_circuit_models_from_multi_zone_cutout(...)	Connect circuit model from a multizone clipped project.
Circuit.copy_design_from(project, design[, ...])	Copy a design from a project into the active project.
Circuit.copy_project(destination, name)	Copy the project to another destination.
Circuit.create_ami_schematic_from_snp(...[, ...])	Create a schematic from a Touchstone file and automatically set up an IBIS-AMI analysis.
Circuit.create_dataset(name, x, y[, z, v, ...])	Create a dataset.
Circuit.create_dataset1d_design(name, x, y)	Create a design dataset.
Circuit.create_dataset1d_project(name, x, y)	Create a project dataset.
Circuit.create_dataset3d(name, x, y[, z, v, ...])	Create a 3D dataset.
Circuit.create_ibis_schematic_from_pins(...)	Create a schematic from a list of pins and automatically set up an IBIS-AMI analysis.
Circuit.create_ibis_schematic_from_snp(...)	Create a schematic from a Touchstone file and automatically set up an IBIS-AMI analysis.
Circuit.create_lna_schematic_from_snp(input_file)	Create a schematic from a Touchstone file and automatically set up an LNA analysis.
Circuit.create_new_project(name)	Create a project within AEDT.
Circuit.create_output_variable(variable, ...)	Create or modify an output variable.
Circuit.create_schematic_from_asc_file(...)	Import an asc schematic and convert to Circuit Schematic.
Circuit.create_schematic_from_mentor_netlist(...)	Create a circuit schematic from a Mentor netlist.
Circuit.create_schematic_from_netlist(input_file)	Create a circuit schematic from an HSpice netlist.
Circuit.create_setup([name, setup_type])	Create a setup.
Circuit.create_source(source_type[, name])	Create a source in Circuit.
Circuit.create_tdr_schematic_from_snp(...[, ...])	Create a schematic from a Touchstone file and automatically setup a TDR transient analysis.
Circuit.create_touchstone_report(name, curves)	Create a Touchstone plot.
Circuit.dataset_exists(name[, ...])	Check if a dataset exists.
Circuit.deactivate_variable_optimization(name)	Deactivate the optimization analysis for a variable.
Circuit.deactivate_variable_sensitivity(name)	Deactivate the sensitivity analysis for a variable.
Circuit.deactivate_variable_statistical(name)	Deactivate the statistical analysis for a variable.
Circuit.deactivate_variable_tuning(name)	Deactivate the tuning analysis for a variable.
Circuit.delete_design([name, fallback_design])	Delete a design from the current project.
Circuit.delete_project(name)	Delete a project.
Circuit.delete_separator(name)	Delete a separator from either the active project or a design.
Circuit.delete_setup(name)	Delete a setup.
Circuit.delete_unused_variables()	Delete design and project unused variables.
Circuit.delete_variable(name)	Delete a variable.
Circuit.design_variation([variation])	Generate a string to specify a desired variation.
Circuit.duplicate_design(name[, ...])	Copy a design to a new name.
Circuit.edit_notes(text)	Edit notes.
Circuit.edit_setup(name, properties)	Modify a setup.
Circuit.evaluate_expression(expression)	Evaluate a valid string expression and return the numerical value in SI units.
Circuit.export_convergence(setup[, ...])	Export a solution convergence to a file.
Circuit.export_design_preview_to_jpg(output_file)	Export design preview image to a JPG file.
Circuit.export_fullwave_spice([design, ...])	Export a full wave HSpice file using NDE.
Circuit.export_parametric_results(sweep, ...)	Export a list of all parametric variations solved for a sweep to a CSV file.
Circuit.export_profile(setup[, variation, ...])	Export a solution profile to a PROF file.
Circuit.export_results([analyze, ...])	Export all available reports to a file, including profile, and convergence and sNp when applicable.
Circuit.export_rl_matrix(matrix_name, ...[, ...])	Export R/L matrix after solving.
Circuit.export_touchstone([setup, sweep, ...])	Export a Touchstone file.
Circuit.export_variables_to_csv(output_file)	Export design properties, project variables, or both to a CSV file.
Circuit.generate_temp_project_directory(name)	Generate a unique directory string to save a project to.
Circuit.generate_unique_setup_name([name])	Generate a new setup with a unique name.
Circuit.get_all_insertion_loss_list([...])	Get a list of all insertion losses from two lists of excitations (driver and receiver).
Circuit.get_all_return_loss_list([...])	Get a list of all return losses for a list of excitations.
Circuit.get_evaluated_value(name[, units])	Retrieve the evaluated value of a design property or project variable in SI units if no unit is provided.
Circuit.get_fext_xtalk_list([drivers, ...])	Geta list of all the far end XTalks from two lists of excitations (driver and receiver).
Circuit.get_ibis_model_from_file(input_file)	Create an IBIS model based on the data contained in an IBIS file.
Circuit.get_module(module_name)	Aedt Module object.
Circuit.get_monitor_data()	Check and get monitor data of an existing analysis.
Circuit.get_next_xtalk_list([drivers, ...])	Get a list of all the near end XTalks from a list of excitations (driver and receiver).
Circuit.get_nominal_variation([with_values])	Retrieve the nominal variation.
Circuit.get_object_material_properties([...])	Retrieve the material properties for a list of objects and return them in a dictionary.
Circuit.get_oo_name(aedt_object[, object_name])	Return the object-oriented AEDT property names.
Circuit.get_oo_object(aedt_object, object_name)	Return the Object Oriented AEDT Object.
Circuit.get_oo_properties(aedt_object, ...)	Return the Object Oriented AEDT Object Properties.
Circuit.get_oo_property_value(aedt_object, ...)	Return the Object Oriented AEDT Object Properties.
Circuit.get_output_variable(variable[, solution])	Retrieve the value of the output variable.
Circuit.get_profile([name])	Get profile information.
Circuit.get_registry_key_int(name)	Get the value for the AEDT registry key if one exists.
Circuit.get_registry_key_string(name)	Get the value for the AEDT registry key if one exists.
Circuit.get_setup(name)	Retrieve the setup from the current design.
Circuit.get_setups()	Retrieve setups.
Circuit.get_source_pin_names(source_design_name)	Retrieve pin names.
Circuit.get_sweeps(name)	Retrieve all sweeps for a setup.
Circuit.get_touchstone_data([setup, sweep, ...])	Return a Touchstone data plot.
Circuit.get_traces_for_plot([...])	Retrieve a list of traces of specified designs ready to use in plot reports.
Circuit.hidden_variable(name[, value])	Set the variable to a hidden or unhidden variable.
Circuit.import_dataset1d(input_file[, name, ...])	Import a 1D dataset.
Circuit.import_dataset3d(input_file[, name, ...])	Import a 3D dataset.
Circuit.import_edb_in_circuit(input_dir)	Import an EDB design inside a Circuit project.
Circuit.import_touchstone_solution(input_file)	Import a Touchstone file as the solution.
Circuit.insert_design([name, solution_type])	Add a design of a specified type.
Circuit.list_of_variations([setup, sweep])	Retrieve a list of active variations for input setup.
Circuit.load_diff_pairs_from_file(input_file)	Load differtential pairs definition from a file.
Circuit.load_project(file_name[, design, ...])	Open an AEDT project based on a project and optional design.
Circuit.number_with_units(value[, units])	Convert a number to a string with units.
Circuit.pop_up()	Pop-up to parent Circuit design and reinitialize Circuit object.
Circuit.push_down(component)	Push-down to the child component and reinitialize the Circuit object.
Circuit.push_excitations(instance[, ...])	Push excitations for a linear frequency setup.
Circuit.push_time_excitations(instance[, ...])	Push excitations for a transient setup.
Circuit.read_design_data()	Read back the design data as a dictionary.
Circuit.read_only_variable(name[, value])	Set the variable to a read-only or not read-only variable.
Circuit.release_desktop([close_projects, ...])	Release AEDT.
Circuit.remove_all_unused_definitions()	Remove all unused definitions in the project.
Circuit.rename_design(name[, save])	Rename the active design.
Circuit.retrieve_mentor_comp(reference_id)	Retrieve the type of the Mentor netlist component for a given reference ID.
Circuit.save_diff_pairs_to_file(output_file)	Save differential pairs definition to a file.
Circuit.save_project([file_name, overwrite, ...])	Save the project and add a message.
Circuit.set_active_design(name)	Change the active design to another design.
Circuit.set_active_dso_config_name([...])	Change a specific registry key to a new value.
Circuit.set_differential_pair(assignment, ...)	Add a differential pair definition.
Circuit.set_license_type([license_type])	Change the license type between "Pack" and "Pool".
Circuit.set_oo_property_value(aedt_object, ...)	Change the property value of the object-oriented AEDT object.
Circuit.set_registry_from_file(registry_file)	Apply desktop registry settings from an ACT file.
Circuit.set_registry_key(name, value)	Change a specific registry key to a new value.
Circuit.set_temporary_directory(path)	Set temporary directory path.
Circuit.solve_in_batch([file_name, machine, ...])	Analyze a design setup in batch mode.
Circuit.stop_simulations([clean_stop])	Check if there are simulation running and stops them.
Circuit.submit_job(cluster_name[, ...])	Submit a job to be solved on a cluster.
Circuit.validate_simple([log_file])	Validate a design.
Circuit.value_with_units(value[, units, ...])	Combine a number and a string containing the modeler length unit in a single string e.g. "1.2mm".

Attributes

Circuit.Position	Position of the object.
Circuit.SimulationSetupTypes	Simulation setup types.
Circuit.SolutionTypes	Solution types.
Circuit.active_setup	Get or Set the name of the active setup.
Circuit.aedt_version_id	AEDT version.
Circuit.are_there_simulations_running	Check if there are simulation running.
Circuit.available_variations	Available variation object.
Circuit.boundaries	Design boundaries and excitations.
Circuit.boundaries_by_type	Design boundaries by type.
Circuit.default_solution_type	Default solution type.
Circuit.design_datasets	Dictionary of Design Datasets.
Circuit.design_list	Design list.
Circuit.design_name	Design name.
Circuit.design_properties	Design properties.
Circuit.design_type	Design type.
Circuit.desktop_class	Desktop class.
Circuit.desktop_install_dir	AEDT installation directory.
Circuit.excitation_objects	List of port objects.
Circuit.excitations	List of port names.
Circuit.excitations_by_type	Design excitations by type.
Circuit.existing_analysis_setups	Analysis setups.
Circuit.existing_analysis_sweeps	Analysis setups.
Circuit.get_all_sparameter_list	List of all S parameters for a list of excitations.
Circuit.info	Dictionary of the PyAEDT session information.
Circuit.layouteditor	Return the Circuit Layout Editor.
Circuit.library_list	Library list.
Circuit.lock_file	Lock file.
Circuit.logger	Logger for the design.
Circuit.materials	Materials in the project.
Circuit.modeler	Modeler object.
Circuit.native_component_names	Native component names.
Circuit.native_components	Native Component dictionary.
Circuit.nominal_adaptive	Nominal adaptive sweep.
Circuit.nominal_sweep	Nominal sweep.
Circuit.o_component_manager	Component manager object.
Circuit.o_maxwell_parameters	AEDT Maxwell Parameter Setup Object.
Circuit.o_model_manager	Model manager object.
Circuit.o_symbol_manager	Aedt Symbol Manager.
Circuit.oanalysis	Analysis AEDT Module.
Circuit.oboundary	Boundary Object.
Circuit.odefinition_manager	Definition Manager Module.
Circuit.odesign	Design.
Circuit.odesktop	AEDT instance containing all projects and designs.
Circuit.oeditor	Oeditor Module.
Circuit.oexcitation	Solution Module.
Circuit.ofieldsreporter	Fields reporter.
Circuit.oimport_export	Import/Export Manager Module.
Circuit.omaterial_manager	Material Manager Module.
Circuit.omatrix	Matrix Object.
Circuit.omeshmodule	Icepak Mesh Module.
Circuit.omodelsetup	AEDT Model Setup Object.
Circuit.omonitor	AEDT Monitor Object.
Circuit.ooptimetrics	AEDT Optimetrics Module.
Circuit.ooutput_variable	AEDT Output Variable Module.
Circuit.opadstackmanager	AEDT oPadstackManager.
Circuit.oproject	Project property.
Circuit.optimizations	Optimizations in the project.
Circuit.oradfield	AEDT Radiation Field Object.
Circuit.oreportsetup	Report setup.
Circuit.osolution	Solution Module.
Circuit.output_variables	List of output variables.
Circuit.parametrics	Setups in the project.
Circuit.personallib	PersonalLib directory.
Circuit.ports	Design excitations.
Circuit.post	PostProcessor.
Circuit.project_datasets	Dictionary of project datasets.
Circuit.project_file	Project name and path.
Circuit.project_list	Project list.
Circuit.project_name	Project name.
Circuit.project_path	Project path.
Circuit.project_properties	Project properties.
Circuit.project_time_stamp	Return Project time stamp.
Circuit.project_timestamp_changed	Return a bool if time stamp changed or not.
Circuit.pyaedt_dir	PyAEDT directory.
Circuit.results_directory	Results directory.
Circuit.settings	Settings of the current Python/Pyaedt session.
Circuit.setup_names	Setup names.
Circuit.setups	Setups in the project.
Circuit.solution_type	Solution type.
Circuit.source_names	Get all source names.
Circuit.source_objects	Get all source objects.
Circuit.sources	Get all sources.
Circuit.src_dir	Source directory for Python.
Circuit.syslib	SysLib directory.
Circuit.temp_directory	Path to the temporary directory.
Circuit.toolkit_directory	Path to the toolkit directory.
Circuit.userlib	UserLib directory.
Circuit.valid_design	Valid design.
Circuit.variable_manager	Variable manager for creating and managing project design and postprocessing variables.
Circuit.working_directory	Path to the working directory.