get_valid_values(...) - get_valid_values(...) - 2026.1 English - UG1781

Python Scripting Guide for PDM Tool (UG1781)

Document_ID
UG1781
Release_Date
2026-06-23
Version
2026.1 English
Revision

Description

Get dictionary of specified record names mapped to dictionaries of specified writable field names to list/range of valid values mappings. Read-only fields are excluded even if specified.

Syntax

get_valid_values([<field_names>], [<record_names>])

Returns

Dictionary in a format {record: {field: [valid_value, ...], ...}, ...}.

Parameters

Name Description
[<field_names>] List of field names.

Default: All fields

[<record_names>] List of record names.

Default: All records

Examples

# Get valid values for all writable fields of a summary
proj = new_project('my_design.pdm', part='XC2VE3558-SSVA1440-2LP-E-S')
summary = proj.get_power_design().get_summary('power_rail_characteristics')
# Get valid values for specific fields only
valid = summary.get_valid_values(['power_rail_group'],['VCCIO_MIPI'])
# valid == {'VCCIO_MIPI': {'power_rail_group': ['1V8_VCCO_SOC (Digital)', '1V2_VCCO_SOC (Digital)']}}