Class NumismaticAnalyzer

java.lang.Object

org.episteme.social.history.NumismaticAnalyzer

public final class NumismaticAnalyzer
extends Object

Analyzes historical coins, their physical characteristics, and economic implications. Includes tools for calculating intrinsic value and modeling economic laws like Gresham's Law.

Since:

1.0

Author:

Silvere Martin-Michiellot, Gemini AI (Google DeepMind)

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static final record	NumismaticAnalyzer.Coin	Data record representing a historical coin and its metal composition.

Method Summary

Modifier and Type	Method	Description
static Real	calculateIntrinsicValue(NumismaticAnalyzer.Coin coin, double metalPricePerGram)	Calculates the intrinsic metal value of a coin.
static double	hoardingProbability(double intrinsic1, double face1, double intrinsic2, double face2)	Models Gresham's Law: "Bad money drives out good."

Methods inherited from class Object

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

Method Details

calculateIntrinsicValue

public static Real calculateIntrinsicValue(NumismaticAnalyzer.Coin coin,
 double metalPricePerGram)

Calculates the intrinsic metal value of a coin.

Parameters:

coin - the coin to analyze

metalPricePerGram - current market price of the precious metal

Returns:

intrinsic value as a Real number

Throws:

NullPointerException - if coin is null

hoardingProbability

public static double hoardingProbability(double intrinsic1,
 double face1,
 double intrinsic2,
 double face2)

Models Gresham's Law: "Bad money drives out good." Estimates the probability of "good" money being hoarded when "bad" money is in circulation.

Parameters:

intrinsic1 - intrinsic value of currency 1

face1 - nominal face value of currency 1

intrinsic2 - intrinsic value of currency 2

face2 - nominal face value of currency 2

Returns:

probability (0.0 to 1.0) of currency 1 being hoarded