mc-kit/map-stp

Transfer meta information on cells from an STP file to MCNP model. Set materials and densities according to tags specified in STP model tree.

mapstp: link STP and MCNP models

Contents

• Description
  • Problem #1
  • Problem #2
  • Solution
• Installation
• Documentation
• Contributing

Description

Problem #1

You are an MCNP model developer. You have created simplified 3D CAD model using SpaceClaim, saved it to STP file, then converted it using SuperMC to an MCNP model. At this moment the MCNP model doesn't have any information on relation of the MCNP came from cells to the CAD components, there's no materials and densities in the cell specifications. The SuperMC (for the time of writing this) doesn't transfer this information on exporting to MCNP model.

Problem #2

You have to provide results of neutron analysis in correspondence with 3D CAD model components. For example, you have to create a table describing activation of every component. To do this, you need some tools to associate CAD component with corresponding MCNP cells. Using this table the results of computation for MCNP cells can be aggregated to values for corresponding CAD component.

Solution

Using SpaceClaim you can add additional properties to components directly in STP file. The properties include: used material, density correction factor, classification tag. The properties are specified as a special label, which you can add to the components names. The properties are propagated over the CAD tree hierarchy from top to down and can be overridden on lower levels with more specific values. Using SpaceClaim for this is rather intuitive.

The using mapstp you can transfer this information from STP to MCNP: The mapstp:

• sets material numbers and densities in all the cells, where it was specified
• adds $-comment after each cell denoting its path in STP, with tag "stp:",this lines can be easily removed later, if not needed
• adds materials specifications, if they are available for mapstp
• creates separate accompanying excel file with list of cells, applied materials, densities and correction factors, classification tag, and paths in STP

Installation

Documentation

Contributing

map-stp's Issues

restore testing STP related code

The mapstp now uses sqlite database with information about 3D model obtained from SpaceClaim script.
Probably, we don't need STP parsing anymore. Probably, we still need this code to check if a given MCNP model correspondes to given STP.
Decide, and either remove this code or restore testing (now it's 'skipped').

update pip

We have to use older version of pip on github actions to avoid pip error (fails on some packages not providing metainformation).

The pip issue is closed, but the error still happens occussionaly on github actions running Python 3.11. Everything is fine on local machines.

Update the version when either pip is fixed or all the packages have good meta information. Current version of pip 22.3.1, this is restricted on github actions with constraints.txt to 21.3.1.

extract-info script doesn't work with SpaceClaim API v.17-beta

Check and report SpaceClaim API version.
Find and implment equivalent for body.GetPathToMaster() (see _get_path() method) for old API.
We still need to use the old SpaceClaim instance - it looks like more reliable in some tasks.

switch to polars

... and remove pandas and pyarrow (will be required by pandas in future versions)

Motivation: polars is more efficient and feasible, polars is used in other our packages mckit-nuclides, xpypact.

add command to export SpaceClaim script

SpaceClaim script data/extract-info-0.3.4.py is now stored in the mapstp package as data resource.

Add command 'export extract-info' to export the code from installed mapstp package.