luke
/
klayout
mirror of https://github.com/KLayout/klayout.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

Implemented #429: final touches to doc and tests for RBA/pya API.

This commit is contained in:
Matthias Koefferlein 2019-12-01 16:41:27 +01:00
parent 152dc87682
commit baffb940d1
6 changed files with 100 additions and 42 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

9
src/db/db/gsiDeclDbCommonStreamOptions.cc
View File

@ -89,15 +89,15 @@ static
gsi::ClassExt<db::LoadLayoutOptions> common_reader_options (
gsi::method_ext ("set_layer_map", &set_layer_map, gsi::arg ("map"), gsi::arg ("create_other_layers"),
"@brief Sets the layer map\n"
"This sets a layer mapping for the reader. The \"create_other_layers\" specifies whether to create layers that are not "
"in the mapping and automatically assign layers to them.\n"
"This sets a layer mapping for the reader. The layer map allows selection and translation of the original layers, for example to add a layer name.\n"
"@param map The layer map to set."
"@param create_other_layers The flag telling whether other layer should be created also. Set to false if just the layers in the mapping table should be read.\n"
"@param create_other_layers The flag telling whether other layer should be created as well. Set to false if just the layers in the mapping table should be read.\n"
"\n"
"Starting with version 0.25 this option only applies to GDS2 and OASIS format. Other formats provide their own configuration."
) +
gsi::method_ext ("layer_map=", &set_layer_map1, gsi::arg ("map"),
"@brief Sets the layer map, but does not affect the \"create_other_layers\" flag.\n"
"Use \\create_other_layers? to enable or disable other layers not listed in the layer map.\n"
"@param map The layer map to set."
"\n"
"This convenience method has been introduced with version 0.26."
@ -121,12 +121,15 @@ gsi::ClassExt<db::LoadLayoutOptions> common_reader_options (
gsi::method_ext ("create_other_layers?", &create_other_layers,
"@brief Gets a value indicating whether other layers shall be created\n"
"@return True, if other layers should be created.\n"
"This attribute acts together with a layer map (see \\layer_map=). Layers not listed in this map are created as well when "
"\\create_other_layers? is true. Otherwise they are ignored.\n"
"\n"
"Starting with version 0.25 this option only applies to GDS2 and OASIS format. Other formats provide their own configuration."
) +
gsi::method_ext ("create_other_layers=", &set_create_other_layers, gsi::arg ("create"),
"@brief Specifies whether other layers shall be created\n"
"@param create True, if other layers should be created.\n"
"See \\create_other_layers? for a description of this attribute.\n"
"\n"
"Starting with version 0.25 this option only applies to GDS2 and OASIS format. Other formats provide their own configuration."
) +

16
src/plugins/streamers/cif/db_plugin/gsiDeclDbCIF.cc
View File

@ -100,10 +100,9 @@ static
gsi::ClassExt<db::LoadLayoutOptions> cif_reader_options (
gsi::method_ext ("cif_set_layer_map", &set_layer_map, gsi::arg ("map"), gsi::arg ("create_other_layers"),
"@brief Sets the layer map\n"
"This sets a layer mapping for the reader. The \"create_other_layers\" specifies whether to create layers that are not "
"in the mapping and automatically assign layers to them.\n"
"@param map The layer map to set."
"@param create_other_layers The flag telling whether other layer should be created also. Set to false if just the layers in the mapping table should be read.\n"
"This sets a layer mapping for the reader. The layer map allows selection and translation of the original layers, for example to assign layer/datatype numbers to the named layers.\n"
"@param map The layer map to set.\n"
"@param create_other_layers The flag indicating whether other layers will be created as well. Set to false to read only the layers in the layer map.\n"
"\n"
"This method has been added in version 0.25 and replaces the respective global option in \\LoadLayoutOptions "
"in a format-specific fashion."
@ -111,7 +110,7 @@ gsi::ClassExt<db::LoadLayoutOptions> cif_reader_options (
gsi::method_ext ("cif_layer_map=", &set_layer_map1, gsi::arg ("map"),
"@brief Sets the layer map\n"
"This sets a layer mapping for the reader. Unlike \\cif_set_layer_map, the 'create_other_layers' flag is not changed.\n"
"@param map The layer map to set."
"@param map The layer map to set.\n"
"\n"
"This convenience method has been added in version 0.26."
) +
@ -135,14 +134,17 @@ gsi::ClassExt<db::LoadLayoutOptions> cif_reader_options (
) +
gsi::method_ext ("cif_create_other_layers?", &create_other_layers,
"@brief Gets a value indicating whether other layers shall be created\n"
"@return True, if other layers should be created.\n"
"@return True, if other layers will be created.\n"
"This attribute acts together with a layer map (see \\cif_layer_map=). Layers not listed in this map are created as well when "
"\\cif_create_other_layers? is true. Otherwise they are ignored.\n"
"\n"
"This method has been added in version 0.25 and replaces the respective global option in \\LoadLayoutOptions "
"in a format-specific fashion."
) +
gsi::method_ext ("cif_create_other_layers=", &set_create_other_layers, gsi::arg ("create"),
"@brief Specifies whether other layers shall be created\n"
"@param create True, if other layers should be created.\n"
"@param create True, if other layers will be created.\n"
"See \\cif_create_other_layers? for a description of this attribute.\n"
"\n"
"This method has been added in version 0.25 and replaces the respective global option in \\LoadLayoutOptions "
"in a format-specific fashion."

16
src/plugins/streamers/dxf/db_plugin/gsiDeclDbDXF.cc
View File

@ -174,10 +174,9 @@ static
gsi::ClassExt<db::LoadLayoutOptions> dxf_reader_options (
gsi::method_ext ("dxf_set_layer_map", &set_layer_map, gsi::arg ("map"), gsi::arg ("create_other_layers"),
"@brief Sets the layer map\n"
"This sets a layer mapping for the reader. The \"create_other_layers\" specifies whether to create layers that are not "
"in the mapping and automatically assign layers to them.\n"
"@param map The layer map to set."
"@param create_other_layers The flag telling whether other layer should be created also. Set to false if just the layers in the mapping table should be read.\n"
"This sets a layer mapping for the reader. The layer map allows selection and translation of the original layers, for example to assign layer/datatype numbers to the named layers.\n"
"@param map The layer map to set.\n"
"@param create_other_layers The flag indicating whether other layers will be created as well. Set to false to read only the layers in the layer map.\n"
"\n"
"This method has been added in version 0.25 and replaces the respective global option in \\LoadLayoutOptions "
"in a format-specific fashion."
@ -185,7 +184,7 @@ gsi::ClassExt<db::LoadLayoutOptions> dxf_reader_options (
gsi::method_ext ("dxf_layer_map=", &set_layer_map1, gsi::arg ("map"),
"@brief Sets the layer map\n"
"This sets a layer mapping for the reader. Unlike \\dxf_set_layer_map, the 'create_other_layers' flag is not changed.\n"
"@param map The layer map to set."
"@param map The layer map to set.\n"
"\n"
"This convenience method has been added in version 0.26."
) +
@ -209,14 +208,17 @@ gsi::ClassExt<db::LoadLayoutOptions> dxf_reader_options (
) +
gsi::method_ext ("dxf_create_other_layers?", &create_other_layers,
"@brief Gets a value indicating whether other layers shall be created\n"
"@return True, if other layers should be created.\n"
"@return True, if other layers will be created.\n"
"This attribute acts together with a layer map (see \\dxf_layer_map=). Layers not listed in this map are created as well when "
"\\dxf_create_other_layers? is true. Otherwise they are ignored.\n"
"\n"
"This method has been added in version 0.25 and replaces the respective global option in \\LoadLayoutOptions "
"in a format-specific fashion."
) +
gsi::method_ext ("dxf_create_other_layers=", &set_create_other_layers, gsi::arg ("create"),
"@brief Specifies whether other layers shall be created\n"
"@param create True, if other layers should be created.\n"
"@param create True, if other layers will be created.\n"
"See \\dxf_create_other_layers? for a description of this attribute.\n"
"\n"
"This method has been added in version 0.25 and replaces the respective global option in \\LoadLayoutOptions "
"in a format-specific fashion."

52
src/plugins/streamers/magic/db_plugin/gsiDeclDbMAG.cc
View File

@ -120,17 +120,16 @@ static
gsi::ClassExt<db::LoadLayoutOptions> mag_reader_options (
gsi::method_ext ("mag_set_layer_map", &set_layer_map, gsi::arg ("map"), gsi::arg ("create_other_layers"),
"@brief Sets the layer map\n"
"This sets a layer mapping for the reader. The \"create_other_layers\" specifies whether to create layers that are not "
"in the mapping and automatically assign layers to them.\n"
"@param map The layer map to set."
"@param create_other_layers The flag telling whether other layer should be created also. Set to false if just the layers in the mapping table should be read.\n"
"This sets a layer mapping for the reader. The layer map allows selection and translation of the original layers, for example to assign layer/datatype numbers to the named layers.\n"
"@param map The layer map to set.\n"
"@param create_other_layers The flag indicating whether other layers will be created as well. Set to false to read only the layers in the layer map.\n"
"\n"
"This method has been added in version 0.26.2."
) +
gsi::method_ext ("mag_layer_map=", &set_layer_map1, gsi::arg ("map"),
"@brief Sets the layer map\n"
"This sets a layer mapping for the reader. Unlike \\mag_set_layer_map, the 'create_other_layers' flag is not changed.\n"
"@param map The layer map to set."
"@param map The layer map to set.\n"
"\n"
"This method has been added in version 0.26.2."
) +
@ -146,20 +145,20 @@ gsi::ClassExt<db::LoadLayoutOptions> mag_reader_options (
"@brief Gets the layer map\n"
"@return A reference to the layer map\n"
"\n"
"This method has been added in version 0.25 and replaces the respective global option in \\LoadLayoutOptions "
"in a format-specific fashion.\n"
"\n"
"This method has been added in version 0.26.2."
) +
gsi::method_ext ("mag_create_other_layers?", &create_other_layers,
"@brief Gets a value indicating whether other layers shall be created\n"
"@return True, if other layers should be created.\n"
"@return True, if other layers will be created.\n"
"This attribute acts together with a layer map (see \\mag_layer_map=). Layers not listed in this map are created as well when "
"\\mag_create_other_layers? is true. Otherwise they are ignored.\n"
"\n"
"This method has been added in version 0.26.2."
) +
gsi::method_ext ("mag_create_other_layers=", &set_create_other_layers, gsi::arg ("create"),
"@brief Specifies whether other layers shall be created\n"
"@param create True, if other layers should be created.\n"
"@param create True, if other layers will be created.\n"
"See \\mag_create_other_layers? for a description of this attribute.\n"
"\n"
"This method has been added in version 0.26.2."
) +
@ -185,13 +184,13 @@ gsi::ClassExt<db::LoadLayoutOptions> mag_reader_options (
"@brief Gets a value indicating whether boxes are merged into polygons\n"
"@return True, if boxes are merged.\n"
"\n"
"When set to true, the boxes of the Magic layout files are merged into (manhattan) polygons where possible.\n"
"When set to true, the boxes and triangles of the Magic layout files are merged into polygons where possible.\n"
"\n"
"This method has been added in version 0.26.2."
) +
gsi::method_ext ("mag_merge=", &set_merge, gsi::arg ("merge"),
"@brief sets a value indicating whether boxes are merged into polygons\n"
"@param merge True, if boxes to be merged into polygons.\n"
"@brief Sets a value indicating whether boxes are merged into polygons\n"
"@param merge True, if boxes and triangles will be merged into polygons.\n"
"\n"
"See \\mag_merge? for a description of this property.\n"
"\n"
@ -206,28 +205,33 @@ gsi::ClassExt<db::LoadLayoutOptions> mag_reader_options (
"\nThis property has been added in version 0.26.2.\n"
) +
gsi::method_ext ("mag_library_paths", &get_mag_library_paths,
"@brief Get the locations where to look up libraries (in this order)\n"
"See \\mag_library_paths= method for a description of this attribute."
"@brief Gets the locations where to look up libraries (in this order)\n"
"See \\mag_library_paths= method for a description of this attribute.\n"
"\nThis property has been added in version 0.26.2.\n"
) +
gsi::method_ext ("mag_lambda=", &set_mag_lambda, gsi::arg ("lambda"),
"@brief Specifies the lambda value to used for reading\n"
"\n"
"The lamdba value is the basic unit of the layout.\n"
"The lamdba value is the basic unit of the layout. Magic draws layout as multiples of this basic unit. "
"The layout read by the MAG reader will use the database unit specified by \\mag_dbu, but the physical layout "
"coordinates will be multiples of \\mag_lambda.\n"
"\nThis property has been added in version 0.26.2.\n"
) +
gsi::method_ext ("mag_lambda", &get_mag_lambda,
"@brief Get the lambda value\n"
"See \\mag_lambda= method for a description of this attribute."
"@brief Gets the lambda value\n"
"See \\mag_lambda= method for a description of this attribute.\n"
"\nThis property has been added in version 0.26.2.\n"
) +
gsi::method_ext ("mag_dbu=", &set_mag_dbu, gsi::arg ("dbu"),
"@brief Specifies the database unit which the reader uses and produces\n"
"The database unit is the final resolution of the produced layout. This physical resolution is usually "
"defined by the layout system - GDS for example typically uses 1nm (mag_dbu=0.001).\n"
"All geometry in the MAG file will first be scaled to \\mag_lambda and is then brought to the database unit.\n"
"\nThis property has been added in version 0.26.2.\n"
) +
gsi::method_ext ("mag_dbu", &get_mag_dbu,
"@brief Specifies the database unit which the reader uses and produces\n"
"See \\mag_dbu= method for a description of this property."
"See \\mag_dbu= method for a description of this property.\n"
"\nThis property has been added in version 0.26.2.\n"
),
""
@ -274,8 +278,8 @@ gsi::ClassExt<db::SaveLayoutOptions> mag_writer_options (
"\n"
"The lamdba value is the basic unit of the layout.\n"
"The layout is brought to units of this value. If the layout is not on-grid on this unit, snapping will happen. "
"If the value is less or equal to zero, KLayout will use the lambda value stored inside the layout (set by a previous read operation "
"of a MAGIC file).\n"
"If the value is less or equal to zero, KLayout will use the lambda value stored inside the layout set by a previous read operation "
"of a MAGIC file. The lambda value is stored in the Layout object as the \"lambda\" metadata attribute.\n"
"\nThis property has been added in version 0.26.2.\n"
) +
gsi::method_ext ("mag_lambda", &get_mag_lambda_w,
@ -283,13 +287,13 @@ gsi::ClassExt<db::SaveLayoutOptions> mag_writer_options (
"See \\mag_lambda= method for a description of this attribute."
"\nThis property has been added in version 0.26.2.\n"
) +
gsi::method_ext ("write_timestamp=", &set_mag_write_timestamp, gsi::arg ("f"),
gsi::method_ext ("mag_write_timestamp=", &set_mag_write_timestamp, gsi::arg ("f"),
"@brief Specifies whether to write a timestamp\n"
"\n"
"If this attribute is set to false, the timestamp written is 0. This isn't correct in the strict sense but simplifies comparison of Magic files.\n"
"If this attribute is set to false, the timestamp written is 0. This is not permitted in the strict sense, but simplifies comparison of Magic files.\n"
"\nThis property has been added in version 0.26.2.\n"
) +
gsi::method_ext ("write_timestamp", &get_mag_write_timestamp,
gsi::method_ext ("mag_write_timestamp?", &get_mag_write_timestamp,
"@brief Gets a value indicating whether to write a timestamp\n"
"See \\write_timestamp= method for a description of this attribute.\n"
"\nThis property has been added in version 0.26.2.\n"

39
testdata/ruby/dbReaders.rb vendored
View File

@ -178,6 +178,45 @@ class DBReaders_TestClass < TestBase
end
# MAG Options
def test_mag_options
opt = RBA::LoadLayoutOptions::new
lm = RBA::LayerMap::new
lm.map(RBA::LayerInfo::new(1, 0), 2, RBA::LayerInfo::new(42, 17))
opt.mag_set_layer_map(lm, true)
assert_equal(opt.mag_layer_map.to_string, "1/0 : 42/17\n")
assert_equal(opt.mag_create_other_layers?, true)
opt.mag_create_other_layers = false
assert_equal(opt.mag_create_other_layers?, false)
opt.mag_select_all_layers
assert_equal(opt.mag_layer_map.to_string, "")
assert_equal(opt.mag_create_other_layers?, true)
opt.mag_keep_layer_names = true
assert_equal(opt.mag_keep_layer_names?, true)
opt.mag_keep_layer_names = false
assert_equal(opt.mag_keep_layer_names?, false)
opt.mag_dbu = 0.5
assert_equal(opt.mag_dbu, 0.5)
opt.mag_lambda = 0.125
assert_equal(opt.mag_lambda, 0.125)
assert_equal(opt.mag_merge, true)
opt.mag_merge = false
assert_equal(opt.mag_merge?, false)
assert_equal(opt.mag_library_paths, [])
opt.mag_library_paths = [ "a", "b" ]
assert_equal(opt.mag_library_paths, [ "a", "b" ])
end
end
load("test_epilogue.rb")

10
testdata/ruby/laySaveLayoutOptions.rb vendored
View File

@ -118,7 +118,6 @@ class SaveLayoutOptions_TestClass < TestBase
opt.gds2_write_timestamps = false
assert_equal(opt.gds2_write_timestamps?, false)
# DXF+CIF attributes are kept with GDS2
assert_equal(opt.dxf_polygon_mode, 2)
opt.oasis_compression_level = 5
@ -157,6 +156,15 @@ class SaveLayoutOptions_TestClass < TestBase
opt.oasis_substitution_char = "+"
assert_equal(opt.oasis_substitution_char, "+")
opt.mag_lambda = 0.25
assert_equal(opt.mag_lambda, 0.25)
assert_equal(opt.mag_write_timestamp?, true)
opt.mag_write_timestamp = false
assert_equal(opt.mag_write_timestamp?, false)
opt.mag_tech = "xyz"
assert_equal(opt.mag_tech, "xyz")
opt.set_format_from_filename("a.gds")
assert_equal(opt.format, "GDS2")