Class CharacterizationValidationReport

java.lang.Object

neqsim.thermo.characterization.CharacterizationValidationReport

public class CharacterizationValidationReport
extends Object

Validation report for fluid characterization operations.

This class captures key properties before and after characterization to verify that the operation preserves mass, maintains reasonable property values, and achieves the desired component structure.

Author:

ESOL

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
private static class	CharacterizationValidationReport.Builder

Field Summary

Fields

Modifier and Type	Field	Description
private final boolean	isValid
private final double	massDifferencePercent
private final double	molesDifferencePercent
private final double	mwDifferencePercent
private final String	referenceFluidName
private final int	referencePseudoComponentCount
private final double	resultAverageMW
private final int	resultPseudoComponentCount
private final Map<String,Double>	resultPseudoComponentMoles
private final double	resultTotalMass
private final double	resultTotalMoles
private final double	sourceAverageMW
private final String	sourceFluidName
private final int	sourcePseudoComponentCount
private final Map<String,Double>	sourcePseudoComponentMoles
private final double	sourceTotalMass
private final double	sourceTotalMoles
private final List<String>	warnings

Constructor Summary

Constructors

Modifier	Constructor	Description
private	CharacterizationValidationReport(CharacterizationValidationReport.Builder builder)

Method Summary

Modifier and Type	Method	Description
private static double	calculateTotalMass(SystemInterface fluid)
private static int	countPseudoComponents(SystemInterface fluid)
static CharacterizationValidationReport	generate(SystemInterface source, SystemInterface reference, SystemInterface result)	Generate a validation report comparing source and characterized fluids.
double	getMassDifferencePercent()	Get the mass conservation error as a percentage.
double	getMolesDifferencePercent()	Get the moles conservation error as a percentage.
private static Map<String,Double>	getPseudoComponentMoles(SystemInterface fluid)
int	getResultPseudoComponentCount()	Get the number of pseudo-components in the result fluid.
int	getSourcePseudoComponentCount()	Get the number of pseudo-components in the source fluid.
List<String>	getWarnings()	Get any warnings generated during validation.
boolean	isValid()	Check if the characterization is valid (no warnings).
String	toReportString()	Generate a formatted report string.
String	toString()

Methods inherited from class Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Field Details

sourceFluidName

private final String sourceFluidName

referenceFluidName

private final String referenceFluidName

sourcePseudoComponentCount

private final int sourcePseudoComponentCount

referencePseudoComponentCount

private final int referencePseudoComponentCount

resultPseudoComponentCount

private final int resultPseudoComponentCount

sourceTotalMoles

private final double sourceTotalMoles

sourceTotalMass

private final double sourceTotalMass

sourceAverageMW

private final double sourceAverageMW

resultTotalMoles

private final double resultTotalMoles

resultTotalMass

private final double resultTotalMass

resultAverageMW

private final double resultAverageMW

massDifferencePercent

private final double massDifferencePercent

molesDifferencePercent

private final double molesDifferencePercent

mwDifferencePercent

private final double mwDifferencePercent

sourcePseudoComponentMoles

private final Map<String,Double> sourcePseudoComponentMoles

resultPseudoComponentMoles

private final Map<String,Double> resultPseudoComponentMoles

warnings

private final List<String> warnings

isValid

private final boolean isValid

Constructor Details

CharacterizationValidationReport

private CharacterizationValidationReport(CharacterizationValidationReport.Builder builder)

Method Details

generate

public static CharacterizationValidationReport generate(SystemInterface source,
 SystemInterface reference,
 SystemInterface result)

Generate a validation report comparing source and characterized fluids.

Parameters:

source - the original source fluid

reference - the reference fluid used for characterization

result - the characterized result fluid

Returns:

validation report

countPseudoComponents

private static int countPseudoComponents(SystemInterface fluid)

calculateTotalMass

private static double calculateTotalMass(SystemInterface fluid)

getPseudoComponentMoles

private static Map<String,Double> getPseudoComponentMoles(SystemInterface fluid)

isValid

public boolean isValid()

Check if the characterization is valid (no warnings).

Returns:

true if valid

getWarnings

public List<String> getWarnings()

Get any warnings generated during validation.

Returns:

list of warnings

getMassDifferencePercent

public double getMassDifferencePercent()

Get the mass conservation error as a percentage.

Returns:

mass difference percentage

getMolesDifferencePercent

public double getMolesDifferencePercent()

Get the moles conservation error as a percentage.

Returns:

moles difference percentage

getSourcePseudoComponentCount

public int getSourcePseudoComponentCount()

Get the number of pseudo-components in the source fluid.

Returns:

source PC count

getResultPseudoComponentCount

public int getResultPseudoComponentCount()

Get the number of pseudo-components in the result fluid.

Returns:

result PC count

toReportString

public String toReportString()

Generate a formatted report string.

Returns:

formatted report

toString

public String toString()

Overrides:

toString in class Object