DIVERSITY Version 1.0

COPYRIGHT (C) 2014 - 2020 Norbert H. Doerry

Syntax

DIVERSITY.EXE filename.xml [-d]

	filename.xml is the input file
	-d  sets the debug flag

Description:

  DIVERSITY is used to help reduce sets in Set-Based Design (SBD) that are characterized
by having multiple discrete, functionally interchangeable, options for multiple (quantity m) 
system components (called diversity fields).  A subset of the options is identified which 
minimizes cost (or some other metric), but preserves sufficient options to reduce risk that 
should the lowest cost solution not prove viable, that at least one alternative will likely 
be viable.  

The algorithm is executed with the following steps:

1. read in a set of configurations described by the options selected for that configuration 
and the associated cost / metric.

2. sort the configurations by the cost / metric -- each row corresponds to configuration

3. Examine the rows starting the lowest cost / best metric and working down

3. For each row (configuration) and each diversity field, calculate the distinct options that 
have been encountered so far, and the number of times each option has been encountered. 
(cumulative sums)

4. For each option for each diversity field, determine if a sufficient number of configurations
using the option have been encountered to be counted as a possible soluton.

5. Based on a specified number of options desired for each diversity field, calculate a diversity metric based on the fraction of possible solutions divided by the total number of desired possible solutions. 

filename.xml format


<DIVERSITY>   // required 
<NAME> test 1 </NAME>  
<COMMENT> comment </COMMENT>

<MIN_NBR_FIELDS> 10 </MIN_NBR_FIELDS>  // rows in source_file with less than this are ignored 

<SOURCE_FILE> test1.csv </SOURCE_FILE>  // csv file with input data

<SORT_FIELD>
<NAME> METRIC AVERAGE FOLLOW END COST MOST LIKELY </NAME> // field to sort upon
<PREFERENCE> LOW </PREFERENCE>  // alternate value is HIGH, determines whether Low or High value is preferred
<FILENAME> filename_statistics.txt </FILENAME>
</SORT_FIELD>

<STATISTICS_FIELDS>  // fields statistics are calculated on 
<NAME> METRIC AVERAGE FOLLOW END COST MOST LIKELY </NAME>
<NAME> METRIC AVERAGE FOLLOW END COST HIGH </NAME>
<NAME> METRIC AVERAGE FOLLOW END COST LOW </NAME>
<NAME> METRIC FIRST FOLLOW END COST MOST LIKELY </NAME>
<NAME> METRIC FIRST FOLLOW END COST HIGH </NAME>
<NAME> METRIC FIRST FOLLOW END COST LOW </NAME>
<NAME> METRIC LEAD SHIP END COST MOST LIKELY </NAME>
<NAME> METRIC LEAD SHIP END COST HIGH </NAME>
<NAME> METRIC LEAD SHIP END COST LOW </NAME>
<FILENAME> test1_statistics.txt </FILENAME>
</STATISTICS_FIELDS>

<OUTPUT_FIELDS>  // fields that are printed in output file
<NAME> METRIC AVERAGE FOLLOW END COST MOST LIKELY </NAME>
<NAME> METRIC AVERAGE FOLLOW END COST HIGH </NAME>
<NAME> METRIC AVERAGE FOLLOW END COST LOW </NAME>
<NAME> METRIC FIRST FOLLOW END COST MOST LIKELY </NAME>
<NAME> METRIC FIRST FOLLOW END COST HIGH </NAME>
<NAME> METRIC FIRST FOLLOW END COST LOW </NAME>
<NAME> METRIC LEAD SHIP END COST MOST LIKELY </NAME>
<NAME> METRIC LEAD SHIP END COST HIGH </NAME>
<NAME> METRIC LEAD SHIP END COST LOW </NAME>
<DIVERSTITY_METRIC> ON <DIVERSITY_METRIC>  // other choice is OFF
				           // whether to create a column for the diversity metric.
<FILENAME> test1_output_fields </FILENAME>
</OUTPUT_FIELDS>

<DIVERSITY_FIELD> 
<NAME> AAW </NAME>
<MIN_NBR_OPTIONS> 3 </MIN_NBR_OPTIONS>   // minium nbr of options encountered for diversity 1.0
<MIN_NBR_CONFIGS_PER_OPTION> 10 </MIN_NBR_CONFIGS_PER_OPTION>   // min nbr of configs for option to count
</DIVERSITY_FIELD>

<DIVERSITY_FIELD> 
<NAME> ASW </NAME>
<MIN_NBR_OPTIONS> 3 </MIN_NBR_OPTIONS>
<MIN_NBR_CONFIGS_PER_OPTION> 10 </MIN_NBR_CONFIGS_PER_OPTION> 
</DIVERSITY_FIELD>

<DIVERSITY_FIELD> 
<NAME> SUW </NAME>
<MIN_NBR_OPTIONS> 3 </MIN_NBR_OPTIONS>
<MIN_NBR_CONFIGS_PER_OPTION> 10 </MIN_NBR_CONFIGS_PER_OPTION> 
</DIVERSITY_FIELD>

<DIVERSITY_FIELD> 
<NAME> seed </NAME>
<MIN_NBR_OPTIONS> 4 </MIN_NBR_OPTIONS>
<MIN_NBR_CONFIGS_PER_OPTION> 10 </MIN_NBR_CONFIGS_PER_OPTION> 
</DIVERSITY_FIELD>

<DIVERSITY_FIELD> 
<NAME> PARENT SHIP WEIGHT EQUATION(2) </NAME>
<MIN_NBR_OPTIONS> 2 </MIN_NBR_OPTIONS>
<MIN_NBR_CONFIGS_PER_OPTION> 10 </MIN_NBR_CONFIGS_PER_OPTION> 
</DIVERSITY_FIELD>

<DIVERSITY_FIELD> 
<NAME> DECKHOUSE COMPARTMENT STRUCTURAL DENSITY(1) </NAME>
<MIN_NBR_OPTIONS> 2 </MIN_NBR_OPTIONS>
<MIN_NBR_CONFIGS_PER_OPTION> 10 </MIN_NBR_CONFIGS_PER_OPTION> 
</DIVERSITY_FIELD>

<DIVERSITY_FIELD> 
<NAME> HOGGING BENDING MOMENT CONSTANT </NAME>
<MIN_NBR_OPTIONS> 2 </MIN_NBR_OPTIONS>
<MIN_NBR_CONFIGS_PER_OPTION> 10 </MIN_NBR_CONFIGS_PER_OPTION> 
</DIVERSITY_FIELD>

<DIVERSITY_FIELD> 
<NAME> MAIN ENGINE POWER AVAILABLE </NAME>
<MIN_NBR_OPTIONS> 3 </MIN_NBR_OPTIONS>
<MIN_NBR_CONFIGS_PER_OPTION> 10 </MIN_NBR_CONFIGS_PER_OPTION> 
</DIVERSITY_FIELD>

</DIVERSITY>

REFERENCE 
Dr. Norbert Doerry, "Measuring Diversity in Set-Based Design," 
Presented at ASNE Day 2015, Arlington VA, March 4, 2015
http://doerry.org/norbert/papers/20150211MeasuringDiversitySBD-final.pdf

LICENSE

This program is free software; you can redistribute it and/or
modify it under the terms of the GNU General Public License
as published by the Free Software Foundation; either version 2
of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
along with this program; if not, write to the Free Software
Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA  02111-1307, USA.