def setattr_fix_value(proxy, pname, value, setter_func):
if pname == "ShaderPreset" and proxy.SMProxy.GetXMLName().endswith(
"Representation"):
if value == "Gaussian Blur (Default)":
if paraview.compatibility.GetVersion() <= 5.5:
paraview.print_warning(\
"The 'Gaussian Blur (Default)' option has been renamed to 'Gaussian Blur'. Please use that instead.")
setter_func(proxy, "Gaussian Blur")
raise Continue()
else:
raise NotSupportedException("'Gaussian Blur (Default)' is an obsolete value for ShaderPreset. "\
" Use 'Gaussian Blur' instead.")
if pname == "FieldAssociation" and proxy.SMProxy.GetXMLName() in [
"DataSetCSVWriter", "CSVWriter"
]:
if paraview.compatibility.GetVersion() < 5.8:
if value == "Points":
value = "Point Data"
elif value == "Cells":
value = "Cell Data"
setter_func(proxy, value)
raise Continue()
else:
raise NotSupportedException("'FieldAssociation' is using an obsolete "\
"value '%s', use `Point Data` or `Cell Data` instead." % value)
raise ValueError("'%s' is not a valid value for %s!" % (value, pname))
def setattr_fix_value(proxy, pname, value, setter_func):
if pname == "ShaderPreset" and proxy.SMProxy.GetXMLName().endswith("Representation"):
if value == "Gaussian Blur (Default)":
if paraview.compatibility.GetVersion() <= 5.5:
paraview.print_warning(\
"The 'Gaussian Blur (Default)' option has been renamed to 'Gaussian Blur'. Please use that instead.")
setter_func(proxy, "Gaussian Blur")
raise Continue()
else:
raise NotSupportedException("'Gaussian Blur (Default)' is an obsolete value for ShaderPreset. "\
" Use 'Gaussian Blur' instead.")
if pname == "FieldAssociation" and proxy.SMProxy.GetXMLName() in ["DataSetCSVWriter", "CSVWriter"]:
if paraview.compatibility.GetVersion() < 5.8:
if value == "Points":
value = "Point Data"
elif value == "Cells":
value = "Cell Data"
setter_func(proxy, value)
raise Continue()
else:
raise NotSupportedException("'FieldAssociation' is using an obsolete "\
"value '%s', use `Point Data` or `Cell Data` instead." % value)
# In 5.9, we changed "High Resolution Line Source" to "Line" and "Point Source" to
# "Point Cloud"
seed_sources_from = ["High Resolution Line Source", "Point Source"]
seed_sources_to = ["Line", "Point Cloud"]
seed_sources_proxyname = ["HighResLineSource", "PointSource"]
if value in seed_sources_from and proxy.GetProperty(pname).SMProperty.IsA("vtkSMInputProperty"):
domain = proxy.GetProperty(pname).SMProperty.FindDomain("vtkSMProxyListDomain")
for i in range(len(seed_sources_to)):
if value == seed_sources_from[i]:
domain_proxy = domain.FindProxy("extended_sources", seed_sources_proxyname[i])
if domain_proxy:
if paraview.compatibility.GetVersion() < 5.9:
value = seed_sources_to[i]
setter_func(proxy, value)
raise Continue()
else:
raise NotSupportedException("%s is an obsolete value. Use %s instead." % (seed_sources_from[i], seed_sources_to[i]))
if (pname == "WindowLocation" and proxy.SMProxy.GetXMLName() in ["TextSourceRepresentation", "ScalarBarWidgetRepresentation"]) or \
(pname == "LabelLocation" and proxy.SMProxy.GetXMLName() == "ChartTextRepresentation"):
# In ParaView 5.10, we changed "WindowsLocation/LabelLocation" values to have spaces in between as seen in the following map
window_location_map = {'AnyLocation': 'Any Location', 'LowerRightCorner': 'Lower Right Corner',
'LowerLeftCorner': 'Lower Left Corner', 'LowerCenter': 'Lower Center',
'UpperLeftCorner': 'Upper Left Corner', 'UpperRightCorner': 'Upper Right Corner',
'UpperCenter': 'Upper Center'}
new_value = window_location_map[value]
if paraview.compatibility.GetVersion() <= 5.9:
setter_func(proxy, new_value)
raise Continue()
else:
raise NotSupportedException("%s is an obsolete value. Use %s instead." % (value, new_value))
# Always keep this line last
raise ValueError("'%s' is not a valid value for %s!" % (value, pname))
def main(args):
"""The main loop"""
# this globbling logic is copied from `filedriver.py`. It may be worth
# cleaning this up to ensure it handles typical use-cases we encounter.
files = glob.glob(args.glob)
# In case the filenames aren't padded we sort first by shorter length and then
# alphabetically. This is a slight modification based on the question by Adrian and answer by
# Jochen Ritzel at:
# https://stackoverflow.com/questions/4659524/how-to-sort-by-length-of-string-followed-by-alphabetical-order
files.sort(key=lambda item: (len(item), item))
# initialize Catalyst
from paraview.catalyst import bridge
from paraview import print_info, print_warning
bridge.initialize()
# add analysis script
for script in args.script:
bridge.add_pipeline(script, args.script_version)
# Some MPI related stuff to figure out if we're running with MPI
# and if so, on how many ranks.
try:
from mpi4py import MPI
comm = MPI.COMM_WORLD
rank = comm.Get_rank()
num_ranks = comm.Get_size()
except ImportError:
print_warning("missing mpi4py, running in serial (non-distributed) mode")
rank = 0
num_ranks = 1
reader = create_reader(files)
timesteps = reader.TimestepValues[:]
step = 0
numsteps = len(timesteps)
for time in timesteps:
if args.delay > 0:
import time
time.sleep(args.delay)
if rank == 0:
print_info("timestep: {0} of {1}".format((step+1), numsteps))
dataset, wholeExtent = read_dataset(reader, time, rank, num_ranks)
# "perform" coprocessing. results are outputted only if
# the passed in script says we should at time/step
bridge.coprocess(time, step, dataset, name=args.channel, wholeExtent=wholeExtent)
del dataset
del wholeExtent
step += 1
# finalize Catalyst
bridge.finalize()
def setattr_fix_value(proxy, pname, value, setter_func):
if pname == "ShaderPreset" and proxy.SMProxy.GetXMLName().endswith("Representation"):
if value == "Gaussian Blur (Default)":
if paraview.compatibility.GetVersion() <= 5.5:
paraview.print_warning(\
"The 'Gaussian Blur (Default)' option has been renamed to 'Gaussian Blur'. Please use that instead.")
setter_func(proxy, "Gaussian Blur")
raise Continue()
else:
raise NotSupportedException("'Gaussian Blur (Default)' is an obsolete value for ShaderPreset. "\
" Use 'Gaussian Blur' instead.")
raise ValueError("'%s' is not a valid value for %s!" % (value, pname))
def setattr_fix_value(proxy, pname, value, setter_func):
if pname == "ShaderPreset" and proxy.SMProxy.GetXMLName().endswith("Representation"):
if value == "Gaussian Blur (Default)":
if paraview.compatibility.GetVersion() <= 5.5:
paraview.print_warning(\
"The 'Gaussian Blur (Default)' option has been renamed to 'Gaussian Blur'. Please use that instead.")
setter_func(proxy, "Gaussian Blur")
raise Continue()
else:
raise NotSupportedException("'Gaussian Blur (Default)' is an obsolete value for ShaderPreset. "\
" Use 'Gaussian Blur' instead.")
raise ValueError("'%s' is not a valid value for %s!" % (value, pname))
def setattr_fix_value(proxy, pname, value, setter_func):
if pname == "ShaderPreset" and proxy.SMProxy.GetXMLName().endswith(
"Representation"):
if value == "Gaussian Blur (Default)":
if paraview.compatibility.GetVersion() <= 5.5:
paraview.print_warning(\
"The 'Gaussian Blur (Default)' option has been renamed to 'Gaussian Blur'. Please use that instead.")
setter_func(proxy, "Gaussian Blur")
raise Continue()
else:
raise NotSupportedException("'Gaussian Blur (Default)' is an obsolete value for ShaderPreset. "\
" Use 'Gaussian Blur' instead.")
if pname == "FieldAssociation" and proxy.SMProxy.GetXMLName() in [
"DataSetCSVWriter", "CSVWriter"
]:
if paraview.compatibility.GetVersion() < 5.8:
if value == "Points":
value = "Point Data"
elif value == "Cells":
value = "Cell Data"
setter_func(proxy, value)
raise Continue()
else:
raise NotSupportedException("'FieldAssociation' is using an obsolete "\
"value '%s', use `Point Data` or `Cell Data` instead." % value)
# In 5.9, we changed "High Resolution Line Source" to "Line Source" and "Point Source" to
# "Point Cloud"
seed_sources_from = ["High Resolution Line Source", "Point Source"]
seed_sources_to = ["Line Source", "Point Cloud"]
seed_sources_proxyname = ["HighResLineSource", "PointSource"]
if value in seed_sources_from and proxy.GetProperty(pname).SMProperty.IsA(
"vtkSMInputProperty"):
domain = proxy.GetProperty(pname).SMProperty.FindDomain(
"vtkSMProxyListDomain")
for i in range(len(seed_sources_to)):
if value == seed_sources_from[i]:
domain_proxy = domain.FindProxy("extended_sources",
seed_sources_proxyname[i])
if domain_proxy:
if paraview.compatibility.GetVersion() < 5.9:
value = seed_sources_to[i]
setter_func(proxy, value)
raise Continue()
else:
raise NotSupportedException(
"%s is an obsolete value. Use %s instead." %
(seed_sources_from[i], seed_sources_to[i]))
# Always keep this line last
raise ValueError("'%s' is not a valid value for %s!" % (value, pname))
def main(args):
"""The main loop"""
# initialize Catalyst
from paraview.catalyst import bridge
from paraview import print_info, print_warning
bridge.initialize()
# add analysis script
for script in args.script:
bridge.add_pipeline(script, args.script_version)
# Some MPI related stuff to figure out if we're running with MPI
# and if so, on how many ranks.
try:
from mpi4py import MPI
comm = MPI.COMM_WORLD
rank = comm.Get_rank()
num_ranks = comm.Get_size()
except ImportError:
print_warning(
"missing mpi4py, running in serial (non-distributed) mode")
rank = 0
num_ranks = 1
numsteps = args.timesteps
for step in range(numsteps):
if args.delay > 0:
import time
time.sleep(args.delay)
if rank == 0:
print_info("timestep: {0}/{1}".format(step + 1, numsteps))
# assume simulation time starts at 0
time = step / float(numsteps)
dataset, wholeExtent = create_dataset(step, args, rank, num_ranks)
# "perform" coprocessing. results are outputted only if
# the passed in script says we should at time/step
bridge.coprocess(time,
step,
dataset,
name=args.channel,
wholeExtent=wholeExtent)
del dataset
del wholeExtent
# finalize Catalyst
bridge.finalize()
def getattr(proxy, pname):
"""
Attempts to emulate getattr() when called using a deprecated property name
for a proxy.
Will return a *reasonable* stand-in if the property was
deprecated and the paraview compatibility version was set to a version older
than when the property was deprecated.
Will raise ``NotSupportedException`` if the property was deprecated and
paraview compatibility version is newer than that deprecation version.
Will raise ``Continue`` to indicate the property name is unaffected by
any API deprecation and the caller should follow normal code execution
paths.
"""
version = paraview.compatibility.GetVersion()
# In 4.2, we removed ColorAttributeType property. One is expected to use
# ColorArrayName to specify the attribute type as well.
if pname == "ColorAttributeType" and proxy.SMProxy.GetProperty("ColorArrayName"):
if version <= 4.1:
if proxy.GetProperty("ColorArrayName")[0] == "CELLS":
return "CELL_DATA"
else:
return "POINT_DATA"
else:
# if ColorAttributeType is being used, warn.
raise NotSupportedException(
"'ColorAttributeType' is obsolete. Simply use 'ColorArrayName' instead. Refer to ParaView Python API changes documentation online.")
# In 5.1, we removed CameraClippingRange property. It was not of any use
# since we added support to render view to automatically reset clipping
# range for each render.
if pname == "CameraClippingRange" and not proxy.SMProxy.GetProperty("CameraClippingRange"):
if version <= 5.0:
return [0.0, 0.0, 0.0]
else:
raise NotSupportedException(
'CameraClippingRange is obsolete. Please remove '\
'it from your script. You no longer need it.')
# In 5.1, we remove support for Cube Axes and related properties.
global _ACubeAxesHelper
if proxy.SMProxy.IsA("vtkSMPVRepresentationProxy") and hasattr(_ACubeAxesHelper, pname):
if version <= 5.0:
return builtins.getattr(_ACubeAxesHelper, pname)
else:
raise NotSupportedException(
'Cube Axes and related properties are now obsolete. Please '\
'remove them from your script.')
# In 5.4, we removed the AspectRatio property and replaced it with the
# ScalarBarThickness property.
if pname == "AspectRatio" and proxy.SMProxy.GetProperty("ScalarBarThickness"):
if version <= 5.3:
return 20.0
else:
raise NotSupportedException(
'The AspectRatio property has been removed in ParaView '\
'5.4. Please use the ScalarBarThickness property instead '\
'to set the thickness in terms of points.')
# In 5.4, we removed the Position2 property and replaced it with the
# ScalarBarLength property.
if pname == "Position2" and proxy.SMProxy.GetProperty("ScalarBarLength"):
if version <= 5.3:
if proxy.GetProperty("Orientation").GetData() == "Horizontal":
return [0.05, proxy.GetProperty("ScalarBarLength").GetData()]
else:
return [proxy.GetProperty("ScalarBarLength").GetData(), 0.05]
else:
raise NotSupportedException(
'The Position2 property has been removed in ParaView '\
'5.4. Please set the ScalarBarLength property instead.')
# In 5.5, we removed the PVLookupTable.LockScalarRange boolean property and
# replaced it with the enumeration AutomaticRescaleRangeMode.
if pname == "LockScalarRange" and proxy.SMProxy.GetProperty("AutomaticRescaleRangeMode"):
if version <= 5.4:
from paraview.modules.vtkRemotingViews import vtkSMTransferFunctionManager
if proxy.GetProperty("AutomaticRescaleRangeMode").GetData() == "Never":
return 1
else:
return 0
else:
raise NotSupportedException(
'The PVLookupTable.LockScalarRange property has been removed '\
'in ParaView 5.5. Please set the AutomaticRescaleRangeMode property '\
'instead.')
# In 5.5, we changed the vtkArrayCalculator to use a different set of constants to control which
# data it operates on. This change changed the method and property name from AttributeMode to
# AttributeType
if pname == "AttributeMode" and proxy.SMProxy.GetName() == "Calculator":
if paraview.compatibility.GetVersion() <= 5.4:
# The Attribute type uses enumeration values from vtkDataObject::AttributeTypes
# rather than custom constants for the calculator. For the values supported by
# ParaView before this change, the conversion works out to adding 1 if it is an
# integer. If the value is an enumerated string we use that as is since it matches
# the previous enumerated string options.
value = proxy.GetProperty("AttributeType").GetData()
if isinstance(value, int):
return value + 1
return value
else:
raise NotSupportedException(
'The Calculator.AttributeMode property has been removed in ParaView 5.5. '\
'Please set the AttributeType property instead. Note that different '\
'constants are needed for the two properties.')
if pname == "UseOffscreenRenderingForScreenshots" and proxy.SMProxy.IsA("vtkSMViewProxy"):
if version <= 5.4:
return 0
else:
raise NotSupportedException('`UseOffscreenRenderingForScreenshots` '\
'is no longer supported. Please remove it.')
if pname == "UseOffscreenRendering" and proxy.SMProxy.IsA("vtkSMViewProxy"):
if version <= 5.4:
return 0
else:
raise NotSupportedException(\
'`UseOffscreenRendering` is no longer supported. Please remove it.')
if proxy.SMProxy.GetXMLName() == "CGNSSeriesReader" and\
pname in ["LoadBndPatch", "LoadMesh", "BaseStatus", "FamilyStatus"]:
if version < 5.5:
if pname in ["LoadMesh", "LoadBndPatch"]:
return 0
else:
paraview.print_warning(\
"'%s' is no longer supported and will have no effect. "\
"Please use `Blocks` property to specify blocks to load." % pname)
return []
else:
raise NotSupportedException(\
"'%s' is obsolete. Use `Blocks` to make block based selection." % pname)
# In 5.5, we removed the DataBoundsInflateFactor property and replaced it with the
# DataBoundsScaleFactor property.
if pname == "DataBoundsInflateFactor" and proxy.SMProxy.GetProperty("DataBoundsScaleFactor"):
if version <= 5.4:
inflateValue = proxy.GetProperty("DataBoundsScaleFactor").GetData() - 1
if inflateValue >= 0:
return inflateValue
else:
return 0
else:
raise NotSupportedException(
'The DataBoundsInflateFactorproperty has been removed in ParaView '\
'5.4. Please use the DataBoundsScaleFactor property instead.')
if proxy.SMProxy and proxy.SMProxy.GetXMLName() == "AnnotateAttributeData":
# in 5.5, Annotate Attribute Data changed how it sets the array to annotate
if pname == "ArrayAssociation":
if paraview.compatibility.GetVersion() <= 5.4:
paraview.print_warning(\
"'ArrayAssociation' is obsolete. Use 'SelectInputArray' property of AnnotateAttributeData instead.")
value = proxy.GetProperty("SelectInputArray")[0]
if value == "CELLS":
return "Cell Data"
elif value == "FIELD":
return "Field Data"
elif value == "ROWS":
return "Row Data"
else:
return "Point Data"
else:
raise NotSupportedException(\
"'ArrayAssociation' is obsolete as of ParaView 5.5. Use 'SelectInputArray' instead.")
elif pname == "ArrayName":
if paraview.compatibility.GetVersion() <= 5.4:
paraview.print_warning(\
"'ArrayName' is obsolete. Use 'SelectInputArray' property of AnnotateAttributeData instead.")
return proxy.GetProperty("SelectInputArray")[1]
else:
raise NotSupportedException(\
"'ArrayName' is obsolete as of ParaView 5.5. Use 'SelectInputArray' instead.")
# In 5.5, we changed the Clip to be inverted from what it was before and changed the InsideOut
# property to be called Invert to be clearer.
if pname == "InsideOut" and proxy.SMProxy.GetXMLName() == "Clip":
if paraview.compatibility.GetVersion() <= 5.4:
return proxy.GetProperty("Invert").GetData()
else:
raise NotSupportedException(
'The Clip.InsideOut property has been changed in ParaView 5.5. '\
'Please set the Invert property instead.')
# In 5.6, we changed the "SpreadSheetRepresentation" proxy to no longer have
# the "FieldAssociation" and "GenerateCellConnectivity" properties. They are
# now moved to the view.
if pname in ["FieldAssociation", "GenerateCellConnectivity"] and proxy.SMProxy.GetXMLName() == "SpreadSheetRepresentation":
if paraview.compatibility.GetVersion() <= 5.5:
return 0
else:
raise NotSupportedException(
"'%s' is obsolete on SpreadSheetRepresentation as of ParaView 5.6 and has been migrated to the view." % pname)
# In 5.7, we changed to the names of the input proxies in ResampleWithDataset to clarify what
# each source does.
if pname == "Input" and proxy.SMProxy.GetXMLName() == "ResampleWithDataset":
if paraview.compatibility.GetVersion() < 5.7:
return proxy.GetProperty("SourceDataArrays")
else:
raise NotSupportedException(
'The ResampleWithDataset.Input property has been changed in ParaView 5.7. '\
'Please access the SourceDataArrays property instead.')
if pname == "Source" and proxy.SMProxy.GetXMLName() == "ResampleWithDataset":
if paraview.compatibility.GetVersion() < 5.7:
return proxy.GetProperty("DestinationMesh")
else:
raise NotSupportedException(
'The ResampleWithDataset.Source property has been changed in ParaView 5.7. '\
'Please access the DestinationMesh property instead.')
# In 5.7, we removed `ArrayName` property on the `GenerateIdScalars` filter
# and replaced it with `CellIdsArrayName` and `PointIdsArrayName`.
if pname == "ArrayName" and proxy.SMProxy.GetXMLName() == "GenerateIdScalars":
if paraview.compatibility.GetVersion() < 5.7:
return proxy.GetProperty("PointIdsArrayName")
else:
raise NotSupportedException(
'The GenerateIdScalars.ArrayName property has been removed in ParaView 5.7. ' \
'Please access `PointIdsArrayName` or `CellIdsArrayName` property instead.')
# In 5.7, we renamed the 3D View's ray tracing interface from OSPRay to RayTracing
if pname == "EnableOSPRay" and proxy.SMProxy.IsA("vtkSMRenderViewProxy"):
if paraview.compatibility.GetVersion() < 5.7:
return proxy.GetProperty("EnableRayTracing")
else:
raise NotSupportedException(
'The `EnableOSPRay` control has been renamed in ParaView 5.7 to `EnableRayTracing`.')
if pname == "OSPRayRenderer" and proxy.SMProxy.IsA("vtkSMRenderViewProxy"):
if paraview.compatibility.GetVersion() < 5.7:
return proxy.GetProperty("BackEnd")
else:
raise NotSupportedException(
'The `OSPRayRenderer` control has been renamed in ParaView 5.7 to `BackEnd` and '\
'the settings `scivis` and `pathtracer` have been renamed to `OSPRay scivis` '\
'and `OSPRay pathtracer` respectively.')
if pname == "OSPRayTemporalCacheSize" and proxy.SMProxy.IsA("vtkSMRenderViewProxy"):
if paraview.compatibility.GetVersion() < 5.7:
return proxy.GetProperty("TemporalCacheSize")
else:
raise NotSupportedException(
'The `OSPRayTemporalCacheSize` control has been renamed in ParaView 5.7 to `TemporalCacheSize`.')
if pname == "OSPRayUseScaleArray" and proxy.SMProxy.IsA("vtkSMRepresentationProxy"):
if paraview.compatibility.GetVersion() < 5.7:
return proxy.GetProperty("UseScaleArray")
else:
raise NotSupportedException(
'The `OSPRayUseScaleArray` control has been renamed in ParaView 5.7 to `UseScaleArray`.')
if pname == "OSPRayScaleFunction" and proxy.SMProxy.IsA("vtkSMRepresentationProxy"):
if paraview.compatibility.GetVersion() < 5.7:
return proxy.GetProperty("ScaleFunction")
else:
raise NotSupportedException(
'The `OSPRayScaleFunction` control has been renamed in ParaView 5.7 to `ScaleFunction`.')
if pname == "OSPRayMaterial" and proxy.SMProxy.IsA("vtkSMRepresentationProxy"):
if paraview.compatibility.GetVersion() < 5.7:
return proxy.GetProperty("Material")
else:
raise NotSupportedException(
'The `OSPRayMaterial` control has been renamed in ParaView 5.7 to `Material`.')
# In 5.7, the `Box` implicit function's Scale property was renamed to
# Length.
if pname == "Scale" and proxy.SMProxy.GetXMLName() == "Box":
if paraview.compatibility.GetVersion() < 5.7:
return proxy.GetProperty("Length")
else:
raise NotSupportedException(
'The `Scale` property has been renamed in ParaView 5.7 to `Length`.')
# In 5.9, CGNSSeriesReader no longer supports the "Blocks" property.
if pname == "Blocks" and proxy.SMProxy.GetXMLName() == "CGNSSeriesReader":
if paraview.compatibility.GetVersion() < 5.9:
return []
else:
raise NotSupportedException(
"The 'Blocks' property has been removed in ParaView 5.9. Use "
"'Bases' to choose bases and 'Families' to choose families "
"to load instead. 'LoadMesh' and 'LoadPatches' may also be "
"used to enable loading of meshes and BC-patches.")
# 5.10 onwards SpreadSheetRepresentation cannot provide a value for
# CompositeDataSetIndex
if pname == "CompositeDataSetIndex" and proxy.SMProxy.GetXMLName() == "SpreadSheetRepresentation":
if paraview.compatibility.GetVersion() <= 5.9:
return []
else:
raise NotSupportedException(
"Since ParaView 5.10, SpreadSheetRepresentation no longer "
"supports 'CompositeDataSetIndex' and it has been replaced by "
"'BlockVisibilities'.")
if proxy.SMProxy.GetXMLName() == "ExtractBlock":
if pname == "BlockIndices":
if paraview.compatibility.GetVersion() <= 5.9:
return []
else:
raise NotSupportedException(
"Since ParaView 5.10, 'BlockIndices' on 'ExtractBlock' "
"has been replaced by 'Selectors'.")
elif pname == "PruneOutput":
if paraview.compatibility.GetVersion() <= 5.9:
return 1
else:
raise NotSupportedException(
"Since ParaView 5.10, 'PruneOutput' on 'ExtractBlock' "
"is no longer supported. Simply remove it.")
elif pname == "MaintainStructure":
if paraview.compatibility.GetVersion() <= 5.9:
return 1
else:
raise NotSupportedException(
"Since ParaView 5.10, 'MaintainStructure' on 'ExtractBlock' "
"is no longer supported. Simply remove it.")
if pname in ["UseGradientBackground", "UseTexturedBackground",
"UseSkyboxBackground"] and proxy.SMProxy.GetXMLGroup() == "views" \
and proxy.SMProxy.GetProperty("BackgroundColorMode"):
if paraview.compatibility.GetVersion() <= 5.9:
mode = proxy.GetProperty("BackgroundColorMode").GetData()
if pname == "UseGradientBackground":
return 1 if mode == "Gradient" else 0
if pname == "UseTexturedBackground":
return 1 if mode == "Texture" else 0
if pname == "UseSkyboxBackground":
return 1 if mode == "Skybox" else 0
else:
raise NotSupportedException(
"Since ParaView 5.10, '%s' is no longer supported. Use "
"'BackgroundColorMode' instead." % pname)
if pname == "ThresholdRange" and proxy.SMProxy.GetXMLName() == "Threshold":
# The Threshold filter now offers additional thresholding methods
# besides ThresholdBetween. The lower and upper threshold values
# are also set separately.
if paraview.compatibility.GetVersion() <= 5.9:
return [proxy.GetProperty("LowerThreshold").GetData(),
proxy.GetProperty("UpperThreshold").GetData()]
else:
raise NotSupportedException("The 'ThresholdRange' property has been "
"removed in ParaView 5.10. Please set the lower and upper "
"thresholds using the 'LowerThreshold' and 'UpperThreshold' "
"properties, then set the 'ThresholdMethod' property to "
"'Between' to threshold between the lower and upper thresholds.")
raise Continue()
def _sanity_check():
pm = vtkProcessModule.GetProcessModule()
if pm and pm.GetPartitionId() == 0:
paraview.print_warning(\
"Warning: ParaView has been initialized before `initialize` is called")
def setattr(proxy, pname, value):
"""
Attempts to emulate setattr() when called using a deprecated name for a
proxy property.
For properties that are no longer present on a proxy, the code should do the
following:
1. If `paraview.compatibility.GetVersion()` is less than the version in
which the property was removed, attempt to handle the request and raise
`Continue` to indicate that the request has been handled. If it is too
complicated to support the old API, then it is acceptable to raise
a warning message, but don't raise an exception.
2. If compatibility version is >= the version in which the property was
removed, raise `NotSupportedException` with details including suggestions
to update the script.
"""
version = paraview.compatibility.GetVersion()
if pname == "ColorAttributeType" and proxy.SMProxy.GetProperty("ColorArrayName"):
if paraview.compatibility.GetVersion() <= 4.1:
# set ColorAttributeType on ColorArrayName property instead.
caProp = proxy.GetProperty("ColorArrayName")
proxy.GetProperty("ColorArrayName").SetData((value, caProp[1]))
raise Continue()
else:
# if ColorAttributeType is being used, raise NotSupportedException.
raise NotSupportedException(
"'ColorAttributeType' is obsolete as of ParaView 4.2. Simply use 'ColorArrayName' "\
"instead. Refer to ParaView Python API changes documentation online.")
if pname == "AspectRatio" and proxy.SMProxy.GetProperty("ScalarBarThickness"):
if paraview.compatibility.GetVersion() <= 5.3:
# We can't do this perfectly, so we set the ScalarBarThickness
# property instead. Assume a reasonable modern screen size of
# 1280x1024 with a Render view size of 1000x600. Even if we had
# access to the View proxy to get the screen size, there is no
# guarantee that the view size will remain the same later on in the
# Python script.
span = 600 # vertical
if proxy.GetProperty("Orientation").GetData() == "Horizontal":
span = 1000
# Assume a scalar bar length 40% of the span.
thickness = 0.4 * span / value
proxy.GetProperty("ScalarBarThickness").SetData(int(thickness))
raise Continue()
else:
#if AspectRatio is being used, raise NotSupportedException
raise NotSupportedException(\
"'AspectRatio' is obsolete as of ParaView 5.4. Use the "\
"'ScalarBarThickness' property to set the width instead.")
if pname == "Position2" and proxy.SMProxy.GetProperty("ScalarBarLength"):
if paraview.compatibility.GetVersion() <= 5.3:
# The scalar bar length corresponds to Position2[0] when the
# orientation is horizontal and Position2[1] when the orientation
# is vertical.
length = value[0]
if proxy.Orientation == "Vertical":
length = value[1]
proxy.GetProperty("ScalarBarLength").SetData(length)
else:
#if Position2 is being used, raise NotSupportedException
raise NotSupportedException(\
"'Position2' is obsolete as of ParaView 5.4. Use the "\
"'ScalarBarLength' property to set the length instead.")
if pname == "LockScalarRange" and proxy.SMProxy.GetProperty("AutomaticRescaleRangeMode"):
if paraview.compatibility.GetVersion() <= 5.4:
if value:
from vtkmodules.vtkPVServerManagerRendering import vtkSMTransferFunctionManager
proxy.GetProperty("AutomaticRescaleRangeMode").SetData(vtkSMTransferFunctionManager.NEVER)
else:
pxm = proxy.SMProxy.GetSessionProxyManager()
settingsProxy = pxm.GetProxy("settings", "GeneralSettings")
mode = settingsProxy.GetProperty("TransferFunctionResetMode").GetElement(0)
proxy.GetProperty("AutomaticRescaleRangeMode").SetData(mode)
raise Continue()
else:
raise NotSupportedException(
"'LockScalarRange' is obsolete as of ParaView 5.5. Use "\
"'AutomaticRescaleRangeMode' property instead.")
# In 5.5, we changed the vtkArrayCalculator to use a different set of constants to control which
# data it operates on. This change changed the method and property name from AttributeMode to
# AttributeType
if pname == "AttributeMode" and proxy.SMProxy.GetXMLName() == "Calculator":
if paraview.compatibility.GetVersion() <= 5.4:
# The Attribute type uses enumeration values from vtkDataObject::AttributeTypes
# rather than custom constants for the calculator. For the values supported by
# ParaView before this change, the conversion works out to subtracting 1 if value
# is an integer. If value is an enumerated string we use that as is since it matches
# the previous enumerated string options.
if isinstance(value, int):
proxy.GetProperty("AttributeType").SetData(value - 1)
else:
proxy.GetProperty("AttributeType").SetData(value)
raise Continue()
else:
raise NotSupportedException(\
"'AttributeMode' is obsolete. Use 'AttributeType' property of Calculator filter instead.")
if pname == "UseOffscreenRenderingForScreenshots" and proxy.SMProxy.IsA("vtkSMViewProxy"):
if paraview.compatibility.GetVersion() <= 5.4:
raise Continue()
else:
raise NotSupportedException(\
"'UseOffscreenRenderingForScreenshots' is obsolete. Simply remove it from your script.")
if pname == "UseOffscreenRendering" and proxy.SMProxy.IsA("vtkSMViewProxy"):
if paraview.compatibility.GetVersion() <= 5.4:
raise Continue()
else:
raise NotSupportedException(\
"'UseOffscreenRendering' is obsolete. Simply remove it from your script.")
if proxy.SMProxy and proxy.SMProxy.GetXMLName() == "CGNSSeriesReader":
# in 5.5, CGNS reader had some changes. "BaseStatus", "FamilyStatus",
# "LoadBndPatch", and "LoadMesh" properties were removed.
if pname in ["LoadBndPatch", "LoadMesh", "BaseStatus", "FamilyStatus"]:
if paraview.compatibility.GetVersion() <= 5.4:
paraview.print_warning(\
"'%s' is no longer supported and will have no effect. "\
"Please use `Blocks` property to specify blocks to load." % pname)
raise Continue()
else:
raise NotSupportedException("'%s' is obsolete. Use the `Blocks` "\
"property to select blocks using SIL instead.")
if pname == "DataBoundsInflateFactor" and proxy.SMProxy.GetProperty("DataBoundsScaleFactor"):
if paraview.compatibility.GetVersion() <= 5.4:
# In 5.5, The axes grid data bounds inflate factor have been
# translated by 1 to become the scale factor.
proxy.GetProperty("DataBoundsScaleFactor").SetData(value + 1)
else:
#if inflat factor is being used, raise NotSupportedException
raise NotSupportedException(\
"'DataBoundsInflateFactor' is obsolete as of ParaView 5.5. Use the "\
"'DataBoundsScaleFactor' property to modify the axes gris data bounds instead.")
if proxy.SMProxy and proxy.SMProxy.GetXMLName() == "AnnotateAttributeData":
# in 5.5, Annotate Attribute Data changed how it sets the array to annotate
if pname == "ArrayAssociation":
if paraview.compatibility.GetVersion() <= 5.4:
paraview.print_warning(\
"'ArrayAssociation' is obsolete. Use 'SelectInputArray' property of AnnotateAttributeData instead.")
if value == "Point Data":
value = "POINTS"
elif value == "Cell Data":
value = "CELLS"
elif value == "Field Data":
value = "FIELD"
elif value == "Row Data":
value = "ROWS"
arrayProp = proxy.GetProperty("SelectInputArray")
proxy.GetProperty("SelectInputArray").SetData((value, arrayProp[1]))
raise Continue()
else:
raise NotSupportedException(\
"'ArrayAssociation' is obsolete as of ParaView 5.5. Use 'SelectInputArray' instead.")
elif pname == "ArrayName":
if paraview.compatibility.GetVersion() <= 5.4:
paraview.print_warning(\
"'ArrayName' is obsolete. Use 'SelectInputArray' property of AnnotateAttributeData instead.")
arrayProp = proxy.GetProperty("SelectInputArray")
proxy.GetProperty("SelectInputArray").SetData((arrayProp[0], value))
raise Continue()
else:
raise NotSupportedException(\
"'ArrayName' is obsolete as of ParaView 5.5. Use 'SelectInputArray' instead.")
# In 5.5, we changed the Clip to be inverted from what it was before and changed the InsideOut
# property to be called Invert to be clearer.
if pname == "InsideOut" and proxy.SMProxy.GetXMLName() == "Clip":
if paraview.compatibility.GetVersion() <= 5.4:
proxy.GetProperty("Invert").SetData(1-value)
raise Continue()
else:
raise NotSupportedException(\
"'InsideOut' is obsolete. Use 'Invert' property of Clip filter instead.")
if not hasattr(proxy, pname):
raise AttributeError()
proxy.__dict__[pname] = value
raise Continue()
def setattr(proxy, pname, value):
"""
Attempts to emulate setattr() when called using a deprecated name for a
proxy property.
For properties that are no longer present on a proxy, the code should do the
following:
1. If `paraview.compatibility.GetVersion()` is less than the version in
which the property was removed, attempt to handle the request and raise
`Continue` to indicate that the request has been handled. If it is too
complicated to support the old API, then it is acceptable to raise
a warning message, but don't raise an exception.
2. If compatibility version is >= the version in which the property was
removed, raise `NotSupportedException` with details including suggestions
to update the script.
"""
version = paraview.compatibility.GetVersion()
if pname == "ColorAttributeType" and proxy.SMProxy.GetProperty("ColorArrayName"):
if paraview.compatibility.GetVersion() <= 4.1:
# set ColorAttributeType on ColorArrayName property instead.
caProp = proxy.GetProperty("ColorArrayName")
proxy.GetProperty("ColorArrayName").SetData((value, caProp[1]))
raise Continue()
else:
# if ColorAttributeType is being used, raise NotSupportedException.
raise NotSupportedException(
"'ColorAttributeType' is obsolete as of ParaView 4.2. Simply use 'ColorArrayName' "\
"instead. Refer to ParaView Python API changes documentation online.")
if pname == "AspectRatio" and proxy.SMProxy.GetProperty("ScalarBarThickness"):
if paraview.compatibility.GetVersion() <= 5.3:
# We can't do this perfectly, so we set the ScalarBarThickness
# property instead. Assume a reasonable modern screen size of
# 1280x1024 with a Render view size of 1000x600. Even if we had
# access to the View proxy to get the screen size, there is no
# guarantee that the view size will remain the same later on in the
# Python script.
span = 600 # vertical
if proxy.GetProperty("Orientation").GetData() == "Horizontal":
span = 1000
# Assume a scalar bar length 40% of the span.
thickness = 0.4 * span / value
proxy.GetProperty("ScalarBarThickness").SetData(int(thickness))
raise Continue()
else:
#if AspectRatio is being used, raise NotSupportedException
raise NotSupportedException(\
"'AspectRatio' is obsolete as of ParaView 5.4. Use the "\
"'ScalarBarThickness' property to set the width instead.")
if pname == "Position2" and proxy.SMProxy.GetProperty("ScalarBarLength"):
if paraview.compatibility.GetVersion() <= 5.3:
# The scalar bar length corresponds to Position2[0] when the
# orientation is horizontal and Position2[1] when the orientation
# is vertical.
length = value[0]
if proxy.Orientation == "Vertical":
length = value[1]
proxy.GetProperty("ScalarBarLength").SetData(length)
else:
#if Position2 is being used, raise NotSupportedException
raise NotSupportedException(\
"'Position2' is obsolete as of ParaView 5.4. Use the "\
"'ScalarBarLength' property to set the length instead.")
if pname == "LockScalarRange" and proxy.SMProxy.GetProperty("AutomaticRescaleRangeMode"):
if paraview.compatibility.GetVersion() <= 5.4:
from paraview.modules.vtkRemotingViews import vtkSMTransferFunctionManager
if value:
proxy.GetProperty("AutomaticRescaleRangeMode").SetData(vtkSMTransferFunctionManager.NEVER)
else:
proxy.GetProperty("AutomaticRescaleRangeMode").SetData(vtkSMTransferFunctionManager.GROW_ON_APPLY)
raise Continue()
else:
raise NotSupportedException(
"'LockScalarRange' is obsolete as of ParaView 5.5. Use "\
"'AutomaticRescaleRangeMode' property instead.")
# In 5.5, we changed the vtkArrayCalculator to use a different set of constants to control which
# data it operates on. This change changed the method and property name from AttributeMode to
# AttributeType
if pname == "AttributeMode" and proxy.SMProxy.GetXMLName() == "Calculator":
if paraview.compatibility.GetVersion() <= 5.4:
# The Attribute type uses enumeration values from vtkDataObject::AttributeTypes
# rather than custom constants for the calculator. For the values supported by
# ParaView before this change, the conversion works out to subtracting 1 if value
# is an integer. If value is an enumerated string we use that as is since it matches
# the previous enumerated string options.
if isinstance(value, int):
proxy.GetProperty("AttributeType").SetData(value - 1)
else:
proxy.GetProperty("AttributeType").SetData(value)
raise Continue()
else:
raise NotSupportedException(\
"'AttributeMode' is obsolete. Use 'AttributeType' property of Calculator filter instead.")
if pname == "UseOffscreenRenderingForScreenshots" and proxy.SMProxy.IsA("vtkSMViewProxy"):
if paraview.compatibility.GetVersion() <= 5.4:
raise Continue()
else:
raise NotSupportedException(\
"'UseOffscreenRenderingForScreenshots' is obsolete. Simply remove it from your script.")
if pname == "UseOffscreenRendering" and proxy.SMProxy.IsA("vtkSMViewProxy"):
if paraview.compatibility.GetVersion() <= 5.4:
raise Continue()
else:
raise NotSupportedException(\
"'UseOffscreenRendering' is obsolete. Simply remove it from your script.")
if proxy.SMProxy and proxy.SMProxy.GetXMLName() == "CGNSSeriesReader":
# in 5.5, CGNS reader had some changes. "BaseStatus", "FamilyStatus",
# "LoadBndPatch", and "LoadMesh" properties were removed.
if pname in ["LoadBndPatch", "LoadMesh", "BaseStatus", "FamilyStatus"]:
if paraview.compatibility.GetVersion() <= 5.4:
paraview.print_warning(\
"'%s' is no longer supported and will have no effect. "\
"Please use `Blocks` property to specify blocks to load." % pname)
raise Continue()
else:
raise NotSupportedException("'%s' is obsolete. Use the `Blocks` "\
"property to select blocks using SIL instead." % pname)
if pname == "DataBoundsInflateFactor" and proxy.SMProxy.GetProperty("DataBoundsScaleFactor"):
if paraview.compatibility.GetVersion() <= 5.4:
# In 5.5, The axes grid data bounds inflate factor have been
# translated by 1 to become the scale factor.
proxy.GetProperty("DataBoundsScaleFactor").SetData(value + 1)
else:
#if inflat factor is being used, raise NotSupportedException
raise NotSupportedException(\
"'DataBoundsInflateFactor' is obsolete as of ParaView 5.5. Use the "\
"'DataBoundsScaleFactor' property to modify the axes gris data bounds instead.")
if proxy.SMProxy and proxy.SMProxy.GetXMLName() == "AnnotateAttributeData":
# in 5.5, Annotate Attribute Data changed how it sets the array to annotate
if pname == "ArrayAssociation":
if paraview.compatibility.GetVersion() <= 5.4:
paraview.print_warning(\
"'ArrayAssociation' is obsolete. Use 'SelectInputArray' property of AnnotateAttributeData instead.")
if value == "Point Data":
value = "POINTS"
elif value == "Cell Data":
value = "CELLS"
elif value == "Field Data":
value = "FIELD"
elif value == "Row Data":
value = "ROWS"
arrayProp = proxy.GetProperty("SelectInputArray")
proxy.GetProperty("SelectInputArray").SetData((value, arrayProp[1]))
raise Continue()
else:
raise NotSupportedException(\
"'ArrayAssociation' is obsolete as of ParaView 5.5. Use 'SelectInputArray' instead.")
elif pname == "ArrayName":
if paraview.compatibility.GetVersion() <= 5.4:
paraview.print_warning(\
"'ArrayName' is obsolete. Use 'SelectInputArray' property of AnnotateAttributeData instead.")
arrayProp = proxy.GetProperty("SelectInputArray")
proxy.GetProperty("SelectInputArray").SetData((arrayProp[0], value))
raise Continue()
else:
raise NotSupportedException(\
"'ArrayName' is obsolete as of ParaView 5.5. Use 'SelectInputArray' instead.")
# In 5.5, we changed the Clip to be inverted from what it was before and changed the InsideOut
# property to be called Invert to be clearer.
if pname == "InsideOut" and proxy.SMProxy.GetXMLName() == "Clip":
if paraview.compatibility.GetVersion() <= 5.4:
proxy.GetProperty("Invert").SetData(1-value)
raise Continue()
else:
raise NotSupportedException(\
"'InsideOut' is obsolete. Use 'Invert' property of Clip filter instead.")
# In 5.6, we changed the "SpreadSheetRepresentation" proxy to no longer have
# the "FieldAssociation" and "GenerateCellConnectivity" properties. They are
# now moved to the view.
if pname in ["FieldAssociation", "GenerateCellConnectivity"] and proxy.SMProxy.GetXMLName() == "SpreadSheetRepresentation":
if paraview.compatibility.GetVersion() <= 5.5:
raise Continue()
else:
raise NotSupportedException(
"'%s' is obsolete on SpreadSheetRepresentation as of ParaView 5.6 and has been migrated to the view." % pname)
# In 5.7, we changed to the names of the input proxies in ResampleWithDataset to clarify what
# each source does.
if pname == "Input" and proxy.SMProxy.GetXMLName() == "ResampleWithDataset":
if paraview.compatibility.GetVersion() < 5.7:
proxy.GetProperty("SourceDataArrays").SetData(value)
raise Continue()
else:
raise NotSupportedException(
'The ResampleWithDataset.Input property has been changed in ParaView 5.7. '\
'Please set the SourceDataArrays property instead.')
if pname == "Source" and proxy.SMProxy.GetXMLName() == "ResampleWithDataset":
if paraview.compatibility.GetVersion() < 5.7:
proxy.GetProperty("DestinationMesh").SetData(value)
raise Continue()
else:
raise NotSupportedException(
'The ResampleWithDataset.Source property has been changed in ParaView 5.7. '\
'Please set the DestinationMesh property instead.')
# In 5.7, we removed `ArrayName` property on the `GenerateIdScalars` filter
# and replaced it with `CellIdsArrayName` and `PointIdsArrayName`.
if pname == "ArrayName" and proxy.SMProxy.GetXMLName() == "GenerateIdScalars":
if paraview.compatibility.GetVersion() < 5.7:
proxy.GetProperty("PointIdsArrayName").SetData(value)
proxy.GetProperty("CellIdsArrayName").SetData(value)
raise Continue()
else:
raise NotSupportedException(
'The GenerateIdScalars.ArrayName property has been removed in ParaView 5.7. '\
'Please set `PointIdsArrayName` or `CellIdsArrayName` property instead.')
# In 5.7, we renamed the 3D View's ray tracing interface from OSPRay to RayTracing
if pname == "EnableOSPRay" and proxy.SMProxy.IsA("vtkSMRenderViewProxy"):
if paraview.compatibility.GetVersion() < 5.7:
return proxy.GetProperty("EnableRayTracing").SetData(value)
else:
raise NotSupportedException(
'The `EnableOSPRay` control has been renamed in ParaView 5.7 to `EnableRayTracing`.')
if pname == "OSPRayRenderer" and proxy.SMProxy.IsA("vtkSMRenderViewProxy"):
newvalue = "OSPRay raycaster"
if value == "pathtracer":
newvalue = "OSPRay pathtracer"
if paraview.compatibility.GetVersion() < 5.7:
return proxy.GetProperty("BackEnd").SetData(newvalue)
else:
raise NotSupportedException(
'The `OSPRayRenderer` control has been renamed in ParaView 5.7 to `BackEnd` and '\
'the settings `scivis` and `pathtracer` have been renamed to `OSPRay scivis` '\
'and `OSPRay pathtracer` respectively.')
if pname == "OSPRayTemporalCacheSize" and proxy.SMProxy.IsA("vtkSMRenderViewProxy"):
if paraview.compatibility.GetVersion() < 5.7:
return proxy.GetProperty("TemporalCacheSize").SetData(value)
else:
raise NotSupportedException(
'The `OSPRayTemporalCacheSize` control has been renamed in ParaView 5.7 to `TemporalCacheSize`.')
if pname == "OSPRayUseScaleArray" and proxy.SMProxy.IsA("vtkSMRepresentationProxy"):
if paraview.compatibility.GetVersion() < 5.7:
return proxy.GetProperty("UseScaleArray").SetData(value)
else:
raise NotSupportedException(
'The `OSPRayUseScaleArray` control has been renamed in ParaView 5.7 to `UseScaleArray`.')
if pname == "OSPRayScaleFunction" and proxy.SMProxy.IsA("vtkSMRepresentationProxy"):
if paraview.compatibility.GetVersion() < 5.7:
return proxy.GetProperty("ScaleFunction").SetData(value)
else:
raise NotSupportedException(
'The `OSPRayScaleFunction` control has been renamed in ParaView 5.7 to `ScaleFunction`.')
if pname == "OSPRayMaterial" and proxy.SMProxy.IsA("vtkSMRepresentationProxy"):
if paraview.compatibility.GetVersion() < 5.7:
return proxy.GetProperty("Material").SetData(value)
else:
raise NotSupportedException(
'The `OSPRayMaterial` control has been renamed in ParaView 5.7 to `Material`.')
if pname == "CompositeDataSetIndex" and proxy.SMProxy.GetXMLName() == "SpreadSheetRepresentation":
if paraview.compatibility.GetVersion() <= 5.9:
selectors = ["//*[@cid='%s']" % cid for cid in value]
return proxy.GetProperty("BlockVisibilities").SetData(selectors)
else:
raise NotSupportedException(
"SpreadSheetRepresentation no longer uses 'CompositeDataSetIndex' but instead "
"supports 'Selectors' to select blocks.")
if pname == "BlockIndices" and proxy.SMProxy.GetXMLName() == "ExtractBlock":
if paraview.compatibility.GetVersion() <= 5.9:
selectors = ["//*[@cid='%s']" % cid for cid in value]
return proxy.GetProperty("Selectors").SetData(selectors)
else:
raise NotSupportedException(
"ExtractBlock no longer uses 'BlockIndices' but instead "
"supports 'Selectors' to select blocks.")
if pname in ["MaintainStructure", "PruneOutput"] and proxy.SMProxy.GetXMLName() == "ExtractBlock":
if paraview.compatibility.GetVersion() <= 5.9:
return
else:
raise NotSupportedException(
"ExtractBlock no longer supported '%s'. Simply remove it." % pname)
if pname in ["UseGradientBackground", "UseTexturedBackground",
"UseSkyboxBackground"] and proxy.SMProxy.GetXMLGroup() == "views" \
and proxy.SMProxy.GetProperty("BackgroundColorMode"):
if paraview.compatibility.GetVersion() <= 5.9:
mode = proxy.GetProperty("BackgroundColorMode").GetData()
if pname == "UseGradientBackground":
if value == 1 and mode != "Gradient":
proxy.BackgroundColorMode = "Gradient"
elif value == 0 and mode == "Gradient":
proxy.BackgroundColorMode = "Single Color"
elif pname == "UseTexturedBackground":
if value == 1 and mode != "Texture":
proxy.BackgroundColorMode = "Texture"
elif value == 0 and mode == "Texture":
proxy.BackgroundColorMode = "Single Color"
elif pname == "UseSkyboxBackground":
if value == 1 and mode != "Skybox":
proxy.BackgroundColorMode = "Skybox"
elif value == 0 and mode == "Skybox":
proxy.BackgroundColorMode = "Single Color"
raise Continue()
else:
raise NotSupportedException("'%s' is no longer supported. Use "
"'BackgroundColorMode' instead to choose background color mode." % pname)
if pname == "ThresholdRange" and proxy.SMProxy.GetXMLName() == "Threshold":
# From ParaView 5.10, the Threshold filter now offers additional
# thresholding methods besides ThresholdBetween. The lower and upper
# threshold values are also set separately.
if paraview.compatibility.GetVersion() <= 5.9:
proxy.GetProperty("ThresholdMethod").SetData(0)
proxy.GetProperty("LowerThreshold").SetData(value[0])
proxy.GetProperty("UpperThreshold").SetData(value[1])
raise Continue()
else:
raise NotSupportedException("The 'ThresholdRange' property has been "
"removed in ParaView 5.10. Please set the lower and upper "
"thresholds using the 'LowerThreshold' and 'UpperThreshold' "
"properties, then set the 'ThresholdMethod' property to "
"'Between' to threshold between the lower and upper thresholds.")
# In 5.11, we changed the ParticleTracer/ParticlePath/StreakLine's the StaticMesh
# property to be called MeshOverTime since more capabilities were added.
if pname == "StaticMesh" and proxy.SMProxy.GetXMLName() in ["ParticleTracer, ParticlePath, StreakLine"]:
if paraview.compatibility.GetVersion() <= 5.10:
proxy.GetProperty("MeshOverTime").SetData(value)
raise Continue()
else:
raise NotSupportedException("'StaticMesh' is obsolete. Use 'MeshOverTime' property of " +
proxy.SMProxy.GetXMLName() + " filter instead.")
if not hasattr(proxy, pname):
raise AttributeError()
proxy.__dict__[pname] = value
raise Continue()
def setattr(proxy, pname, value):
"""
Attempts to emulate setattr() when called using a deprecated name for a
proxy property.
For properties that are no longer present on a proxy, the code should do the
following:
1. If `paraview.compatibility.GetVersion()` is less than the version in
which the property was removed, attempt to handle the request and raise
`Continue` to indicate that the request has been handled. If it is too
complicated to support the old API, then it is acceptable to raise
a warning message, but don't raise an exception.
2. If compatibility version is >= the version in which the property was
removed, raise `NotSupportedException` with details including suggestions
to update the script.
"""
version = paraview.compatibility.GetVersion()
if pname == "ColorAttributeType" and proxy.SMProxy.GetProperty("ColorArrayName"):
if paraview.compatibility.GetVersion() <= 4.1:
# set ColorAttributeType on ColorArrayName property instead.
caProp = proxy.GetProperty("ColorArrayName")
proxy.GetProperty("ColorArrayName").SetData((value, caProp[1]))
raise Continue()
else:
# if ColorAttributeType is being used, raise NotSupportedException.
raise NotSupportedException(
"'ColorAttributeType' is obsolete as of ParaView 4.2. Simply use 'ColorArrayName' "\
"instead. Refer to ParaView Python API changes documentation online.")
if pname == "AspectRatio" and proxy.SMProxy.GetProperty("ScalarBarThickness"):
if paraview.compatibility.GetVersion() <= 5.3:
# We can't do this perfectly, so we set the ScalarBarThickness
# property instead. Assume a reasonable modern screen size of
# 1280x1024 with a Render view size of 1000x600. Even if we had
# access to the View proxy to get the screen size, there is no
# guarantee that the view size will remain the same later on in the
# Python script.
span = 600 # vertical
if proxy.GetProperty("Orientation").GetData() == "Horizontal":
span = 1000
# Assume a scalar bar length 40% of the span.
thickness = 0.4 * span / value
proxy.GetProperty("ScalarBarThickness").SetData(int(thickness))
raise Continue()
else:
#if AspectRatio is being used, raise NotSupportedException
raise NotSupportedException(\
"'AspectRatio' is obsolete as of ParaView 5.4. Use the "\
"'ScalarBarThickness' property to set the width instead.")
if pname == "Position2" and proxy.SMProxy.GetProperty("ScalarBarLength"):
if paraview.compatibility.GetVersion() <= 5.3:
# The scalar bar length corresponds to Position2[0] when the
# orientation is horizontal and Position2[1] when the orientation
# is vertical.
length = value[0]
if proxy.Orientation == "Vertical":
length = value[1]
proxy.GetProperty("ScalarBarLength").SetData(length)
else:
#if Position2 is being used, raise NotSupportedException
raise NotSupportedException(\
"'Position2' is obsolete as of ParaView 5.4. Use the "\
"'ScalarBarLength' property to set the length instead.")
if pname == "LockScalarRange" and proxy.SMProxy.GetProperty("AutomaticRescaleRangeMode"):
if paraview.compatibility.GetVersion() <= 5.4:
if value:
from vtkmodules.vtkPVServerManagerRendering import vtkSMTransferFunctionManager
proxy.GetProperty("AutomaticRescaleRangeMode").SetData(vtkSMTransferFunctionManager.NEVER)
else:
pxm = proxy.SMProxy.GetSessionProxyManager()
settingsProxy = pxm.GetProxy("settings", "GeneralSettings")
mode = settingsProxy.GetProperty("TransferFunctionResetMode").GetElement(0)
proxy.GetProperty("AutomaticRescaleRangeMode").SetData(mode)
raise Continue()
else:
raise NotSupportedException(
"'LockScalarRange' is obsolete as of ParaView 5.5. Use "\
"'AutomaticRescaleRangeMode' property instead.")
# In 5.5, we changed the vtkArrayCalcualtor to use a different set of constants to control which
# data it operates on. This change changed the method and property name from AttributeMode to
# AttributeType
if pname == "AttributeMode" and proxy.SMProxy.GetXMLName() == "Calculator":
if paraview.compatibility.GetVersion() <= 5.4:
# The Attribute type uses enumeration values from vtkDataObject::AttributeTypes
# rather than custom constants for the calculator. For the values supported by
# ParaView before this change, the conversion works out to subtracting 1.
proxy.GetProperty("AttributeType").SetData(value - 1)
raise Continue()
else:
raise NotSupportedException(\
"'AttributeMode' is obsolete. Use 'AttributeType' property of Calculator filter instead.")
if pname == "UseOffscreenRenderingForScreenshots" and proxy.SMProxy.IsA("vtkSMViewProxy"):
if paraview.compatibility.GetVersion() <= 5.4:
raise Continue()
else:
raise NotSupportedException(\
"'UseOffscreenRenderingForScreenshots' is obsolete. Simply remove it from your script.")
if pname == "UseOffscreenRendering" and proxy.SMProxy.IsA("vtkSMViewProxy"):
if paraview.compatibility.GetVersion() <= 5.4:
raise Continue()
else:
raise NotSupportedException(\
"'UseOffscreenRendering' is obsolete. Simply remove it from your script.")
if proxy.SMProxy and proxy.SMProxy.GetXMLName() == "CGNSSeriesReader":
# in 5.5, CGNS reader had some changes. "BaseStatus", "FamilyStatus",
# "LoadBndPatch", and "LoadMesh" properties were removed.
if pname in ["LoadBndPatch", "LoadMesh", "BaseStatus", "FamilyStatus"]:
if paraview.compatibility.GetVersion() <= 5.4:
paraview.print_warning(\
"'%s' is no longer supported and will have no effect. "\
"Please use `Blocks` property to specify blocks to load." % pname)
raise Continue()
else:
raise NotSupportedException("'%s' is obsolete. Use the `Blocks` "\
"property to select blocks using SIL instead.")
if not hasattr(proxy, pname):
raise AttributeError()
proxy.__dict__[pname] = value
raise Continue()
def getattr(proxy, pname):
"""
Attempts to emulate getattr() when called using a deprecated property name
for a proxy.
Will return a *reasonable* stand-in if the property was
deprecated and the paraview compatibility version was set to a version older
than when the property was deprecated.
Will raise ``NotSupportedException`` if the property was deprecated and
paraview compatibility version is newer than that deprecation version.
Will raise ``Continue`` to indicate the property name is unaffected by
any API deprecation and the caller should follow normal code execution
paths.
"""
version = paraview.compatibility.GetVersion()
# In 4.2, we removed ColorAttributeType property. One is expected to use
# ColorArrayName to specify the attribute type as well.
if pname == "ColorAttributeType" and proxy.SMProxy.GetProperty("ColorArrayName"):
if version <= 4.1:
if proxy.GetProperty("ColorArrayName")[0] == "CELLS":
return "CELL_DATA"
else:
return "POINT_DATA"
else:
# if ColorAttributeType is being used, warn.
raise NotSupportedException(
"'ColorAttributeType' is obsolete. Simply use 'ColorArrayName' instead. Refer to ParaView Python API changes documentation online.")
# In 5.1, we removed CameraClippingRange property. It was not of any use
# since we added support to render view to automatically reset clipping
# range for each render.
if pname == "CameraClippingRange" and not proxy.SMProxy.GetProperty("CameraClippingRange"):
if version <= 5.0:
return [0.0, 0.0, 0.0]
else:
raise NotSupportedException(
'CameraClippingRange is obsolete. Please remove '\
'it from your script. You no longer need it.')
# In 5.1, we remove support for Cube Axes and related properties.
global _ACubeAxesHelper
if proxy.SMProxy.IsA("vtkSMPVRepresentationProxy") and hasattr(_ACubeAxesHelper, pname):
if version <= 5.0:
return _fgetattr(_ACubeAxesHelper, pname)
else:
raise NotSupportedException(
'Cube Axes and related properties are now obsolete. Please '\
'remove them from your script.')
# In 5.4, we removed the AspectRatio property and replaced it with the
# ScalarBarThickness property.
if pname == "AspectRatio" and proxy.SMProxy.GetProperty("ScalarBarThickness"):
if version <= 5.3:
return 20.0
else:
raise NotSupportedException(
'The AspectRatio property has been removed in ParaView '\
'5.4. Please use the ScalarBarThickness property instead '\
'to set the thickness in terms of points.')
# In 5.4, we removed the Position2 property and replaced it with the
# ScalarBarLength property.
if pname == "Position2" and proxy.SMProxy.GetProperty("ScalarBarLength"):
if version <= 5.3:
if proxy.GetProperty("Orientation").GetData() == "Horizontal":
return [0.05, proxy.GetProperty("ScalarBarLength").GetData()]
else:
return [proxy.GetProperty("ScalarBarLength").GetData(), 0.05]
else:
raise NotSupportedException(
'The Position2 property has been removed in ParaView '\
'5.4. Please set the ScalarBarLength property instead.')
# In 5.5, we removed the PVLookupTable.LockScalarRange boolean property and
# replaced it with the enumeration AutomaticRescaleRangeMode.
if pname == "LockScalarRange" and proxy.SMProxy.GetProperty("AutomaticRescaleRangeMode"):
if version <= 5.4:
from vtkmodules.vtkPVServerManagerRendering import vtkSMTransferFunctionManager
if proxy.GetProperty("AutomaticRescaleRangeMode").GetData() == "Never":
return 1
else:
return 0
else:
raise NotSupportedException(
'The PVLookupTable.LockScalarRange property has been removed '\
'in ParaView 5.5. Please set the AutomaticRescaleRangeMode property '\
'instead.')
# In 5.5, we changed the vtkArrayCalcualtor to use a different set of constants to control which
# data it operates on. This change changed the method and property name from AttributeMode to
# AttributeType
if pname == "AttributeMode" and proxy.SMProxy.GetName() == "Calculator":
if paraview.compatibility.GetVersion() <= 5.4:
# The Attribute type uses enumeration values from vtkDataObject::AttributeTypes
# rather than custom constants for the calculator. For the values supported by
# ParaView before this change, the conversion works out to adding 1.
value = proxy.GetProperty("AttributeType").GetData()
return value + 1
else:
raise NotSupportedException(
'The Calculator.AttributeMode property has been removed in ParaView 5.5. '\
'Please set the AttributeType property instead. Note that different '\
'constants are needed for the two properties.')
if pname == "UseOffscreenRenderingForScreenshots" and proxy.SMProxy.IsA("vtkSMViewProxy"):
if version <= 5.4:
return 0
else:
raise NotSupportedException('`UseOffscreenRenderingForScreenshots` '\
'is no longer supported. Please remove it.')
if pname == "UseOffscreenRendering" and proxy.SMProxy.IsA("vtkSMViewProxy"):
if version <= 5.4:
return 0
else:
raise NotSupportedException(\
'`UseOffscreenRendering` is no longer supported. Please remove it.')
if proxy.SMProxy.GetXMLName() == "CGNSSeriesReader" and\
pname in ["LoadBndPatch", "LoadMesh", "BaseStatus", "FamilyStatus"]:
if version < 5.5:
if pname in ["LoadMesh", "LoadBndPatch"]:
return 0
else:
paraview.print_warning(\
"'%s' is no longer supported and will have no effect. "\
"Please use `Blocks` property to specify blocks to load." % pname)
return []
else:
raise NotSupportedException(\
"'%s' is obsolete. Use `Blocks` to make block based selection." % pname)
raise Continue()
def getattr(proxy, pname):
"""
Attempts to emulate getattr() when called using a deprecated property name
for a proxy.
Will return a *reasonable* stand-in if the property was
deprecated and the paraview compatibility version was set to a version older
than when the property was deprecated.
Will raise ``NotSupportedException`` if the property was deprecated and
paraview compatibility version is newer than that deprecation version.
Will raise ``Continue`` to indicate the property name is unaffected by
any API deprecation and the caller should follow normal code execution
paths.
"""
version = paraview.compatibility.GetVersion()
# In 4.2, we removed ColorAttributeType property. One is expected to use
# ColorArrayName to specify the attribute type as well.
if pname == "ColorAttributeType" and proxy.SMProxy.GetProperty(
"ColorArrayName"):
if version <= 4.1:
if proxy.GetProperty("ColorArrayName")[0] == "CELLS":
return "CELL_DATA"
else:
return "POINT_DATA"
else:
# if ColorAttributeType is being used, warn.
raise NotSupportedException(
"'ColorAttributeType' is obsolete. Simply use 'ColorArrayName' instead. Refer to ParaView Python API changes documentation online."
)
# In 5.1, we removed CameraClippingRange property. It was not of any use
# since we added support to render view to automatically reset clipping
# range for each render.
if pname == "CameraClippingRange" and not proxy.SMProxy.GetProperty(
"CameraClippingRange"):
if version <= 5.0:
return [0.0, 0.0, 0.0]
else:
raise NotSupportedException(
'CameraClippingRange is obsolete. Please remove '\
'it from your script. You no longer need it.')
# In 5.1, we remove support for Cube Axes and related properties.
global _ACubeAxesHelper
if proxy.SMProxy.IsA("vtkSMPVRepresentationProxy") and hasattr(
_ACubeAxesHelper, pname):
if version <= 5.0:
return _fgetattr(_ACubeAxesHelper, pname)
else:
raise NotSupportedException(
'Cube Axes and related properties are now obsolete. Please '\
'remove them from your script.')
# In 5.4, we removed the AspectRatio property and replaced it with the
# ScalarBarThickness property.
if pname == "AspectRatio" and proxy.SMProxy.GetProperty(
"ScalarBarThickness"):
if version <= 5.3:
return 20.0
else:
raise NotSupportedException(
'The AspectRatio property has been removed in ParaView '\
'5.4. Please use the ScalarBarThickness property instead '\
'to set the thickness in terms of points.')
# In 5.4, we removed the Position2 property and replaced it with the
# ScalarBarLength property.
if pname == "Position2" and proxy.SMProxy.GetProperty("ScalarBarLength"):
if version <= 5.3:
if proxy.GetProperty("Orientation").GetData() == "Horizontal":
return [0.05, proxy.GetProperty("ScalarBarLength").GetData()]
else:
return [proxy.GetProperty("ScalarBarLength").GetData(), 0.05]
else:
raise NotSupportedException(
'The Position2 property has been removed in ParaView '\
'5.4. Please set the ScalarBarLength property instead.')
# In 5.5, we removed the PVLookupTable.LockScalarRange boolean property and
# replaced it with the enumeration AutomaticRescaleRangeMode.
if pname == "LockScalarRange" and proxy.SMProxy.GetProperty(
"AutomaticRescaleRangeMode"):
if version <= 5.4:
from paraview.modules.vtkPVServerManagerRendering import vtkSMTransferFunctionManager
if proxy.GetProperty(
"AutomaticRescaleRangeMode").GetData() == "Never":
return 1
else:
return 0
else:
raise NotSupportedException(
'The PVLookupTable.LockScalarRange property has been removed '\
'in ParaView 5.5. Please set the AutomaticRescaleRangeMode property '\
'instead.')
# In 5.5, we changed the vtkArrayCalculator to use a different set of constants to control which
# data it operates on. This change changed the method and property name from AttributeMode to
# AttributeType
if pname == "AttributeMode" and proxy.SMProxy.GetName() == "Calculator":
if paraview.compatibility.GetVersion() <= 5.4:
# The Attribute type uses enumeration values from vtkDataObject::AttributeTypes
# rather than custom constants for the calculator. For the values supported by
# ParaView before this change, the conversion works out to adding 1 if it is an
# integer. If the value is an enumerated string we use that as is since it matches
# the previous enumerated string options.
value = proxy.GetProperty("AttributeType").GetData()
if isinstance(value, int):
return value + 1
return value
else:
raise NotSupportedException(
'The Calculator.AttributeMode property has been removed in ParaView 5.5. '\
'Please set the AttributeType property instead. Note that different '\
'constants are needed for the two properties.')
if pname == "UseOffscreenRenderingForScreenshots" and proxy.SMProxy.IsA(
"vtkSMViewProxy"):
if version <= 5.4:
return 0
else:
raise NotSupportedException('`UseOffscreenRenderingForScreenshots` '\
'is no longer supported. Please remove it.')
if pname == "UseOffscreenRendering" and proxy.SMProxy.IsA(
"vtkSMViewProxy"):
if version <= 5.4:
return 0
else:
raise NotSupportedException(\
'`UseOffscreenRendering` is no longer supported. Please remove it.')
if proxy.SMProxy.GetXMLName() == "CGNSSeriesReader" and\
pname in ["LoadBndPatch", "LoadMesh", "BaseStatus", "FamilyStatus"]:
if version < 5.5:
if pname in ["LoadMesh", "LoadBndPatch"]:
return 0
else:
paraview.print_warning(\
"'%s' is no longer supported and will have no effect. "\
"Please use `Blocks` property to specify blocks to load." % pname)
return []
else:
raise NotSupportedException(\
"'%s' is obsolete. Use `Blocks` to make block based selection." % pname)
# In 5.5, we removed the DataBoundsInflateFactor property and replaced it with the
# DataBoundsScaleFactor property.
if pname == "DataBoundsInflateFactor" and proxy.SMProxy.GetProperty(
"DataBoundsScaleFactor"):
if version <= 5.4:
inflateValue = proxy.GetProperty(
"DataBoundsScaleFactor").GetData() - 1
if inflateValue >= 0:
return inflateValue
else:
return 0
else:
raise NotSupportedException(
'The DataBoundsInflateFactorproperty has been removed in ParaView '\
'5.4. Please use the DataBoundsScaleFactor property instead.')
if proxy.SMProxy and proxy.SMProxy.GetXMLName() == "AnnotateAttributeData":
# in 5.5, Annotate Attribute Data changed how it sets the array to annotate
if pname == "ArrayAssociation":
if paraview.compatibility.GetVersion() <= 5.4:
paraview.print_warning(\
"'ArrayAssociation' is obsolete. Use 'SelectInputArray' property of AnnotateAttributeData instead.")
value = proxy.GetProperty("SelectInputArray")[0]
if value == "CELLS":
return "Cell Data"
elif value == "FIELD":
return "Field Data"
elif value == "ROWS":
return "Row Data"
else:
return "Point Data"
else:
raise NotSupportedException(\
"'ArrayAssociation' is obsolete as of ParaView 5.5. Use 'SelectInputArray' instead.")
elif pname == "ArrayName":
if paraview.compatibility.GetVersion() <= 5.4:
paraview.print_warning(\
"'ArrayName' is obsolete. Use 'SelectInputArray' property of AnnotateAttributeData instead.")
return proxy.GetProperty("SelectInputArray")[1]
else:
raise NotSupportedException(\
"'ArrayName' is obsolete as of ParaView 5.5. Use 'SelectInputArray' instead.")
# In 5.5, we changed the Clip to be inverted from what it was before and changed the InsideOut
# property to be called Invert to be clearer.
if pname == "InsideOut" and proxy.SMProxy.GetXMLName() == "Clip":
if paraview.compatibility.GetVersion() <= 5.4:
return proxy.GetProperty("Invert").GetData()
else:
raise NotSupportedException(
'The Clip.InsideOut property has been changed in ParaView 5.5. '\
'Please set the Invert property instead.')
# In 5.6, we changed the "SpreadSheetRepresentation" proxy to no longer have
# the "FieldAssociation" and "GenerateCellConnectivity" properties. They are
# now moved to the view.
if pname in [
"FieldAssociation", "GenerateCellConnectivity"
] and proxy.SMProxy.GetXMLName() == "SpreadSheetRepresentation":
if paraview.compatibility.GetVersion() <= 5.5:
return 0
else:
raise NotSupportedException(
"'%s' is obsolete on SpreadSheetRepresentation as of ParaView 5.6 and has been migrated to the view."
% pname)
# In 5.7, we changed to the names of the input proxies in ResampleWithDataset to clarify what
# each source does.
if pname == "Input" and proxy.SMProxy.GetXMLName(
) == "ResampleWithDataset":
if paraview.compatibility.GetVersion() < 5.7:
return proxy.GetProperty("SourceDataArrays")
else:
raise NotSupportedException(
'The ResampleWithDataset.Input property has been changed in ParaView 5.7. '\
'Please access the SourceDataArrays property instead.')
if pname == "Source" and proxy.SMProxy.GetXMLName(
) == "ResampleWithDataset":
if paraview.compatibility.GetVersion() < 5.7:
return proxy.GetProperty("DestinationMesh")
else:
raise NotSupportedException(
'The ResampleWithDataset.Source property has been changed in ParaView 5.7. '\
'Please access the DestinationMesh property instead.')
# In 5.7, we removed `ArrayName` property on the `GenerateIdScalars` filter
# and replaced it with `CellIdsArrayName` and `PointIdsArrayName`.
if pname == "ArrayName" and proxy.SMProxy.GetXMLName(
) == "GenerateIdScalars":
if paraview.compatibility.GetVersion() < 5.7:
return proxy.GetProperty("PointIdsArrayName")
else:
raise NotSupportedException(
'The GenerateIdScalars.ArrayName property has been removed in ParaView 5.7. ' \
'Please access `PointIdsArrayName` or `CellIdsArrayName` property instead.')
raise Continue()
def getattr(proxy, pname):
"""
Attempts to emulate getattr() when called using a deprecated property name
for a proxy.
Will return a *reasonable* stand-in if the property was
deprecated and the paraview compatibility version was set to a version older
than when the property was deprecated.
Will raise ``NotSupportedException`` if the property was deprecated and
paraview compatibility version is newer than that deprecation version.
Will raise ``Continue`` to indicate the property name is unaffected by
any API deprecation and the caller should follow normal code execution
paths.
"""
version = paraview.compatibility.GetVersion()
# In 4.2, we removed ColorAttributeType property. One is expected to use
# ColorArrayName to specify the attribute type as well.
if pname == "ColorAttributeType" and proxy.SMProxy.GetProperty("ColorArrayName"):
if version <= 4.1:
if proxy.GetProperty("ColorArrayName")[0] == "CELLS":
return "CELL_DATA"
else:
return "POINT_DATA"
else:
# if ColorAttributeType is being used, warn.
raise NotSupportedException(
"'ColorAttributeType' is obsolete. Simply use 'ColorArrayName' instead. Refer to ParaView Python API changes documentation online.")
# In 5.1, we removed CameraClippingRange property. It was not of any use
# since we added support to render view to automatically reset clipping
# range for each render.
if pname == "CameraClippingRange" and not proxy.SMProxy.GetProperty("CameraClippingRange"):
if version <= 5.0:
return [0.0, 0.0, 0.0]
else:
raise NotSupportedException(
'CameraClippingRange is obsolete. Please remove '\
'it from your script. You no longer need it.')
# In 5.1, we remove support for Cube Axes and related properties.
global _ACubeAxesHelper
if proxy.SMProxy.IsA("vtkSMPVRepresentationProxy") and hasattr(_ACubeAxesHelper, pname):
if version <= 5.0:
return _fgetattr(_ACubeAxesHelper, pname)
else:
raise NotSupportedException(
'Cube Axes and related properties are now obsolete. Please '\
'remove them from your script.')
# In 5.4, we removed the AspectRatio property and replaced it with the
# ScalarBarThickness property.
if pname == "AspectRatio" and proxy.SMProxy.GetProperty("ScalarBarThickness"):
if version <= 5.3:
return 20.0
else:
raise NotSupportedException(
'The AspectRatio property has been removed in ParaView '\
'5.4. Please use the ScalarBarThickness property instead '\
'to set the thickness in terms of points.')
# In 5.4, we removed the Position2 property and replaced it with the
# ScalarBarLength property.
if pname == "Position2" and proxy.SMProxy.GetProperty("ScalarBarLength"):
if version <= 5.3:
if proxy.GetProperty("Orientation").GetData() == "Horizontal":
return [0.05, proxy.GetProperty("ScalarBarLength").GetData()]
else:
return [proxy.GetProperty("ScalarBarLength").GetData(), 0.05]
else:
raise NotSupportedException(
'The Position2 property has been removed in ParaView '\
'5.4. Please set the ScalarBarLength property instead.')
# In 5.5, we removed the PVLookupTable.LockScalarRange boolean property and
# replaced it with the enumeration AutomaticRescaleRangeMode.
if pname == "LockScalarRange" and proxy.SMProxy.GetProperty("AutomaticRescaleRangeMode"):
if version <= 5.4:
from vtkmodules.vtkPVServerManagerRendering import vtkSMTransferFunctionManager
if proxy.GetProperty("AutomaticRescaleRangeMode").GetData() == "Never":
return 1
else:
return 0
else:
raise NotSupportedException(
'The PVLookupTable.LockScalarRange property has been removed '\
'in ParaView 5.5. Please set the AutomaticRescaleRangeMode property '\
'instead.')
# In 5.5, we changed the vtkArrayCalculator to use a different set of constants to control which
# data it operates on. This change changed the method and property name from AttributeMode to
# AttributeType
if pname == "AttributeMode" and proxy.SMProxy.GetName() == "Calculator":
if paraview.compatibility.GetVersion() <= 5.4:
# The Attribute type uses enumeration values from vtkDataObject::AttributeTypes
# rather than custom constants for the calculator. For the values supported by
# ParaView before this change, the conversion works out to adding 1 if it is an
# integer. If the value is an enumerated string we use that as is since it matches
# the previous enumerated string options.
value = proxy.GetProperty("AttributeType").GetData()
if isinstance(value, int):
return value + 1
return value
else:
raise NotSupportedException(
'The Calculator.AttributeMode property has been removed in ParaView 5.5. '\
'Please set the AttributeType property instead. Note that different '\
'constants are needed for the two properties.')
if pname == "UseOffscreenRenderingForScreenshots" and proxy.SMProxy.IsA("vtkSMViewProxy"):
if version <= 5.4:
return 0
else:
raise NotSupportedException('`UseOffscreenRenderingForScreenshots` '\
'is no longer supported. Please remove it.')
if pname == "UseOffscreenRendering" and proxy.SMProxy.IsA("vtkSMViewProxy"):
if version <= 5.4:
return 0
else:
raise NotSupportedException(\
'`UseOffscreenRendering` is no longer supported. Please remove it.')
if proxy.SMProxy.GetXMLName() == "CGNSSeriesReader" and\
pname in ["LoadBndPatch", "LoadMesh", "BaseStatus", "FamilyStatus"]:
if version < 5.5:
if pname in ["LoadMesh", "LoadBndPatch"]:
return 0
else:
paraview.print_warning(\
"'%s' is no longer supported and will have no effect. "\
"Please use `Blocks` property to specify blocks to load." % pname)
return []
else:
raise NotSupportedException(\
"'%s' is obsolete. Use `Blocks` to make block based selection." % pname)
# In 5.5, we removed the DataBoundsInflateFactor property and replaced it with the
# DataBoundsScaleFactor property.
if pname == "DataBoundsInflateFactor" and proxy.SMProxy.GetProperty("DataBoundsScaleFactor"):
if version <= 5.4:
inflateValue = proxy.GetProperty("DataBoundsScaleFactor").GetData() - 1
if inflateValue >= 0:
return inflateValue
else:
return 0
else:
raise NotSupportedException(
'The DataBoundsInflateFactorproperty has been removed in ParaView '\
'5.4. Please use the DataBoundsScaleFactor property instead.')
if proxy.SMProxy and proxy.SMProxy.GetXMLName() == "AnnotateAttributeData":
# in 5.5, Annotate Attribute Data changed how it sets the array to annotate
if pname == "ArrayAssociation":
if paraview.compatibility.GetVersion() <= 5.4:
paraview.print_warning(\
"'ArrayAssociation' is obsolete. Use 'SelectInputArray' property of AnnotateAttributeData instead.")
value = proxy.GetProperty("SelectInputArray")[0]
if value == "CELLS":
return "Cell Data"
elif value == "FIELD":
return "Field Data"
elif value == "ROWS":
return "Row Data"
else:
return "Point Data"
else:
raise NotSupportedException(\
"'ArrayAssociation' is obsolete as of ParaView 5.5. Use 'SelectInputArray' instead.")
elif pname == "ArrayName":
if paraview.compatibility.GetVersion() <= 5.4:
paraview.print_warning(\
"'ArrayName' is obsolete. Use 'SelectInputArray' property of AnnotateAttributeData instead.")
return proxy.GetProperty("SelectInputArray")[1]
else:
raise NotSupportedException(\
"'ArrayName' is obsolete as of ParaView 5.5. Use 'SelectInputArray' instead.")
# In 5.5, we changed the Clip to be inverted from what it was before and changed the InsideOut
# property to be called Invert to be clearer.
if pname == "InsideOut" and proxy.SMProxy.GetName() == "Clip":
if paraview.compatibility.GetVersion() <= 5.4:
return proxy.GetProperty("Invert").GetData()
else:
raise NotSupportedException(
'The Clip.InsideOut property has been changed in ParaView 5.5. '\
'Please set the Invert property instead.')
raise Continue()
def setattr(proxy, pname, value):
"""
Attempts to emulate setattr() when called using a deprecated name for a
proxy property.
For properties that are no longer present on a proxy, the code should do the
following:
1. If `paraview.compatibility.GetVersion()` is less than the version in
which the property was removed, attempt to handle the request and raise
`Continue` to indicate that the request has been handled. If it is too
complicated to support the old API, then it is acceptable to raise
a warning message, but don't raise an exception.
2. If compatibility version is >= the version in which the property was
removed, raise `NotSupportedException` with details including suggestions
to update the script.
"""
version = paraview.compatibility.GetVersion()
if pname == "ColorAttributeType" and proxy.SMProxy.GetProperty(
"ColorArrayName"):
if paraview.compatibility.GetVersion() <= 4.1:
# set ColorAttributeType on ColorArrayName property instead.
caProp = proxy.GetProperty("ColorArrayName")
proxy.GetProperty("ColorArrayName").SetData((value, caProp[1]))
raise Continue()
else:
# if ColorAttributeType is being used, raise NotSupportedException.
raise NotSupportedException(
"'ColorAttributeType' is obsolete as of ParaView 4.2. Simply use 'ColorArrayName' "\
"instead. Refer to ParaView Python API changes documentation online.")
if pname == "AspectRatio" and proxy.SMProxy.GetProperty(
"ScalarBarThickness"):
if paraview.compatibility.GetVersion() <= 5.3:
# We can't do this perfectly, so we set the ScalarBarThickness
# property instead. Assume a reasonable modern screen size of
# 1280x1024 with a Render view size of 1000x600. Even if we had
# access to the View proxy to get the screen size, there is no
# guarantee that the view size will remain the same later on in the
# Python script.
span = 600 # vertical
if proxy.GetProperty("Orientation").GetData() == "Horizontal":
span = 1000
# Assume a scalar bar length 40% of the span.
thickness = 0.4 * span / value
proxy.GetProperty("ScalarBarThickness").SetData(int(thickness))
raise Continue()
else:
#if AspectRatio is being used, raise NotSupportedException
raise NotSupportedException(\
"'AspectRatio' is obsolete as of ParaView 5.4. Use the "\
"'ScalarBarThickness' property to set the width instead.")
if pname == "Position2" and proxy.SMProxy.GetProperty("ScalarBarLength"):
if paraview.compatibility.GetVersion() <= 5.3:
# The scalar bar length corresponds to Position2[0] when the
# orientation is horizontal and Position2[1] when the orientation
# is vertical.
length = value[0]
if proxy.Orientation == "Vertical":
length = value[1]
proxy.GetProperty("ScalarBarLength").SetData(length)
else:
#if Position2 is being used, raise NotSupportedException
raise NotSupportedException(\
"'Position2' is obsolete as of ParaView 5.4. Use the "\
"'ScalarBarLength' property to set the length instead.")
if pname == "LockScalarRange" and proxy.SMProxy.GetProperty(
"AutomaticRescaleRangeMode"):
if paraview.compatibility.GetVersion() <= 5.4:
if value:
from paraview.modules.vtkPVServerManagerRendering import vtkSMTransferFunctionManager
proxy.GetProperty("AutomaticRescaleRangeMode").SetData(
vtkSMTransferFunctionManager.NEVER)
else:
pxm = proxy.SMProxy.GetSessionProxyManager()
settingsProxy = pxm.GetProxy("settings", "GeneralSettings")
mode = settingsProxy.GetProperty(
"TransferFunctionResetMode").GetElement(0)
proxy.GetProperty("AutomaticRescaleRangeMode").SetData(mode)
raise Continue()
else:
raise NotSupportedException(
"'LockScalarRange' is obsolete as of ParaView 5.5. Use "\
"'AutomaticRescaleRangeMode' property instead.")
# In 5.5, we changed the vtkArrayCalculator to use a different set of constants to control which
# data it operates on. This change changed the method and property name from AttributeMode to
# AttributeType
if pname == "AttributeMode" and proxy.SMProxy.GetXMLName() == "Calculator":
if paraview.compatibility.GetVersion() <= 5.4:
# The Attribute type uses enumeration values from vtkDataObject::AttributeTypes
# rather than custom constants for the calculator. For the values supported by
# ParaView before this change, the conversion works out to subtracting 1 if value
# is an integer. If value is an enumerated string we use that as is since it matches
# the previous enumerated string options.
if isinstance(value, int):
proxy.GetProperty("AttributeType").SetData(value - 1)
else:
proxy.GetProperty("AttributeType").SetData(value)
raise Continue()
else:
raise NotSupportedException(\
"'AttributeMode' is obsolete. Use 'AttributeType' property of Calculator filter instead.")
if pname == "UseOffscreenRenderingForScreenshots" and proxy.SMProxy.IsA(
"vtkSMViewProxy"):
if paraview.compatibility.GetVersion() <= 5.4:
raise Continue()
else:
raise NotSupportedException(\
"'UseOffscreenRenderingForScreenshots' is obsolete. Simply remove it from your script.")
if pname == "UseOffscreenRendering" and proxy.SMProxy.IsA(
"vtkSMViewProxy"):
if paraview.compatibility.GetVersion() <= 5.4:
raise Continue()
else:
raise NotSupportedException(\
"'UseOffscreenRendering' is obsolete. Simply remove it from your script.")
if proxy.SMProxy and proxy.SMProxy.GetXMLName() == "CGNSSeriesReader":
# in 5.5, CGNS reader had some changes. "BaseStatus", "FamilyStatus",
# "LoadBndPatch", and "LoadMesh" properties were removed.
if pname in ["LoadBndPatch", "LoadMesh", "BaseStatus", "FamilyStatus"]:
if paraview.compatibility.GetVersion() <= 5.4:
paraview.print_warning(\
"'%s' is no longer supported and will have no effect. "\
"Please use `Blocks` property to specify blocks to load." % pname)
raise Continue()
else:
raise NotSupportedException("'%s' is obsolete. Use the `Blocks` "\
"property to select blocks using SIL instead.")
if pname == "DataBoundsInflateFactor" and proxy.SMProxy.GetProperty(
"DataBoundsScaleFactor"):
if paraview.compatibility.GetVersion() <= 5.4:
# In 5.5, The axes grid data bounds inflate factor have been
# translated by 1 to become the scale factor.
proxy.GetProperty("DataBoundsScaleFactor").SetData(value + 1)
else:
#if inflat factor is being used, raise NotSupportedException
raise NotSupportedException(\
"'DataBoundsInflateFactor' is obsolete as of ParaView 5.5. Use the "\
"'DataBoundsScaleFactor' property to modify the axes gris data bounds instead.")
if proxy.SMProxy and proxy.SMProxy.GetXMLName() == "AnnotateAttributeData":
# in 5.5, Annotate Attribute Data changed how it sets the array to annotate
if pname == "ArrayAssociation":
if paraview.compatibility.GetVersion() <= 5.4:
paraview.print_warning(\
"'ArrayAssociation' is obsolete. Use 'SelectInputArray' property of AnnotateAttributeData instead.")
if value == "Point Data":
value = "POINTS"
elif value == "Cell Data":
value = "CELLS"
elif value == "Field Data":
value = "FIELD"
elif value == "Row Data":
value = "ROWS"
arrayProp = proxy.GetProperty("SelectInputArray")
proxy.GetProperty("SelectInputArray").SetData(
(value, arrayProp[1]))
raise Continue()
else:
raise NotSupportedException(\
"'ArrayAssociation' is obsolete as of ParaView 5.5. Use 'SelectInputArray' instead.")
elif pname == "ArrayName":
if paraview.compatibility.GetVersion() <= 5.4:
paraview.print_warning(\
"'ArrayName' is obsolete. Use 'SelectInputArray' property of AnnotateAttributeData instead.")
arrayProp = proxy.GetProperty("SelectInputArray")
proxy.GetProperty("SelectInputArray").SetData(
(arrayProp[0], value))
raise Continue()
else:
raise NotSupportedException(\
"'ArrayName' is obsolete as of ParaView 5.5. Use 'SelectInputArray' instead.")
# In 5.5, we changed the Clip to be inverted from what it was before and changed the InsideOut
# property to be called Invert to be clearer.
if pname == "InsideOut" and proxy.SMProxy.GetXMLName() == "Clip":
if paraview.compatibility.GetVersion() <= 5.4:
proxy.GetProperty("Invert").SetData(1 - value)
raise Continue()
else:
raise NotSupportedException(\
"'InsideOut' is obsolete. Use 'Invert' property of Clip filter instead.")
# In 5.6, we changed the "SpreadSheetRepresentation" proxy to no longer have
# the "FieldAssociation" and "GenerateCellConnectivity" properties. They are
# now moved to the view.
if pname in [
"FieldAssociation", "GenerateCellConnectivity"
] and proxy.SMProxy.GetXMLName() == "SpreadSheetRepresentation":
if paraview.compatibility.GetVersion() <= 5.5:
raise Continue()
else:
raise NotSupportedException(
"'%s' is obsolete on SpreadSheetRepresentation as of ParaView 5.6 and has been migrated to the view."
% pname)
# In 5.7, we changed to the names of the input proxies in ResampleWithDataset to clarify what
# each source does.
if pname == "Input" and proxy.SMProxy.GetXMLName(
) == "ResampleWithDataset":
if paraview.compatibility.GetVersion() < 5.7:
proxy.GetProperty("SourceDataArrays").SetData(value)
raise Continue()
else:
raise NotSupportedException(
'The ResampleWithDataset.Input property has been changed in ParaView 5.7. '\
'Please set the SourceDataArrays property instead.')
if pname == "Source" and proxy.SMProxy.GetXMLName(
) == "ResampleWithDataset":
if paraview.compatibility.GetVersion() < 5.7:
proxy.GetProperty("DestinationMesh").SetData(value)
raise Continue()
else:
raise NotSupportedException(
'The ResampleWithDataset.Source property has been changed in ParaView 5.7. '\
'Please set the DestinationMesh property instead.')
# In 5.7, we removed `ArrayName` property on the `GenerateIdScalars` filter
# and replaced it with `CellIdsArrayName` and `PointIdsArrayName`.
if pname == "ArrayName" and proxy.SMProxy.GetXMLName(
) == "GenerateIdScalars":
if paraview.compatibility.GetVersion() < 5.7:
proxy.GetProperty("PointIdsArrayName").SetData(value)
proxy.GetProperty("CellIdsArrayName").SetData(value)
raise Continue()
else:
raise NotSupportedException(
'The GenerateIdScalars.ArrayName property has been removed in ParaView 5.7. '\
'Please set `PointIdsArrayName` or `CellIdsArrayName` property instead.')
if not hasattr(proxy, pname):
raise AttributeError()
proxy.__dict__[pname] = value
raise Continue()
p1.UnRegister(None)
cls1 = c.ProxiesNS.getClass(p1)
p2 = smpxm.NewProxy("animation_writers", "PNG")
p2.UnRegister(None)
cls2 = c.ProxiesNS.getClass(p2)
assert cls1 is not cls2
#==============================================================================
# create a proxy not in one of the standard proxy groups.
assert not hasattr(c.ProxiesNS, "delivery_managers")
dm = smpxm.NewProxy("delivery_managers", "RenderViewDeliveryManager")
dm.UnRegister(None)
cls = c.ProxiesNS.getClass(dm)
assert cls is not None
help(cls)
try:
simple.LoadDistributedPlugin("Moments")
test_plugin = True
except RuntimeError:
print_warning("Moments plugin cannot be loaded. Skipping plugin testing")
test_plugin = False
if test_plugin:
assert "MomentVectors" in dir(c.ProxiesNS.filters)
mv = simple.MomentVectors()
