`inpRW._inpFindRefs`¶

Module Contents¶

This module contains functions for finding references to given names or labels in the input file.

The functions here are not really meant to be used by the end-user; the designed entry point is through findItemReferences(). All of the functions in this module are named like the following: “find[Abaquskeywordname]Refs”. [Abaquskeywordname] should be an Abaqus keyword name, with the first word capitalized, no spaces, and all other words lower case. For example, if you wish to find references to a specific *CONNECTOR BEHAVIOR, you would use findConnectorbehaviorRefs. Using findItemReferences() will automatically format the provided keyword name.

These functions are currently somewhat slow. The problem is that they need to search every location in the input file which could reference the desired items. The performance of these functions depends on the number of locations to check far more than the number of items for which to search. For this reason, users should formulate their code so that these functions are called as few times as possible. For example, if the user wishes to search for references to nodes 1-5, they should not call findNodeRefs() 5 times, once for each node label. Rather, they should pass in a sequence or set of node labels. The function will check every possible location if the item in each location is in the input sequence.

There are likely errors in these functions, as they are not fully tested and the Abaqus Keywords Guide is not always clear. This class is also not yet complete; the initial focus was on items that can reference node or elements. Please report any problems or new references that need to be addressed to erik.kane@3ds.com.

These functions work (at least, once all the bugs are found), but they are slow. They will hopefully be eliminated in the future and replaced with an approach that can track references to specific items instead of needing to search for them.

class inpRW._inpFindRefs.FindRefs¶

The FindRefs class contains functions that find references to specific named entities in the parsed input file structure. For example, inp.findNodeRefs([1,2,3]) will find every location in the parsed input file structure which references node labels 1, 2, and 3.

findAdaptivemeshcontrolsRefs(names)¶

findAdaptiveMeshControlsRefs(names)

This function searches for keywords that can reference *ADAPTIVE MESH CONTROLS.

Parameters:

names (list) – A sequence of *ADAPTIVE MESH CONTROLS names.

Returns:

Uses names as the keys, each value will be a list containing the exact location which references: the name and the region of the keyword effected by this reference.

Return type:

findClearanceRefs(names)¶

This function searches for keywords that can reference *CLEARANCE.

Parameters:

names (list) – A sequence of *CLEARANCE names.

Returns:

Uses names as the keys, each value will be a list containing the exact location which references: the name and the region of the keyword effected by this reference.

Return type:

findConnectorbehaviorRefs(names)¶

findConnectorBehaviorRefs(names)

This function searches for keywords that can reference *CONNECTOR BEHAVIOR.

Parameters:

names (list) – A sequence of *CONNECTOR BEHAVIOR names.

Returns:

Uses names as the keys, each value will be a list containing the exact location which references: the name and the region of the keyword effected by this reference.

Return type:

findContactclearanceRefs(names)¶

findContactClearanceRefs(names)

This function searches for keywords that can reference *CONTACT CLEARANCE.

Parameters:

names (list) – A sequence of *CONTACT CLEARANCE names.

Returns:

Uses names as the keys, each value will be a list containing the exact location which references: the name and the region of the keyword effected by this reference.

Return type:

findContactinitializationdataRefs(names)¶

findContactInitializationRefs(names)

This function searches for keywords that can reference *CONTACT INITIALIZATION DATA.

Parameters:

names (list) – A sequence of *CONTACT INITIALIZATION DATA names.

Returns:

Uses names as the keys, each value will be a list containing the exact location which references: the name and the region of the keyword effected by this reference.

Return type:

findContactpairRefs(names)¶

This function searches for keywords that can reference the CPSET parameter of *CONTACT PAIR.

Parameters:

names (list) – A sequence of CPSET names.

Returns:

Uses names as the keys, each value will be a list containing the exact location which references: the name and the region of the keyword effected by this reference.

Return type:

findDistributionRefs(names)¶

This function searches for keywords that can reference *DISTRIBUTION.

Parameters:

names (list) – A sequence of *DISTRIBUTION names.

Returns:

Uses names as the keys, each value will be a list containing the exact location which references: the name and the region of the keyword effected by this reference.

Return type:

findDistributiontableRefs(names)¶

This function searches for keywords that can reference *DISTRIBUTION TABLE.

Parameters:

names (list) – A sequence of *DISTRIBUTION TABLE names.

Returns:

Uses names as the keys, each value will be a list containing the exact location which references: the name and the region of the keyword effected by this reference.

Return type:

findElementprogressiveactivationRefs(names)¶

This function searches for keywords that can reference *ELEMENT PROGRESSIVE ACTIVATION.

Parameters:

names (list) – A sequence of *ELEMENT PROGRESSIVE ACTIVATION names.

Returns:

Uses names as the keys, each value will be a list containing the exact location which references: the name and the region of the keyword effected by this reference.

Return type:

findElementRefs(elements, mode='labels')¶

Finds all references in the input file to each element in elements.

Parameters:

elements (list) – A sequence of element labels or element set names (if mode == ‘set’).
mode (str) – Indicates which type of items for which the function searches. Valid choices: ‘labels’: indicates the function will search for element labels (default) ‘set’: indicates the function will search for element set names.

Returns:

Uses names as the keys, each value will be a list containing the exact location which references: the name and the region of the keyword effected by this reference.

Return type:

findEnrichmentRefs(names)¶

This function searches for keywords that can reference *ENRICHMENT.

Parameters:

names (list) – A sequence of *ENRICHMENT names.

Returns:

Uses names as the keys, each value will be a list containing the exact location which references: the name and the region of the keyword effected by this reference.

Return type:

findFastenerpropertyRefs(names)¶

This function searches for keywords that can reference *FASTENER PROPERTY.

Parameters:

names (list) – A sequence of *FASTENER PROPERTY names.

Returns:

Uses names as the keys, each value will be a list containing the exact location which references: the name and the region of the keyword effected by this reference.

Return type:

findFieldmappercontrolsRefs(names)¶

This function searches for keywords that can reference *FIELD MAPPER CONTROLS.

Parameters:

names (list) – A sequence of *FIELD MAPPER CONTROLS names.

Returns:

Uses names as the keys, each value will be a list containing the exact location which references: the name and the region of the keyword effected by this reference.

Return type:

findFluidbehaviorRefs(names)¶

This function searches for keywords that can reference *FLUID BEHAVIOR.

Parameters:

names (list) – A sequence of *FLUID BEHAVIOR names.

Returns:

Uses names as the keys, each value will be a list containing the exact location which references: the name and the region of the keyword effected by this reference.

Return type:

findGasketbehaviorRefs(names)¶

This function searches for keywords that can reference *GASKET BEHAVIOR.

Parameters:

names (list) – A sequence of *GASKET BEHAVIOR names.

Returns:

Uses names as the keys, each value will be a list containing the exact location which references: the name and the region of the keyword effected by this reference.

Return type:

findImpedancepropertyRefs(names)¶

This function searches for keywords that can reference *IMPEDANCE PROPERTY.

Parameters:

names (list) – A sequence of *IMPEDANCE PROPERTY names.

Returns:

Uses names as the keys, each value will be a list containing the exact location which references: the name and the region of the keyword effected by this reference.

Return type:

findIncidentwaveinteractionpropertyRefs(names)¶

This function searches for keywords that can reference *INCIDENT WAVE INTERACTION PROPERTY.

Parameters:

names (list) – A sequence of *INCIDENT WAVE INTERACTION PROPERTY names.

Returns:

Uses names as the keys, each value will be a list containing the exact location which references: the name and the region of the keyword effected by this reference.

Return type:

findIncidentwavepropertyRefs(names)¶

This function searches for keywords that can reference *INCIDENT WAVE PROPERTY.

Parameters:

names (list) – A sequence of *INCIDENT WAVE PROPERTY names.

Returns:

Uses names as the keys, each value will be a list containing the exact location which references: the name and the region of the keyword effected by this reference.

Return type:

findIntegratedoutputsectionRefs(names)¶

This function searches for keywords that can reference *INTEGRATED OUTPUT SECTION.

Parameters:

names (list) – A sequence of *INTEGRATED OUTPUT SECTION names.

Returns:

Uses names as the keys, each value will be a list containing the exact location which references: the name and the region of the keyword effected by this reference.

Return type:

findNodeRefs(nodes, mode='labels')¶

Finds all references in the input file to each node in nodes.

Parameters:

nodes (list) – A sequence of node labels or node set names (if mode == ‘set’).
mode (str) – Indicates which type of items for which the function searches. Valid choices: ‘labels’: indicates the function will search for node labels (default) ‘set’: indicates the function will search for node set names.

Returns:

Uses names as the keys, each value will be a list containing the exact location which references: the name and the region of the keyword effected by this reference.

Return type:

findOrientationRefs(names)¶

This function searches for keywords that can reference *ORIENTATION.

Parameters:

names (list) – A sequence of *ORIENTATION names.

Returns:

Uses names as the keys, each value will be a list containing the exact location which references: the name and the region of the keyword effected by this reference.

Return type:

findPeriodicmediaRefs(names)¶

This function searches for keywords that can reference *PERIODIC MEDIA.

Parameters:

names (list) – A sequence of *PERIODIC MEDIA names.

Returns:

Uses names as the keys, each value will be a list containing the exact location which references: the name and the region of the keyword effected by this reference.

Return type:

findRebarlayerRefs(names)¶

This function searches for keywords that can reference *REBAR LAYER.

Parameters:

names (list) – A sequence of *REBAR LAYER names.

Returns:

Uses names as the keys, each value will be a list containing the exact location which references: the name and the region of the keyword effected by this reference.

Return type:

findRebarRefs(names)¶

This function searches for keywords that can reference *REBAR.

Parameters:

names (list) – A sequence of *REBAR names.

Returns:

Uses names as the keys, each value will be a list containing the exact location which references: the name and the region of the keyword effected by this reference.

Return type:

findRigidbodyRefs(names)¶

This function searches for keywords that can reference *RIGID BODY.

Parameters:

names (list) – A sequence of *RIGID BODY names.

Returns:

Uses names as the keys, each value will be a list containing the exact location which references: the name and the region of the keyword effected by this reference.

Return type:

findSectioncontrolsRefs(names)¶

This function searches for keywords that can reference *SECTION CONTROLS.

Parameters:

names (list) – A sequence of *SECTION CONTROLS names.

Returns:

Uses names as the keys, each value will be a list containing the exact location which references: the name and the region of the keyword effected by this reference.

Return type:

findSubstructureloadcaseRefs(names)¶

This function searches for keywords that can reference *SUBSTRUCTURE LOADCASE.

Parameters:

names (list) – A sequence of *SUBSTRUCTURE LOADCASE names.

Returns:

Uses names as the keys, each value will be a list containing the exact location which references: the name and the region of the keyword effected by this reference.

Return type:

findSurfaceRefs(names)¶

This function searches for keywords that can reference *SURFACE.

Parameters:

names (list) – A sequence of *SURFACE names.

Returns:

Uses names as the keys, each value will be a list containing the exact location which references: the name and the region of the keyword effected by this reference.

Return type:

findSurfaceinteractionRefs(names)¶

This function searches for keywords that can reference *SURFACE INTERACTION.

Parameters:

names (list) – A sequence of *SURFACE INTERACTION names.

Returns:

Uses names as the keys, each value will be a list containing the exact location which references: the name and the region of the keyword effected by this reference.

Return type:

findSurfacepropertyRefs(names)¶

This function searches for keywords that can reference *SURFACE PROPERTY.

Parameters:

names (list) – A sequence of *SURFACE PROPERTY names.

Returns:

Uses names as the keys, each value will be a list containing the exact location which references: the name and the region of the keyword effected by this reference.

Return type:

findSurfacesmoothingRefs(names)¶

This function searches for keywords that can reference *SURFACE SMOOTHING.

Parameters:

names (list) – A sequence of *SURFACE SMOOTHING names.

Returns:

Uses names as the keys, each value will be a list containing the exact location which references: the name and the region of the keyword effected by this reference.

Return type:

findTracerparticleRefs(names)¶

This function searches for keywords that can reference *TRACER PARTICLE.

Parameters:

names (list) – A sequence of *TRACER PARTICLE names.

Returns:

Uses names as the keys, each value will be a list containing the exact location which references: the name and the region of the keyword effected by this reference.

Return type: