ephemeris_ziwei #

Explicit chart clocks support fixed-offset and mean/apparent solar time across natal charts, flows, and reverse lookup. These methods require matching core and Ziwei native libraries.

New in beta.7: immutable natal edits and independent manual, number and random casting charts. See the guide. These APIs require Taiyin v1.0.0-beta.9 native modules. Release assembly uses the validated CI artifacts; a source checkout may still contain older binaries.

Pre-release: 1.0.0-rc.1, kept in lockstep with the Dart ephemeris core package.

Ziwei Doushu (紫微斗数) extension bindings for the Taiyin ephemeris, part of the dart-ephemeris monorepo. Mirrors packages/ephemeris-ziwei in the Python binding.

dart pub add ephemeris
dart pub add ephemeris_ziwei

Generated API reference: https://pub.flutter-io.cn/documentation/ephemeris_ziwei/latest/

See the Ziwei Doushu guide for the bundled rule profile, independent option dimensions, custom TOML catalogs, natal charts, flow layers, Rat-hour policies, and reverse lookup.

Depends on the core ephemeris package. Importing this package adds context.ziwei and context.createZiwei() to EphemerisContext:

import 'package:ephemeris/ephemeris.dart';
import 'package:ephemeris_ziwei/ephemeris_ziwei.dart';

void main() {
  final ephemeris = Ephemeris.open();
  final context = ephemeris.createContext();
  try {
    final result = context.ziwei.calculateLocal(
      AstroDateTime(2003, 3, 13, 14, 15),
      gender: ZiweiGender.male,
    );
    final fromDay = context.ziwei.calculateSolarDay(
      const SolarDate(year: 2003, month: 3, day: 13),
      hour: 14,
      minute: 15,
      gender: ZiweiGender.male,
    );
    print(result.value.summary.bureauId);
    print(result.flags.values);
  } finally {
    context.close();
  }
}

calculateSolarDay() and calculateLunarDay() combine a calendar day with explicit clock fields. calculateLocal(), calculateInstant(), and both day factories accept ZiweiClock for fixed-offset, mean-solar, or apparent-solar chart time.

The default TOML rule profile ships bundled under lib/data/ziwei/rules/ and loads automatically. ZiweiDataCatalog(profilePath: ...) loads a custom profile; a catalog can be shared across Ziwei contexts.

JSON option modules can add named alternatives without replacing the bundled TOML options:

final ruleset = const ZiweiRuleset().addModule(
  const ZiweiJsonRuleModule(
    label: 'school-a',
    starsJson:
        '[{"key":"ziwei","rule":{"type":"constant","value":5}}]',
  ),
);
final ziwei = context.createZiwei(
  ruleset: ruleset,
  selection: const ZiweiOptionSelection(
    placement: {'ziwei': 'school-a'},
  ),
);

final restored = ruleset.removeModule('school-a');

Module labels must be unique and cannot replace bundled option names. Removing a module removes every star, brightness, Si-Hua, flow-star, and master-table contribution registered under that label. Modules are compiled while the native context is created, so ZiweiRuleset owns no native resource and needs no close(). ZiweiStar.isNatal distinguishes natal and flow-only stars.

This package ships and lazily loads its own libtaiyin_ziwei native module; the root ephemeris package does not contain Ziwei symbols. Override the bundled module with TAIYIN_ZIWEI_LIBRARY_PATH, createZiwei(libraryPath: ...), or ZiweiDataCatalog(libraryPath: ...). A missing module raises UnsupportedError while the core context remains usable.

For isolate parallelism, create one Ziwei context and independent charts per worker. Catalog snapshots are immutable, but a mutable chart must not be modified concurrently from more than one isolate.

Flow resolution keeps the physical lunar year, written month, effective month, physical month sequence, month-building branch, and palace month index separate. ZiweiFlowMonthPalaceStrategy.physicalSequence is the default; select effectiveMonth through ZiweiFlowOptions for schools that attach a leap segment's flow palace to its effective month.

dart test