Class DialectMapper

java.lang.Object

org.episteme.social.linguistics.DialectMapper

public final class DialectMapper
extends Object

Analytical tool for dialect mapping and isogloss analysis. It facilitates the study of spatial linguistic variation by mapping features to geographical locations and drawing boundaries between dialect regions.

Since:

1.0

Version:

2.0

Author:

Silvere Martin-Michiellot, Gemini AI (Google DeepMind)

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static final record	DialectMapper.DialectDataPoint	Data point from a linguistic survey at a specific geographical location.
static final record	DialectMapper.Isogloss	Represents a line on a map marking the geographical boundary of a linguistic feature.
static final record	DialectMapper.LinguisticFeature	Represents a specific linguistic variable (phonological, lexical, etc.).

Field Summary

Fields

Modifier and Type	Field	Description
static final DialectMapper.LinguisticFeature	CODA_DEVOICING
static final DialectMapper.LinguisticFeature	DOUBLE_NEGATION
static final DialectMapper.LinguisticFeature	RHOTICITY
static final DialectMapper.LinguisticFeature	VOWEL_SHIFT
static final DialectMapper.LinguisticFeature	Y_ALL

Method Summary

Modifier and Type	Method	Description
static Map<Integer, List<DialectMapper.DialectDataPoint>>	clusterDialects(List<DialectMapper.DialectDataPoint> data, int numClusters)	Groups dialect points into clusters based on shared linguistic features using an iterative similarity-based algorithm.
static DialectMapper.Isogloss	createIsogloss(List<DialectMapper.DialectDataPoint> data, DialectMapper.LinguisticFeature feature, String name)	Generates an isogloss boundary based on a collection of survey data points for a specific linguistic feature.
static String	generateMapSummary(List<DialectMapper.DialectDataPoint> data, List<DialectMapper.Isogloss> isoglosses)	Generates a structural summary of the dialectal map and identified isoglosses.
static Real	linguisticDistance(DialectMapper.DialectDataPoint a, DialectMapper.DialectDataPoint b)	Calculates the linguistic distance (using Jaccard similarity inverse) between two survey points.

Methods inherited from class Object

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

Field Details

RHOTICITY

public static final DialectMapper.LinguisticFeature RHOTICITY

VOWEL_SHIFT

public static final DialectMapper.LinguisticFeature VOWEL_SHIFT

CODA_DEVOICING

public static final DialectMapper.LinguisticFeature CODA_DEVOICING

DOUBLE_NEGATION

public static final DialectMapper.LinguisticFeature DOUBLE_NEGATION

Y_ALL

public static final DialectMapper.LinguisticFeature Y_ALL

Method Details

createIsogloss

public static DialectMapper.Isogloss createIsogloss(List<DialectMapper.DialectDataPoint> data,
 DialectMapper.LinguisticFeature feature,
 String name)

Generates an isogloss boundary based on a collection of survey data points for a specific linguistic feature.

Parameters:

data - list of survey points

feature - the feature to map

name - name for the generated isogloss

Returns:

an Isogloss representing the boundary for the feature

linguisticDistance

public static Real linguisticDistance(DialectMapper.DialectDataPoint a,
 DialectMapper.DialectDataPoint b)

Calculates the linguistic distance (using Jaccard similarity inverse) between two survey points.

Parameters:

a - first survey point

b - second survey point

Returns:

distance metric (0.0 to 1.0) as a Real

clusterDialects

public static Map<Integer, List<DialectMapper.DialectDataPoint>> clusterDialects(List<DialectMapper.DialectDataPoint> data,
 int numClusters)

Groups dialect points into clusters based on shared linguistic features using an iterative similarity-based algorithm.

Parameters:

data - survey points to cluster

numClusters - target number of clusters

Returns:

map of cluster index to list of points

generateMapSummary

public static String generateMapSummary(List<DialectMapper.DialectDataPoint> data,
 List<DialectMapper.Isogloss> isoglosses)

Generates a structural summary of the dialectal map and identified isoglosses.

Parameters:

data - the survey dataset

isoglosses - the identified boundaries

Returns:

a human-readable summary