hvman 0.0.0-stage → 0.0.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/LICENSE +21 -0
- package/README.md +43 -2
- package/dist/anthropometry.d.ts +34 -0
- package/dist/anthropometry.d.ts.map +1 -0
- package/dist/anthropometry.js +51 -0
- package/dist/anthropometry.js.map +1 -0
- package/dist/dna.d.ts +68 -0
- package/dist/dna.d.ts.map +1 -0
- package/dist/dna.js +185 -0
- package/dist/dna.js.map +1 -0
- package/dist/hairWhorl.d.ts +91 -0
- package/dist/hairWhorl.d.ts.map +1 -0
- package/dist/hairWhorl.js +123 -0
- package/dist/hairWhorl.js.map +1 -0
- package/dist/index.d.ts +5 -0
- package/dist/index.d.ts.map +1 -0
- package/dist/index.js +5 -0
- package/dist/index.js.map +1 -0
- package/package.json +47 -4
package/LICENSE
ADDED
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
MIT License
|
|
2
|
+
|
|
3
|
+
Copyright (c) 2026 HVMAN Contributors
|
|
4
|
+
|
|
5
|
+
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
6
|
+
of this software and associated documentation files (the "Software"), to deal
|
|
7
|
+
in the Software without restriction, including without limitation the rights
|
|
8
|
+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
9
|
+
copies of the Software, and to permit persons to whom the Software is
|
|
10
|
+
furnished to do so, subject to the following conditions:
|
|
11
|
+
|
|
12
|
+
The above copyright notice and this permission notice shall be included in all
|
|
13
|
+
copies or substantial portions of the Software.
|
|
14
|
+
|
|
15
|
+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
16
|
+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
17
|
+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
18
|
+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
19
|
+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
20
|
+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
21
|
+
SOFTWARE.
|
package/README.md
CHANGED
|
@@ -1,3 +1,44 @@
|
|
|
1
|
-
#
|
|
1
|
+
# HVMAN (HVMAN Base)
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+
**HVMAN** is an open-world parametric 3D human foundation designed around empirical human anthropometry, scalp follicle biology, and individual parameter variation rather than averaged templates.
|
|
4
|
+
|
|
5
|
+
**HVMAN(HVMAN Base)** 是一个面向开放世界的参数化 3D 人类基础架构,以人体工学实测区间、毛囊解剖规律与个体差异参数为核心底座,而非单一均值模板。
|
|
6
|
+
|
|
7
|
+
## Features (`v0.0.1` Foundation Core)
|
|
8
|
+
|
|
9
|
+
- **Floor-Grounded Anthropometry (`y = 0`)**: Standing landmark computation (`floorY`, `suprasternalNotchY`, `acromionY`, `eyeY`, `statureM`) grounded in adult anthropometric ratio ranges (GB/T 10000 / GB/T 5703).
|
|
10
|
+
- **Scalp Hair Whorl Vector Fields**: Single and double logarithmic spiral whorl evaluation on arbitrary 3D surface normals with Gaussian distance decay, chiral control (`'cw'` / `'ccw'`), and smooth blending into regional hair flow.
|
|
11
|
+
- **Individual-First `HumanDNA` Schema**: Parameterized stature, body proportions, strand diameter (`30–125 μm`), bending stiffness, tip feathering/translucency, regional exit-angle biases (ISHRS bounds), follicular density, and miniaturization ratio, plus synthetic validation archetypes.
|
|
12
|
+
|
|
13
|
+
## Installation
|
|
14
|
+
|
|
15
|
+
```bash
|
|
16
|
+
npm install hvman
|
|
17
|
+
```
|
|
18
|
+
|
|
19
|
+
## Quick Start
|
|
20
|
+
|
|
21
|
+
```ts
|
|
22
|
+
import {
|
|
23
|
+
computeStandingLandmarks,
|
|
24
|
+
evaluateScalpWhorlField,
|
|
25
|
+
NEUTRAL_ARCHETYPE_MALE,
|
|
26
|
+
validateHumanDNA,
|
|
27
|
+
} from 'hvman';
|
|
28
|
+
|
|
29
|
+
const landmarks = computeStandingLandmarks(NEUTRAL_ARCHETYPE_MALE.body.heightCm);
|
|
30
|
+
// { floorY: 0, statureM: 1.74, eyeY: 1.6008, acromionY: 1.4442, suprasternalNotchY: 1.3746 }
|
|
31
|
+
|
|
32
|
+
const flow = evaluateScalpWhorlField(
|
|
33
|
+
[0.02, 0.11, -0.04],
|
|
34
|
+
[0, 1, 0],
|
|
35
|
+
NEUTRAL_ARCHETYPE_MALE.scalpHair.whorls,
|
|
36
|
+
);
|
|
37
|
+
|
|
38
|
+
const check = validateHumanDNA(NEUTRAL_ARCHETYPE_MALE);
|
|
39
|
+
console.log(landmarks, flow, check.valid);
|
|
40
|
+
```
|
|
41
|
+
|
|
42
|
+
## License
|
|
43
|
+
|
|
44
|
+
[MIT](./LICENSE)
|
|
@@ -0,0 +1,34 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Empirical adult standing anthropometry grounded in GB/T 10000 and GB/T 5703.
|
|
3
|
+
* Uses valid biological ranges rather than fixed population means to preserve individual variance.
|
|
4
|
+
*/
|
|
5
|
+
export interface NumericRange {
|
|
6
|
+
readonly min: number;
|
|
7
|
+
readonly max: number;
|
|
8
|
+
readonly defaultValue: number;
|
|
9
|
+
}
|
|
10
|
+
/** Supported standing adult stature range in centimeters. */
|
|
11
|
+
export declare const STANDING_HEIGHT_CM_RANGE: NumericRange;
|
|
12
|
+
/** Eye height as a fraction of standing stature (~0.91 - 0.93). */
|
|
13
|
+
export declare const EYE_HEIGHT_RATIO: NumericRange;
|
|
14
|
+
/** Acromion (shoulder lateral edge) height as a fraction of standing stature (~0.82 - 0.84). */
|
|
15
|
+
export declare const ACROMION_HEIGHT_RATIO: NumericRange;
|
|
16
|
+
/** Suprasternal (jugular) notch height as a fraction of standing stature (~0.78 - 0.80). */
|
|
17
|
+
export declare const SUPRASTERNAL_HEIGHT_RATIO: NumericRange;
|
|
18
|
+
export interface StandingLandmarkRatios {
|
|
19
|
+
eyeHeightRatio: number;
|
|
20
|
+
acromionHeightRatio: number;
|
|
21
|
+
suprasternalHeightRatio: number;
|
|
22
|
+
}
|
|
23
|
+
export interface StandingLandmarksMeters {
|
|
24
|
+
floorY: 0;
|
|
25
|
+
statureM: number;
|
|
26
|
+
eyeY: number;
|
|
27
|
+
acromionY: number;
|
|
28
|
+
suprasternalNotchY: number;
|
|
29
|
+
}
|
|
30
|
+
/**
|
|
31
|
+
* Compute world-space Y landmarks in meters standing directly on the y = 0 floor plane.
|
|
32
|
+
*/
|
|
33
|
+
export declare function computeStandingLandmarks(heightCm: number, ratios?: Partial<StandingLandmarkRatios>): StandingLandmarksMeters;
|
|
34
|
+
//# sourceMappingURL=anthropometry.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"anthropometry.d.ts","sourceRoot":"","sources":["../src/anthropometry.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;CAC/B;AAED,6DAA6D;AAC7D,eAAO,MAAM,wBAAwB,EAAE,YAItC,CAAC;AAEF,mEAAmE;AACnE,eAAO,MAAM,gBAAgB,EAAE,YAI9B,CAAC;AAEF,gGAAgG;AAChG,eAAO,MAAM,qBAAqB,EAAE,YAInC,CAAC;AAEF,4FAA4F;AAC5F,eAAO,MAAM,yBAAyB,EAAE,YAIvC,CAAC;AAEF,MAAM,WAAW,sBAAsB;IACrC,cAAc,EAAE,MAAM,CAAC;IACvB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,uBAAuB,EAAE,MAAM,CAAC;CACjC;AAED,MAAM,WAAW,uBAAuB;IACtC,MAAM,EAAE,CAAC,CAAC;IACV,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,kBAAkB,EAAE,MAAM,CAAC;CAC5B;AAMD;;GAEG;AACH,wBAAgB,wBAAwB,CACtC,QAAQ,EAAE,MAAM,EAChB,MAAM,CAAC,EAAE,OAAO,CAAC,sBAAsB,CAAC,GACvC,uBAAuB,CA6BzB"}
|
|
@@ -0,0 +1,51 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Empirical adult standing anthropometry grounded in GB/T 10000 and GB/T 5703.
|
|
3
|
+
* Uses valid biological ranges rather than fixed population means to preserve individual variance.
|
|
4
|
+
*/
|
|
5
|
+
/** Supported standing adult stature range in centimeters. */
|
|
6
|
+
export const STANDING_HEIGHT_CM_RANGE = {
|
|
7
|
+
min: 140,
|
|
8
|
+
max: 210,
|
|
9
|
+
defaultValue: 172,
|
|
10
|
+
};
|
|
11
|
+
/** Eye height as a fraction of standing stature (~0.91 - 0.93). */
|
|
12
|
+
export const EYE_HEIGHT_RATIO = {
|
|
13
|
+
min: 0.91,
|
|
14
|
+
max: 0.93,
|
|
15
|
+
defaultValue: 0.92,
|
|
16
|
+
};
|
|
17
|
+
/** Acromion (shoulder lateral edge) height as a fraction of standing stature (~0.82 - 0.84). */
|
|
18
|
+
export const ACROMION_HEIGHT_RATIO = {
|
|
19
|
+
min: 0.82,
|
|
20
|
+
max: 0.84,
|
|
21
|
+
defaultValue: 0.83,
|
|
22
|
+
};
|
|
23
|
+
/** Suprasternal (jugular) notch height as a fraction of standing stature (~0.78 - 0.80). */
|
|
24
|
+
export const SUPRASTERNAL_HEIGHT_RATIO = {
|
|
25
|
+
min: 0.78,
|
|
26
|
+
max: 0.8,
|
|
27
|
+
defaultValue: 0.79,
|
|
28
|
+
};
|
|
29
|
+
function clamp(v, lo, hi) {
|
|
30
|
+
return Math.min(hi, Math.max(lo, v));
|
|
31
|
+
}
|
|
32
|
+
/**
|
|
33
|
+
* Compute world-space Y landmarks in meters standing directly on the y = 0 floor plane.
|
|
34
|
+
*/
|
|
35
|
+
export function computeStandingLandmarks(heightCm, ratios) {
|
|
36
|
+
if (!Number.isFinite(heightCm) || heightCm <= 0) {
|
|
37
|
+
throw new RangeError(`Expected positive finite heightCm, received ${heightCm}`);
|
|
38
|
+
}
|
|
39
|
+
const statureM = heightCm * 0.01;
|
|
40
|
+
const eyeRatio = clamp(ratios?.eyeHeightRatio ?? EYE_HEIGHT_RATIO.defaultValue, EYE_HEIGHT_RATIO.min, EYE_HEIGHT_RATIO.max);
|
|
41
|
+
const acromionRatio = clamp(ratios?.acromionHeightRatio ?? ACROMION_HEIGHT_RATIO.defaultValue, ACROMION_HEIGHT_RATIO.min, ACROMION_HEIGHT_RATIO.max);
|
|
42
|
+
const suprasternalRatio = clamp(ratios?.suprasternalHeightRatio ?? SUPRASTERNAL_HEIGHT_RATIO.defaultValue, SUPRASTERNAL_HEIGHT_RATIO.min, SUPRASTERNAL_HEIGHT_RATIO.max);
|
|
43
|
+
return {
|
|
44
|
+
floorY: 0,
|
|
45
|
+
statureM,
|
|
46
|
+
eyeY: statureM * eyeRatio,
|
|
47
|
+
acromionY: statureM * acromionRatio,
|
|
48
|
+
suprasternalNotchY: statureM * suprasternalRatio,
|
|
49
|
+
};
|
|
50
|
+
}
|
|
51
|
+
//# sourceMappingURL=anthropometry.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"anthropometry.js","sourceRoot":"","sources":["../src/anthropometry.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAQH,6DAA6D;AAC7D,MAAM,CAAC,MAAM,wBAAwB,GAAiB;IACpD,GAAG,EAAE,GAAG;IACR,GAAG,EAAE,GAAG;IACR,YAAY,EAAE,GAAG;CAClB,CAAC;AAEF,mEAAmE;AACnE,MAAM,CAAC,MAAM,gBAAgB,GAAiB;IAC5C,GAAG,EAAE,IAAI;IACT,GAAG,EAAE,IAAI;IACT,YAAY,EAAE,IAAI;CACnB,CAAC;AAEF,gGAAgG;AAChG,MAAM,CAAC,MAAM,qBAAqB,GAAiB;IACjD,GAAG,EAAE,IAAI;IACT,GAAG,EAAE,IAAI;IACT,YAAY,EAAE,IAAI;CACnB,CAAC;AAEF,4FAA4F;AAC5F,MAAM,CAAC,MAAM,yBAAyB,GAAiB;IACrD,GAAG,EAAE,IAAI;IACT,GAAG,EAAE,GAAG;IACR,YAAY,EAAE,IAAI;CACnB,CAAC;AAgBF,SAAS,KAAK,CAAC,CAAS,EAAE,EAAU,EAAE,EAAU;IAC9C,OAAO,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC;AACvC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,wBAAwB,CACtC,QAAgB,EAChB,MAAwC;IAExC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,QAAQ,IAAI,CAAC,EAAE,CAAC;QAChD,MAAM,IAAI,UAAU,CAAC,+CAA+C,QAAQ,EAAE,CAAC,CAAC;IAClF,CAAC;IAED,MAAM,QAAQ,GAAG,QAAQ,GAAG,IAAI,CAAC;IACjC,MAAM,QAAQ,GAAG,KAAK,CACpB,MAAM,EAAE,cAAc,IAAI,gBAAgB,CAAC,YAAY,EACvD,gBAAgB,CAAC,GAAG,EACpB,gBAAgB,CAAC,GAAG,CACrB,CAAC;IACF,MAAM,aAAa,GAAG,KAAK,CACzB,MAAM,EAAE,mBAAmB,IAAI,qBAAqB,CAAC,YAAY,EACjE,qBAAqB,CAAC,GAAG,EACzB,qBAAqB,CAAC,GAAG,CAC1B,CAAC;IACF,MAAM,iBAAiB,GAAG,KAAK,CAC7B,MAAM,EAAE,uBAAuB,IAAI,yBAAyB,CAAC,YAAY,EACzE,yBAAyB,CAAC,GAAG,EAC7B,yBAAyB,CAAC,GAAG,CAC9B,CAAC;IAEF,OAAO;QACL,MAAM,EAAE,CAAC;QACT,QAAQ;QACR,IAAI,EAAE,QAAQ,GAAG,QAAQ;QACzB,SAAS,EAAE,QAAQ,GAAG,aAAa;QACnC,kBAAkB,EAAE,QAAQ,GAAG,iBAAiB;KACjD,CAAC;AACJ,CAAC"}
|
package/dist/dna.d.ts
ADDED
|
@@ -0,0 +1,68 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Parametric HVMAN DNA schema and synthetic archetypes built around individual variation
|
|
3
|
+
* across stature, body proportions, scalp whorls, hair stiffness/caliber, and follicular density.
|
|
4
|
+
*/
|
|
5
|
+
import { type HairWhorlSpec } from './hairWhorl.js';
|
|
6
|
+
export interface ScalpHairProfile {
|
|
7
|
+
/** Primary and optional secondary scalp hair whorls (1-2 typical; 0 allowed for full alopecia). */
|
|
8
|
+
whorls: HairWhorlSpec[];
|
|
9
|
+
/** Nominal hair strand diameter in micrometers (30-125 um). */
|
|
10
|
+
strandDiameterUm: number;
|
|
11
|
+
/** Bending stiffness / brush erectness in [0, 1] (0 = flat/supple, 1 = stiff/erect). */
|
|
12
|
+
stiffness: number;
|
|
13
|
+
/** Tip feathering vs blunt cut in [0, 1] (0 = sharp blunt cut, 1 = soft translucent tip). */
|
|
14
|
+
tipFeathering: number;
|
|
15
|
+
/** Tip translucency in [0, 1] (0 = fully opaque black/pigmented tip, 1 = translucent). */
|
|
16
|
+
tipTranslucency: number;
|
|
17
|
+
/** Regional exit-angle elevation biases in degrees around baseline ISHRS curves. */
|
|
18
|
+
exitAngleBiasDeg: {
|
|
19
|
+
frontalHairline: number;
|
|
20
|
+
temporal: number;
|
|
21
|
+
midScalp: number;
|
|
22
|
+
parietal: number;
|
|
23
|
+
vertexCrown: number;
|
|
24
|
+
nape: number;
|
|
25
|
+
};
|
|
26
|
+
/** Base follicular unit density on unaffected scalp (FU/cm^2). */
|
|
27
|
+
follicularDensityFuCm2: number;
|
|
28
|
+
/** Vertex/frontal miniaturization ratio in [0, 1] (0 = full terminal hairs, 1 = miniaturized/vellus). */
|
|
29
|
+
miniaturizationRatio: number;
|
|
30
|
+
/** Crown length in millimeters. */
|
|
31
|
+
topLengthMm: number;
|
|
32
|
+
/** Side fade height in [0, 1]. */
|
|
33
|
+
fadeHeight: number;
|
|
34
|
+
}
|
|
35
|
+
export interface BodyProportions {
|
|
36
|
+
/** Standing height in centimeters (defines y = 0 floor scale). */
|
|
37
|
+
heightCm: number;
|
|
38
|
+
/** Optional individualized anthropometric ratios overriding defaults. */
|
|
39
|
+
eyeHeightRatio?: number;
|
|
40
|
+
acromionHeightRatio?: number;
|
|
41
|
+
suprasternalHeightRatio?: number;
|
|
42
|
+
/** Normalized shoulder width factor relative to stature baseline. */
|
|
43
|
+
shoulderScale: number;
|
|
44
|
+
/** Overall soft-tissue / adiposity scale in [0, 1]. */
|
|
45
|
+
bodyMassFactor: number;
|
|
46
|
+
}
|
|
47
|
+
export interface HumanDNA {
|
|
48
|
+
id: string;
|
|
49
|
+
label: string;
|
|
50
|
+
sex: 'male' | 'female' | 'neutral';
|
|
51
|
+
age: number;
|
|
52
|
+
body: BodyProportions;
|
|
53
|
+
scalpHair: ScalpHairProfile;
|
|
54
|
+
/** Optional ARKit-52 compatible blendshape weights. */
|
|
55
|
+
arkitWeights?: number[];
|
|
56
|
+
}
|
|
57
|
+
export interface ValidationResult {
|
|
58
|
+
valid: boolean;
|
|
59
|
+
errors: string[];
|
|
60
|
+
}
|
|
61
|
+
export declare const NEUTRAL_ARCHETYPE_MALE: HumanDNA;
|
|
62
|
+
export declare const NEUTRAL_ARCHETYPE_FEMALE: HumanDNA;
|
|
63
|
+
export declare const DOUBLE_WHORL_ARCHETYPE: HumanDNA;
|
|
64
|
+
/**
|
|
65
|
+
* Validate a HumanDNA configuration against empirical biological and geometric bounds.
|
|
66
|
+
*/
|
|
67
|
+
export declare function validateHumanDNA(dna: HumanDNA): ValidationResult;
|
|
68
|
+
//# sourceMappingURL=dna.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"dna.d.ts","sourceRoot":"","sources":["../src/dna.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAQH,OAAO,EAGL,KAAK,aAAa,EACnB,MAAM,gBAAgB,CAAC;AAExB,MAAM,WAAW,gBAAgB;IAC/B,mGAAmG;IACnG,MAAM,EAAE,aAAa,EAAE,CAAC;IACxB,+DAA+D;IAC/D,gBAAgB,EAAE,MAAM,CAAC;IACzB,wFAAwF;IACxF,SAAS,EAAE,MAAM,CAAC;IAClB,6FAA6F;IAC7F,aAAa,EAAE,MAAM,CAAC;IACtB,0FAA0F;IAC1F,eAAe,EAAE,MAAM,CAAC;IACxB,oFAAoF;IACpF,gBAAgB,EAAE;QAChB,eAAe,EAAE,MAAM,CAAC;QACxB,QAAQ,EAAE,MAAM,CAAC;QACjB,QAAQ,EAAE,MAAM,CAAC;QACjB,QAAQ,EAAE,MAAM,CAAC;QACjB,WAAW,EAAE,MAAM,CAAC;QACpB,IAAI,EAAE,MAAM,CAAC;KACd,CAAC;IACF,kEAAkE;IAClE,sBAAsB,EAAE,MAAM,CAAC;IAC/B,yGAAyG;IACzG,oBAAoB,EAAE,MAAM,CAAC;IAC7B,mCAAmC;IACnC,WAAW,EAAE,MAAM,CAAC;IACpB,kCAAkC;IAClC,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,eAAe;IAC9B,kEAAkE;IAClE,QAAQ,EAAE,MAAM,CAAC;IACjB,yEAAyE;IACzE,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,uBAAuB,CAAC,EAAE,MAAM,CAAC;IACjC,qEAAqE;IACrE,aAAa,EAAE,MAAM,CAAC;IACtB,uDAAuD;IACvD,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,GAAG,QAAQ,GAAG,SAAS,CAAC;IACnC,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,eAAe,CAAC;IACtB,SAAS,EAAE,gBAAgB,CAAC;IAC5B,uDAAuD;IACvD,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;CACzB;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,eAAO,MAAM,sBAAsB,EAAE,QAyCpC,CAAC;AAEF,eAAO,MAAM,wBAAwB,EAAE,QAyCtC,CAAC;AAEF,eAAO,MAAM,sBAAsB,EAAE,QAiDpC,CAAC;AAEF;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,QAAQ,GAAG,gBAAgB,CAyDhE"}
|
package/dist/dna.js
ADDED
|
@@ -0,0 +1,185 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Parametric HVMAN DNA schema and synthetic archetypes built around individual variation
|
|
3
|
+
* across stature, body proportions, scalp whorls, hair stiffness/caliber, and follicular density.
|
|
4
|
+
*/
|
|
5
|
+
import { ACROMION_HEIGHT_RATIO, EYE_HEIGHT_RATIO, STANDING_HEIGHT_CM_RANGE, SUPRASTERNAL_HEIGHT_RATIO, } from './anthropometry.js';
|
|
6
|
+
import { FOLLICULAR_DENSITY_FU_CM2_BOUNDS, HAIR_CALIBER_UM_BOUNDS, } from './hairWhorl.js';
|
|
7
|
+
export const NEUTRAL_ARCHETYPE_MALE = {
|
|
8
|
+
id: 'hvman-archetype-male-01',
|
|
9
|
+
label: 'Neutral Archetype Male 01',
|
|
10
|
+
sex: 'male',
|
|
11
|
+
age: 34,
|
|
12
|
+
body: {
|
|
13
|
+
heightCm: 174,
|
|
14
|
+
eyeHeightRatio: EYE_HEIGHT_RATIO.defaultValue,
|
|
15
|
+
acromionHeightRatio: ACROMION_HEIGHT_RATIO.defaultValue,
|
|
16
|
+
suprasternalHeightRatio: SUPRASTERNAL_HEIGHT_RATIO.defaultValue,
|
|
17
|
+
shoulderScale: 1.0,
|
|
18
|
+
bodyMassFactor: 0.48,
|
|
19
|
+
},
|
|
20
|
+
scalpHair: {
|
|
21
|
+
whorls: [
|
|
22
|
+
{
|
|
23
|
+
center: [0.012, 0.105, -0.055],
|
|
24
|
+
chirality: 'cw',
|
|
25
|
+
swirlStrength: 0.85,
|
|
26
|
+
radialStrength: 0.45,
|
|
27
|
+
influenceRadiusM: 0.075,
|
|
28
|
+
weight: 1.0,
|
|
29
|
+
},
|
|
30
|
+
],
|
|
31
|
+
strandDiameterUm: 95,
|
|
32
|
+
stiffness: 0.82,
|
|
33
|
+
tipFeathering: 0.15,
|
|
34
|
+
tipTranslucency: 0.08,
|
|
35
|
+
exitAngleBiasDeg: {
|
|
36
|
+
frontalHairline: 4,
|
|
37
|
+
temporal: 0,
|
|
38
|
+
midScalp: 5,
|
|
39
|
+
parietal: 2,
|
|
40
|
+
vertexCrown: 5,
|
|
41
|
+
nape: 0,
|
|
42
|
+
},
|
|
43
|
+
follicularDensityFuCm2: 72,
|
|
44
|
+
miniaturizationRatio: 0.08,
|
|
45
|
+
topLengthMm: 18,
|
|
46
|
+
fadeHeight: 0.45,
|
|
47
|
+
},
|
|
48
|
+
};
|
|
49
|
+
export const NEUTRAL_ARCHETYPE_FEMALE = {
|
|
50
|
+
id: 'hvman-archetype-female-01',
|
|
51
|
+
label: 'Neutral Archetype Female 01',
|
|
52
|
+
sex: 'female',
|
|
53
|
+
age: 28,
|
|
54
|
+
body: {
|
|
55
|
+
heightCm: 164,
|
|
56
|
+
eyeHeightRatio: EYE_HEIGHT_RATIO.defaultValue,
|
|
57
|
+
acromionHeightRatio: 0.825,
|
|
58
|
+
suprasternalHeightRatio: 0.79,
|
|
59
|
+
shoulderScale: 0.92,
|
|
60
|
+
bodyMassFactor: 0.36,
|
|
61
|
+
},
|
|
62
|
+
scalpHair: {
|
|
63
|
+
whorls: [
|
|
64
|
+
{
|
|
65
|
+
center: [-0.01, 0.106, -0.052],
|
|
66
|
+
chirality: 'cw',
|
|
67
|
+
swirlStrength: 0.8,
|
|
68
|
+
radialStrength: 0.48,
|
|
69
|
+
influenceRadiusM: 0.08,
|
|
70
|
+
weight: 1.0,
|
|
71
|
+
},
|
|
72
|
+
],
|
|
73
|
+
strandDiameterUm: 72,
|
|
74
|
+
stiffness: 0.28,
|
|
75
|
+
tipFeathering: 0.75,
|
|
76
|
+
tipTranslucency: 0.45,
|
|
77
|
+
exitAngleBiasDeg: {
|
|
78
|
+
frontalHairline: -2,
|
|
79
|
+
temporal: -2,
|
|
80
|
+
midScalp: -6,
|
|
81
|
+
parietal: -5,
|
|
82
|
+
vertexCrown: -6,
|
|
83
|
+
nape: -2,
|
|
84
|
+
},
|
|
85
|
+
follicularDensityFuCm2: 78,
|
|
86
|
+
miniaturizationRatio: 0.02,
|
|
87
|
+
topLengthMm: 28,
|
|
88
|
+
fadeHeight: 0.15,
|
|
89
|
+
},
|
|
90
|
+
};
|
|
91
|
+
export const DOUBLE_WHORL_ARCHETYPE = {
|
|
92
|
+
id: 'hvman-archetype-double-whorl-01',
|
|
93
|
+
label: 'Synthetic Double-Whorl Archetype',
|
|
94
|
+
sex: 'male',
|
|
95
|
+
age: 42,
|
|
96
|
+
body: {
|
|
97
|
+
heightCm: 178,
|
|
98
|
+
eyeHeightRatio: 0.922,
|
|
99
|
+
acromionHeightRatio: 0.832,
|
|
100
|
+
suprasternalHeightRatio: 0.792,
|
|
101
|
+
shoulderScale: 1.05,
|
|
102
|
+
bodyMassFactor: 0.56,
|
|
103
|
+
},
|
|
104
|
+
scalpHair: {
|
|
105
|
+
whorls: [
|
|
106
|
+
{
|
|
107
|
+
center: [-0.024, 0.104, -0.056],
|
|
108
|
+
chirality: 'cw',
|
|
109
|
+
swirlStrength: 0.9,
|
|
110
|
+
radialStrength: 0.42,
|
|
111
|
+
influenceRadiusM: 0.062,
|
|
112
|
+
weight: 1.0,
|
|
113
|
+
},
|
|
114
|
+
{
|
|
115
|
+
center: [0.025, 0.103, -0.054],
|
|
116
|
+
chirality: 'ccw',
|
|
117
|
+
swirlStrength: 0.86,
|
|
118
|
+
radialStrength: 0.44,
|
|
119
|
+
influenceRadiusM: 0.06,
|
|
120
|
+
weight: 0.95,
|
|
121
|
+
},
|
|
122
|
+
],
|
|
123
|
+
strandDiameterUm: 54,
|
|
124
|
+
stiffness: 0.4,
|
|
125
|
+
tipFeathering: 0.55,
|
|
126
|
+
tipTranslucency: 0.35,
|
|
127
|
+
exitAngleBiasDeg: {
|
|
128
|
+
frontalHairline: 2,
|
|
129
|
+
temporal: 2,
|
|
130
|
+
midScalp: 0,
|
|
131
|
+
parietal: 0,
|
|
132
|
+
vertexCrown: 4,
|
|
133
|
+
nape: 0,
|
|
134
|
+
},
|
|
135
|
+
follicularDensityFuCm2: 52,
|
|
136
|
+
miniaturizationRatio: 0.45,
|
|
137
|
+
topLengthMm: 14,
|
|
138
|
+
fadeHeight: 0.35,
|
|
139
|
+
},
|
|
140
|
+
};
|
|
141
|
+
/**
|
|
142
|
+
* Validate a HumanDNA configuration against empirical biological and geometric bounds.
|
|
143
|
+
*/
|
|
144
|
+
export function validateHumanDNA(dna) {
|
|
145
|
+
const errors = [];
|
|
146
|
+
if (!dna.id.trim()) {
|
|
147
|
+
errors.push('dna.id must not be empty');
|
|
148
|
+
}
|
|
149
|
+
if (!Number.isFinite(dna.age) || dna.age < 18 || dna.age > 110) {
|
|
150
|
+
errors.push(`dna.age (${dna.age}) must be within [18, 110]`);
|
|
151
|
+
}
|
|
152
|
+
const h = dna.body.heightCm;
|
|
153
|
+
if (!Number.isFinite(h) ||
|
|
154
|
+
h < STANDING_HEIGHT_CM_RANGE.min ||
|
|
155
|
+
h > STANDING_HEIGHT_CM_RANGE.max) {
|
|
156
|
+
errors.push(`body.heightCm (${h}) must be within [${STANDING_HEIGHT_CM_RANGE.min}, ${STANDING_HEIGHT_CM_RANGE.max}]`);
|
|
157
|
+
}
|
|
158
|
+
const hair = dna.scalpHair;
|
|
159
|
+
const minCal = HAIR_CALIBER_UM_BOUNDS.miniaturized.min;
|
|
160
|
+
const maxCal = HAIR_CALIBER_UM_BOUNDS.coarse.max;
|
|
161
|
+
if (!Number.isFinite(hair.strandDiameterUm) ||
|
|
162
|
+
hair.strandDiameterUm < minCal ||
|
|
163
|
+
hair.strandDiameterUm > maxCal) {
|
|
164
|
+
errors.push(`scalpHair.strandDiameterUm (${hair.strandDiameterUm}) must be within [${minCal}, ${maxCal}]`);
|
|
165
|
+
}
|
|
166
|
+
if (!Number.isFinite(hair.follicularDensityFuCm2) ||
|
|
167
|
+
hair.follicularDensityFuCm2 < FOLLICULAR_DENSITY_FU_CM2_BOUNDS.min ||
|
|
168
|
+
hair.follicularDensityFuCm2 > FOLLICULAR_DENSITY_FU_CM2_BOUNDS.max) {
|
|
169
|
+
errors.push(`scalpHair.follicularDensityFuCm2 (${hair.follicularDensityFuCm2}) must be within [${FOLLICULAR_DENSITY_FU_CM2_BOUNDS.min}, ${FOLLICULAR_DENSITY_FU_CM2_BOUNDS.max}]`);
|
|
170
|
+
}
|
|
171
|
+
if (hair.miniaturizationRatio < 0 || hair.miniaturizationRatio > 1) {
|
|
172
|
+
errors.push(`scalpHair.miniaturizationRatio (${hair.miniaturizationRatio}) must be within [0, 1]`);
|
|
173
|
+
}
|
|
174
|
+
for (let i = 0; i < hair.whorls.length; i++) {
|
|
175
|
+
const w = hair.whorls[i];
|
|
176
|
+
if (!Number.isFinite(w.influenceRadiusM) || w.influenceRadiusM <= 0 || w.influenceRadiusM > 0.25) {
|
|
177
|
+
errors.push(`scalpHair.whorls[${i}].influenceRadiusM (${w.influenceRadiusM}) must be in (0, 0.25]`);
|
|
178
|
+
}
|
|
179
|
+
}
|
|
180
|
+
return {
|
|
181
|
+
valid: errors.length === 0,
|
|
182
|
+
errors,
|
|
183
|
+
};
|
|
184
|
+
}
|
|
185
|
+
//# sourceMappingURL=dna.js.map
|
package/dist/dna.js.map
ADDED
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"dna.js","sourceRoot":"","sources":["../src/dna.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,91 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Empirical scalp hair exit angles, hair caliber/density bounds,
|
|
3
|
+
* and continuous tangent-plane logarithmic spiral vector field evaluation.
|
|
4
|
+
*/
|
|
5
|
+
export type Vec3 = [number, number, number];
|
|
6
|
+
export type WhorlChirality = 'cw' | 'ccw';
|
|
7
|
+
export interface AngleRangeDeg {
|
|
8
|
+
readonly minDeg: number;
|
|
9
|
+
readonly maxDeg: number;
|
|
10
|
+
}
|
|
11
|
+
/**
|
|
12
|
+
* Empirical follicular exit angle bounds relative to the scalp surface (ISHRS clinical ranges).
|
|
13
|
+
*/
|
|
14
|
+
export declare const SCALP_EXIT_ANGLE_RANGES_DEG: {
|
|
15
|
+
readonly temporal: {
|
|
16
|
+
readonly minDeg: 5;
|
|
17
|
+
readonly maxDeg: 10;
|
|
18
|
+
};
|
|
19
|
+
readonly frontalHairline: {
|
|
20
|
+
readonly minDeg: 10;
|
|
21
|
+
readonly maxDeg: 20;
|
|
22
|
+
};
|
|
23
|
+
readonly midScalp: {
|
|
24
|
+
readonly minDeg: 30;
|
|
25
|
+
readonly maxDeg: 45;
|
|
26
|
+
};
|
|
27
|
+
readonly parietal: {
|
|
28
|
+
readonly minDeg: 30;
|
|
29
|
+
readonly maxDeg: 40;
|
|
30
|
+
};
|
|
31
|
+
readonly vertexCrown: {
|
|
32
|
+
readonly minDeg: 45;
|
|
33
|
+
readonly maxDeg: 60;
|
|
34
|
+
};
|
|
35
|
+
readonly nape: {
|
|
36
|
+
readonly minDeg: 10;
|
|
37
|
+
readonly maxDeg: 20;
|
|
38
|
+
};
|
|
39
|
+
};
|
|
40
|
+
/** Individual strand diameter ranges in micrometers (um). */
|
|
41
|
+
export declare const HAIR_CALIBER_UM_BOUNDS: {
|
|
42
|
+
readonly miniaturized: {
|
|
43
|
+
readonly min: 30;
|
|
44
|
+
readonly max: 50;
|
|
45
|
+
};
|
|
46
|
+
readonly fine: {
|
|
47
|
+
readonly min: 50;
|
|
48
|
+
readonly max: 70;
|
|
49
|
+
};
|
|
50
|
+
readonly medium: {
|
|
51
|
+
readonly min: 70;
|
|
52
|
+
readonly max: 90;
|
|
53
|
+
};
|
|
54
|
+
readonly coarse: {
|
|
55
|
+
readonly min: 90;
|
|
56
|
+
readonly max: 125;
|
|
57
|
+
};
|
|
58
|
+
};
|
|
59
|
+
/** Scalp follicular unit density reference bounds (FU/cm^2). */
|
|
60
|
+
export declare const FOLLICULAR_DENSITY_FU_CM2_BOUNDS: {
|
|
61
|
+
readonly min: 15;
|
|
62
|
+
readonly typicalEastAsianMin: 60;
|
|
63
|
+
readonly typicalEastAsianMax: 85;
|
|
64
|
+
readonly max: 120;
|
|
65
|
+
};
|
|
66
|
+
export interface HairWhorlSpec {
|
|
67
|
+
/** Whorl center on head/scalp space in meters. */
|
|
68
|
+
center: Vec3;
|
|
69
|
+
/** Rotational chirality as viewed from outside looking down onto the scalp ('cw' | 'ccw'). */
|
|
70
|
+
chirality: WhorlChirality;
|
|
71
|
+
/** Tangential circulation weight (Gamma). */
|
|
72
|
+
swirlStrength: number;
|
|
73
|
+
/** Outward radial divergence weight (m). */
|
|
74
|
+
radialStrength: number;
|
|
75
|
+
/** Gaussian decay radius in meters; influence peaks at the center and fades outward. */
|
|
76
|
+
influenceRadiusM: number;
|
|
77
|
+
/** Relative blending weight when combining multiple whorls. */
|
|
78
|
+
weight?: number;
|
|
79
|
+
}
|
|
80
|
+
export interface WhorlFieldResult {
|
|
81
|
+
/** Unit-length hair flow direction projected onto the scalp tangent plane. */
|
|
82
|
+
tangent: Vec3;
|
|
83
|
+
/** Combined whorl influence weight in [0, 1). */
|
|
84
|
+
totalInfluence: number;
|
|
85
|
+
}
|
|
86
|
+
/**
|
|
87
|
+
* Evaluate the continuous tangent-plane hair flow direction driven by 0..N scalp hair whorls
|
|
88
|
+
* with Gaussian distance decay around each singularity center.
|
|
89
|
+
*/
|
|
90
|
+
export declare function evaluateScalpWhorlField(point: Vec3, surfaceNormal: Vec3, whorls: readonly HairWhorlSpec[], baseFlow?: Vec3): WhorlFieldResult;
|
|
91
|
+
//# sourceMappingURL=hairWhorl.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"hairWhorl.d.ts","sourceRoot":"","sources":["../src/hairWhorl.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,MAAM,IAAI,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;AAC5C,MAAM,MAAM,cAAc,GAAG,IAAI,GAAG,KAAK,CAAC;AAE1C,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED;;GAEG;AACH,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;;;;;;;;;;;;;CAOU,CAAC;AAEnD,6DAA6D;AAC7D,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;CAKzB,CAAC;AAEX,gEAAgE;AAChE,eAAO,MAAM,gCAAgC;;;;;CAKnC,CAAC;AAEX,MAAM,WAAW,aAAa;IAC5B,kDAAkD;IAClD,MAAM,EAAE,IAAI,CAAC;IACb,8FAA8F;IAC9F,SAAS,EAAE,cAAc,CAAC;IAC1B,6CAA6C;IAC7C,aAAa,EAAE,MAAM,CAAC;IACtB,4CAA4C;IAC5C,cAAc,EAAE,MAAM,CAAC;IACvB,wFAAwF;IACxF,gBAAgB,EAAE,MAAM,CAAC;IACzB,+DAA+D;IAC/D,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,gBAAgB;IAC/B,8EAA8E;IAC9E,OAAO,EAAE,IAAI,CAAC;IACd,iDAAiD;IACjD,cAAc,EAAE,MAAM,CAAC;CACxB;AAqCD;;;GAGG;AACH,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,IAAI,EACX,aAAa,EAAE,IAAI,EACnB,MAAM,EAAE,SAAS,aAAa,EAAE,EAChC,QAAQ,CAAC,EAAE,IAAI,GACd,gBAAgB,CAyElB"}
|
|
@@ -0,0 +1,123 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Empirical scalp hair exit angles, hair caliber/density bounds,
|
|
3
|
+
* and continuous tangent-plane logarithmic spiral vector field evaluation.
|
|
4
|
+
*/
|
|
5
|
+
/**
|
|
6
|
+
* Empirical follicular exit angle bounds relative to the scalp surface (ISHRS clinical ranges).
|
|
7
|
+
*/
|
|
8
|
+
export const SCALP_EXIT_ANGLE_RANGES_DEG = {
|
|
9
|
+
temporal: { minDeg: 5, maxDeg: 10 },
|
|
10
|
+
frontalHairline: { minDeg: 10, maxDeg: 20 },
|
|
11
|
+
midScalp: { minDeg: 30, maxDeg: 45 },
|
|
12
|
+
parietal: { minDeg: 30, maxDeg: 40 },
|
|
13
|
+
vertexCrown: { minDeg: 45, maxDeg: 60 },
|
|
14
|
+
nape: { minDeg: 10, maxDeg: 20 },
|
|
15
|
+
};
|
|
16
|
+
/** Individual strand diameter ranges in micrometers (um). */
|
|
17
|
+
export const HAIR_CALIBER_UM_BOUNDS = {
|
|
18
|
+
miniaturized: { min: 30, max: 50 },
|
|
19
|
+
fine: { min: 50, max: 70 },
|
|
20
|
+
medium: { min: 70, max: 90 },
|
|
21
|
+
coarse: { min: 90, max: 125 },
|
|
22
|
+
};
|
|
23
|
+
/** Scalp follicular unit density reference bounds (FU/cm^2). */
|
|
24
|
+
export const FOLLICULAR_DENSITY_FU_CM2_BOUNDS = {
|
|
25
|
+
min: 15,
|
|
26
|
+
typicalEastAsianMin: 60,
|
|
27
|
+
typicalEastAsianMax: 85,
|
|
28
|
+
max: 120,
|
|
29
|
+
};
|
|
30
|
+
function dot(a, b) {
|
|
31
|
+
return a[0] * b[0] + a[1] * b[1] + a[2] * b[2];
|
|
32
|
+
}
|
|
33
|
+
function cross(a, b) {
|
|
34
|
+
return [
|
|
35
|
+
a[1] * b[2] - a[2] * b[1],
|
|
36
|
+
a[2] * b[0] - a[0] * b[2],
|
|
37
|
+
a[0] * b[1] - a[1] * b[0],
|
|
38
|
+
];
|
|
39
|
+
}
|
|
40
|
+
function normSq(v) {
|
|
41
|
+
return dot(v, v);
|
|
42
|
+
}
|
|
43
|
+
function normalizeOrFallback(v, fallback) {
|
|
44
|
+
const len = Math.hypot(v[0], v[1], v[2]);
|
|
45
|
+
if (len > 1e-8) {
|
|
46
|
+
return [v[0] / len, v[1] / len, v[2] / len];
|
|
47
|
+
}
|
|
48
|
+
return [...fallback];
|
|
49
|
+
}
|
|
50
|
+
function projectToTangentPlane(v, unitN) {
|
|
51
|
+
const d = dot(v, unitN);
|
|
52
|
+
return [v[0] - unitN[0] * d, v[1] - unitN[1] * d, v[2] - unitN[2] * d];
|
|
53
|
+
}
|
|
54
|
+
function buildFallbackTangent(unitN) {
|
|
55
|
+
const candidate = Math.abs(unitN[1]) < 0.9 ? [0, -1, 0] : [0, 0, -1];
|
|
56
|
+
const proj = projectToTangentPlane(candidate, unitN);
|
|
57
|
+
return normalizeOrFallback(proj, [1, 0, 0]);
|
|
58
|
+
}
|
|
59
|
+
/**
|
|
60
|
+
* Evaluate the continuous tangent-plane hair flow direction driven by 0..N scalp hair whorls
|
|
61
|
+
* with Gaussian distance decay around each singularity center.
|
|
62
|
+
*/
|
|
63
|
+
export function evaluateScalpWhorlField(point, surfaceNormal, whorls, baseFlow) {
|
|
64
|
+
const unitN = normalizeOrFallback(surfaceNormal, [0, 1, 0]);
|
|
65
|
+
const fallbackTangent = buildFallbackTangent(unitN);
|
|
66
|
+
const rawBaseProj = baseFlow
|
|
67
|
+
? projectToTangentPlane(baseFlow, unitN)
|
|
68
|
+
: projectToTangentPlane([0, -1, 0], unitN);
|
|
69
|
+
const baseTangent = normalizeOrFallback(rawBaseProj, fallbackTangent);
|
|
70
|
+
if (whorls.length === 0) {
|
|
71
|
+
return { tangent: baseTangent, totalInfluence: 0 };
|
|
72
|
+
}
|
|
73
|
+
let accX = 0;
|
|
74
|
+
let accY = 0;
|
|
75
|
+
let accZ = 0;
|
|
76
|
+
let weightSum = 0;
|
|
77
|
+
for (const whorl of whorls) {
|
|
78
|
+
const radius = Math.max(1e-4, whorl.influenceRadiusM);
|
|
79
|
+
const wBase = Math.max(0, whorl.weight ?? 1);
|
|
80
|
+
const delta = [
|
|
81
|
+
point[0] - whorl.center[0],
|
|
82
|
+
point[1] - whorl.center[1],
|
|
83
|
+
point[2] - whorl.center[2],
|
|
84
|
+
];
|
|
85
|
+
const deltaTan = projectToTangentPlane(delta, unitN);
|
|
86
|
+
const r = Math.hypot(deltaTan[0], deltaTan[1], deltaTan[2]);
|
|
87
|
+
const decay = wBase * Math.exp(-((r / radius) ** 2));
|
|
88
|
+
weightSum += decay;
|
|
89
|
+
// Right at the singularity core (r -> 0), skip directional cross-product to prevent NaN.
|
|
90
|
+
if (r > 1e-7 && decay > 1e-8) {
|
|
91
|
+
const er = [deltaTan[0] / r, deltaTan[1] / r, deltaTan[2] / r];
|
|
92
|
+
const ccwTheta = cross(unitN, er);
|
|
93
|
+
const chiSign = whorl.chirality === 'cw' ? -1 : 1;
|
|
94
|
+
const eTheta = [
|
|
95
|
+
ccwTheta[0] * chiSign,
|
|
96
|
+
ccwTheta[1] * chiSign,
|
|
97
|
+
ccwTheta[2] * chiSign,
|
|
98
|
+
];
|
|
99
|
+
accX += decay * (whorl.swirlStrength * eTheta[0] + whorl.radialStrength * er[0]);
|
|
100
|
+
accY += decay * (whorl.swirlStrength * eTheta[1] + whorl.radialStrength * er[1]);
|
|
101
|
+
accZ += decay * (whorl.swirlStrength * eTheta[2] + whorl.radialStrength * er[2]);
|
|
102
|
+
}
|
|
103
|
+
}
|
|
104
|
+
const totalInfluence = 1 - Math.exp(-weightSum);
|
|
105
|
+
const whorlVec = [accX, accY, accZ];
|
|
106
|
+
if (normSq(whorlVec) <= 1e-16) {
|
|
107
|
+
return { tangent: baseTangent, totalInfluence };
|
|
108
|
+
}
|
|
109
|
+
const whorlDir = normalizeOrFallback(projectToTangentPlane(whorlVec, unitN), baseTangent);
|
|
110
|
+
const blended = [
|
|
111
|
+
baseTangent[0] * (1 - totalInfluence) + whorlDir[0] * totalInfluence,
|
|
112
|
+
baseTangent[1] * (1 - totalInfluence) + whorlDir[1] * totalInfluence,
|
|
113
|
+
baseTangent[2] * (1 - totalInfluence) + whorlDir[2] * totalInfluence,
|
|
114
|
+
];
|
|
115
|
+
// If blended cancels out due to exact 180-deg opposition, fall back orthogonally to unitN.
|
|
116
|
+
const orthoFallback = normalizeOrFallback(cross(unitN, baseTangent), whorlDir);
|
|
117
|
+
const finalTangent = normalizeOrFallback(projectToTangentPlane(blended, unitN), orthoFallback);
|
|
118
|
+
return {
|
|
119
|
+
tangent: finalTangent,
|
|
120
|
+
totalInfluence,
|
|
121
|
+
};
|
|
122
|
+
}
|
|
123
|
+
//# sourceMappingURL=hairWhorl.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"hairWhorl.js","sourceRoot":"","sources":["../src/hairWhorl.ts"],"names":[],"mappings":"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"}
|
package/dist/index.d.ts
ADDED
|
@@ -0,0 +1,5 @@
|
|
|
1
|
+
export declare const HVMAN_VERSION = "0.0.1";
|
|
2
|
+
export { ACROMION_HEIGHT_RATIO, computeStandingLandmarks, EYE_HEIGHT_RATIO, STANDING_HEIGHT_CM_RANGE, SUPRASTERNAL_HEIGHT_RATIO, type NumericRange, type StandingLandmarkRatios, type StandingLandmarksMeters, } from './anthropometry.js';
|
|
3
|
+
export { evaluateScalpWhorlField, FOLLICULAR_DENSITY_FU_CM2_BOUNDS, HAIR_CALIBER_UM_BOUNDS, SCALP_EXIT_ANGLE_RANGES_DEG, type AngleRangeDeg, type HairWhorlSpec, type Vec3, type WhorlChirality, type WhorlFieldResult, } from './hairWhorl.js';
|
|
4
|
+
export { DOUBLE_WHORL_ARCHETYPE, NEUTRAL_ARCHETYPE_FEMALE, NEUTRAL_ARCHETYPE_MALE, validateHumanDNA, type BodyProportions, type HumanDNA, type ScalpHairProfile, type ValidationResult, } from './dna.js';
|
|
5
|
+
//# sourceMappingURL=index.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,aAAa,UAAU,CAAC;AAErC,OAAO,EACL,qBAAqB,EACrB,wBAAwB,EACxB,gBAAgB,EAChB,wBAAwB,EACxB,yBAAyB,EACzB,KAAK,YAAY,EACjB,KAAK,sBAAsB,EAC3B,KAAK,uBAAuB,GAC7B,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACL,uBAAuB,EACvB,gCAAgC,EAChC,sBAAsB,EACtB,2BAA2B,EAC3B,KAAK,aAAa,EAClB,KAAK,aAAa,EAClB,KAAK,IAAI,EACT,KAAK,cAAc,EACnB,KAAK,gBAAgB,GACtB,MAAM,gBAAgB,CAAC;AAExB,OAAO,EACL,sBAAsB,EACtB,wBAAwB,EACxB,sBAAsB,EACtB,gBAAgB,EAChB,KAAK,eAAe,EACpB,KAAK,QAAQ,EACb,KAAK,gBAAgB,EACrB,KAAK,gBAAgB,GACtB,MAAM,UAAU,CAAC"}
|
package/dist/index.js
ADDED
|
@@ -0,0 +1,5 @@
|
|
|
1
|
+
export const HVMAN_VERSION = '0.0.1';
|
|
2
|
+
export { ACROMION_HEIGHT_RATIO, computeStandingLandmarks, EYE_HEIGHT_RATIO, STANDING_HEIGHT_CM_RANGE, SUPRASTERNAL_HEIGHT_RATIO, } from './anthropometry.js';
|
|
3
|
+
export { evaluateScalpWhorlField, FOLLICULAR_DENSITY_FU_CM2_BOUNDS, HAIR_CALIBER_UM_BOUNDS, SCALP_EXIT_ANGLE_RANGES_DEG, } from './hairWhorl.js';
|
|
4
|
+
export { DOUBLE_WHORL_ARCHETYPE, NEUTRAL_ARCHETYPE_FEMALE, NEUTRAL_ARCHETYPE_MALE, validateHumanDNA, } from './dna.js';
|
|
5
|
+
//# sourceMappingURL=index.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,aAAa,GAAG,OAAO,CAAC;AAErC,OAAO,EACL,qBAAqB,EACrB,wBAAwB,EACxB,gBAAgB,EAChB,wBAAwB,EACxB,yBAAyB,GAI1B,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACL,uBAAuB,EACvB,gCAAgC,EAChC,sBAAsB,EACtB,2BAA2B,GAM5B,MAAM,gBAAgB,CAAC;AAExB,OAAO,EACL,sBAAsB,EACtB,wBAAwB,EACxB,sBAAsB,EACtB,gBAAgB,GAKjB,MAAM,UAAU,CAAC"}
|
package/package.json
CHANGED
|
@@ -1,6 +1,49 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "hvman",
|
|
3
|
-
"version": "0.0.
|
|
4
|
-
"
|
|
5
|
-
"
|
|
6
|
-
|
|
3
|
+
"version": "0.0.1",
|
|
4
|
+
"description": "HVMAN — Open-world parametric 3D human foundation: empirical anthropometry, scalp hair whorl vector fields, and individual DNA schema.",
|
|
5
|
+
"type": "module",
|
|
6
|
+
"main": "./dist/index.js",
|
|
7
|
+
"types": "./dist/index.d.ts",
|
|
8
|
+
"exports": {
|
|
9
|
+
".": {
|
|
10
|
+
"types": "./dist/index.d.ts",
|
|
11
|
+
"import": "./dist/index.js"
|
|
12
|
+
}
|
|
13
|
+
},
|
|
14
|
+
"files": [
|
|
15
|
+
"dist",
|
|
16
|
+
"README.md",
|
|
17
|
+
"LICENSE"
|
|
18
|
+
],
|
|
19
|
+
"license": "MIT",
|
|
20
|
+
"repository": {
|
|
21
|
+
"type": "git",
|
|
22
|
+
"url": "https://github.com/happidaswork-netizen/hvman.git"
|
|
23
|
+
},
|
|
24
|
+
"homepage": "https://github.com/happidaswork-netizen/hvman#readme",
|
|
25
|
+
"bugs": {
|
|
26
|
+
"url": "https://github.com/happidaswork-netizen/hvman/issues"
|
|
27
|
+
},
|
|
28
|
+
"keywords": [
|
|
29
|
+
"hvman",
|
|
30
|
+
"human",
|
|
31
|
+
"3d-human",
|
|
32
|
+
"anthropometry",
|
|
33
|
+
"hair-whorl",
|
|
34
|
+
"parametric",
|
|
35
|
+
"webgpu",
|
|
36
|
+
"digital-human"
|
|
37
|
+
],
|
|
38
|
+
"engines": {
|
|
39
|
+
"node": ">=18.0.0"
|
|
40
|
+
},
|
|
41
|
+
"scripts": {
|
|
42
|
+
"build": "tsc",
|
|
43
|
+
"test": "node --test tests/*.test.mjs",
|
|
44
|
+
"prepublishOnly": "npm run build && npm test"
|
|
45
|
+
},
|
|
46
|
+
"devDependencies": {
|
|
47
|
+
"typescript": "^5.9.3"
|
|
48
|
+
}
|
|
49
|
+
}
|