ExportDesigns Class Reference

Initializes defaults and starts a first filesystem scan. ( Structure )

At first, the constructor tries to generate a suiteable base path and design template string:

• Usually, the ReferenceDesign object will contain at least one file to be imported. If this is the case, its completed file path will be analyzed using the #DesignPath object. At best, this analysis will return a reliable base_path as well as design_name_format.
• Otherwise the ReferenceDesign::base_path of reference_design given will be separated. Its parent path will be re-used as base_path and the other part as design_name_format Afterwards, ImportDesigns::scanDesignRanges() will be called automatically and the first design range number re-used as start design ident. Otherise, the design ranges remain empty and the ImportDesigns::start_design_number will be initialized to one.

Parameters

reference_design	The reference design object ( Structure )
database	The database were all data is stored

Checks validity of these data.

• If any of the specified directories, design IDs or files does not exist, an exception is thrown
• It also checks the validity of the reference design
• It further checks if any of the objects to be exported does not exist.

Parameters

database

The data base where all the data is stored

Generates a list of all design sample numbers.

Returns

A vector of integer numbers where each number represents the design identifier used in the SoS database. The vector indices correspond to the vector of ImportDesigns::getDesignPathNames

generates the defined design range intervals as a string

Returns

the design range string, eg. "1-4;6-10;12;15-20"

generates a list of all design directory path names ()

Returns

A vector of strings where each string represents the design path name. Each path name is a valid directory name (already includes the base_path). ()

Exports multiple designs to disk.

This method tries to export as much data as possible and does even proceed in case of errors. Important: the design directories to be exported to must already exist.

Parameters

database

The data base where all data is contained.

Scans the base path for design directories. ( Structure )

Depending on the currently storred information (base path, design name properties, defined files in the reference design) the design directories are determined and the ranges of the indicies are stored in ranges_from and ranges_to. Only design directories are accepted which contain ALL of the files being contained in the reference path! ( Structure ) Furthermore, only those design numbers are accepted for which all objects to be exported exist in the database.

Parameters

database

The database where all data are stored

Sets the design number intervals given as string The method calls unifyDesignNumbers(); to ensure uniqueness of the defined design numbers. ()

Parameters

design_ranges

The string to be interpreted, must be of format "1-4;12;15-20;" or "1-4" or "1" or "".

Exceptions

an	exception If the string can not be interpreted. In this case, the definition is not changed. ()

Unifies the design numbers This method ensures that each design number appears at most once in the design interval definition. ()

()

Base path (absolute path)

Format string for identifying design directories.

Format strings shall be defined as Perl Regular Expressions including one sub-expression which defines the design ID, eg.

which matches the string Design, followed by one or no underscore and a sub-expression of one or more digits until the end of the string. The digit group will be used as unique design number within the database. Other examples might be

which expects exactly 2 digits, or

which matches the directory 'first' relative to base_path, any of its subdirectories, a Design directory consisting of one or 5 digits (zero should be avoided as internal design numbers must be generated in that case), an ANSYS dp subdirectory composed of the dp string followed by exactly 2 digits and as last acceptable subdirectory the string mech. For further common pittfalls - like the maximum sub directory level - refer to DesignScanner::filter ( string )

Defines ranges of the design directories, specifically the left interval boundaries.

Defines ranges of the design directories, specifically the right interval boundaries.

Must have the same dimensions as #ImportDesings::ranges_from

Stores the information on the reference design/design template (defines which data to be imported)