HUAGUANGXIAN / TERMS

Features & Use

Updated: 2026-10-27

About Huaguangxian

Huaguangxian is a digital learning platform for Chinese traditional culture. The current iPhone and iPad version has six sections—Seasons, Tools, Study, Observe, Immersion and Me—connecting cultural knowledge with time, the sky, space and traditional symbolic systems. Mac retains its Learn library, desktop tools and spatial study, with features depending on the version and hardware. Read texts and their sources, manipulate interactive diagrams, and explore relationships in 2D, 3D and live camera views on supported devices. The app supports cultural study and research; traditional correspondences are not factual predictions of personal destiny or good or bad fortune.

Study & Learn · From texts to interaction

Study on iPhone and iPad connects seven interactive workbenches with bundled lessons and classical references covering yin and yang, the Five Phases, stems and branches, Hetu and Lo Shu, trigrams and hexagrams, Chinese asterisms, solar terms and musical tuning. Learn on Mac retains its reference library and classical readings. Relevant views support search, bookmarks, completion records and text-size controls, with reading positions saved locally. Bundled texts and diagrams work offline; external references need a connection. Study does not automatically use AI or spend credits.

Seasons · Explore the rhythms of time

Connect Gregorian and Chinese calendar dates, the 24 solar terms, lunar phases, traditional double-hours and stem–branch cycles. Turn the seasonal wheel and explore seasonal markers, the 12 double-hours and the 60-part cycle. Carry a selected instant into Observe to compare calendar information with celestial positions. The relevant views identify time conventions and distinguish historical systems from the app’s teaching conventions.

Observe · Explore the sky and celestial motion

Rotate and zoom the celestial sphere to find the Sun, Moon, planets, Chinese asterisms, Big Dipper and 28 lunar mansions. Compare schematic and true-distance solar-system views, and explore trajectories and retrograde motion over time. Calendar & Sky connects the Sun, Earth and Moon with lunar phases, solar terms and annual events, including interactive daylight and gnomon-shadow views.

Immersion · Connect time and space

Immersion on the current iPhone and iPad version contains Space Studio, Seasonal Light and Airflow Studio. Space Studio supports plan editing, room scanning on compatible devices, furniture layouts and 2D/3D viewing, with directional layers for the compass, Flying Stars, Xuan Kong and Eight Mansions. Seasonal Light simulates sunlight from the date, location, heading and modeled space. Airflow Studio compares airflow, pressure and ventilation paths under different wind, opening and furniture conditions. Mac additionally retains Pillars in Time and Qimen in Space for time relationships and directional study; Mac does not perform RoomPlan capture. Space Studio, Seasonal Light and Airflow Studio share the selected plan, heading, reference origin and layouts.

Tools · A cultural study workspace

The tool library provides 31 main entries and 32 functions including Taiyi Natal Method as a submode. It covers Four Pillars, the Three Methods, Ziwei, Seven Luminaries & Four Auxiliary Bodies, Yanqin, divination, calendars, astrology and feng shui. Settings, calculations, charts, classical references and local records are available in the relevant tools. Only supported entries marked AI offer optional official analysis, requiring a connection and separate credits; AI is not available in every tool. Interfaces and features vary between phone, tablet and Mac versions. Direction, scanning and camera functions depend on hardware and permissions.

Device support and local use

iPhone and iPad require iOS/iPadOS 18 or later; Mac requires macOS 26 or later. The companion Apple Watch app and complications require watchOS 26 or later. Interfaces and learning explanations are available in Simplified Chinese and English. Classical texts and necessary terms retain Chinese characters for comparison. Room scanning requires an iPhone or iPad that supports RoomPlan and LiDAR; live camera, depth and direction features depend on hardware and permissions. Interactive 3D spaces are viewed on the device’s screen. Mac supports plan editing and spatial viewing, with local processing of existing capture data on supported Apple Silicon models; RoomPlan scanning is unavailable on Mac. Complete projects can be transferred between phone and Mac, and independent refined models can be viewed on iPhone and iPad. Optional High Detail refinement uses saved photographs and measurements locally; quality and speed depend on capture quality and device capabilities. Local features need no separate registration and have no advertising. Optional Apple purchases, balance and Premium verification, AI analysis and iCloud Data Sync require a network connection. Bundled material, calculations and saved data work locally; external references and user-initiated email require a connection.

Time and calendar conventions

Seasons and calendar astronomy use Beijing time (UTC+8). Location-based sky views use the location and time zone shown on the page. A traditional double-hour lasts two hours; this app divides it into eight 15-minute quarters (ke). Historical systems such as the hundred-ke day differ. The Zi double-hour runs from 23:00 to 01:00 the next day; stem–branch day-boundary conventions are explained on the relevant page. Calendar dates cover 1901–2099.

Visualization and accuracy

Body sizes, colors, orbital distances, 3D motion and some cultural diagrams are adjusted for clarity and are not always to scale. Calculation methods and sources are described in each feature and in Sources & Licenses. The diagrams do not determine weather, terrain, building obstructions or conditions at an observing site. The app is for learning and general reference and does not replace professional ephemerides, navigation, surveying or other safety-critical systems.

Cultural material and translations

Yin and yang, the Five Phases, hexagrams, stems and branches, and Chinese asterisms are presented as historical culture, texts and traditional models. Traditional correspondences do not establish modern scientific causation and are not used to predict personal destiny or make medical, legal or investment decisions. English translations are learning aids. Some terms and classical quotations retain Chinese characters for comparison; meaning should be read in the context of the source and its history.

Immersion calculations and spatial limits

Four Pillars, Qimen, compass and directional layers use the traditional rule profiles identified in each feature, with calculation references available in-app. Traditions may use different rules. Verify scanned geometry and headings: indoor magnetic fields, tracking and occlusion affect measurements. Sunlight is a clear-sky geometric simulation using modeled walls, openings, objects and exterior obstructions; it excludes weather, unmodeled buildings, glazing transmission and measured illuminance. Furniture, routes and sight lines support exploration; verify actual dimensions and construction arrangements on-site.

Airflow simulation

Airflow Studio calculates 3D air movement locally using the plan, ceiling height, furniture, incident wind and effective openings. Its 2D slices and 3D streamlines show the same computed field; animation illustrates flow direction rather than changing measured weather. Openings into unscanned rooms use the reference-pressure condition you choose. Grid resolution, viscosity and simulated duration affect results. The model excludes complete mechanical ventilation, thermal buoyancy and on-site weather. Use it to explore spaces and compare scenarios, not for ventilation certification or measured air-change rates.

Standard Scan and Enhanced Capture

On supported devices, Standard Scan uses Apple RoomPlan to create editable 2D plans and 3D structures while retaining available measured surfaces. Enhanced Capture selects photographs from ordinary AR video frames by quality and viewpoint. Each image stays associated with that frame’s intrinsics, pose and available depth; capture does not repeatedly request high-resolution still photographs. Measured mesh and photographic coverage have different meanings: a visible surface does not imply sufficient clear photographs, and coverage indicators do not certify a complete room. A mini-map supports capture of multiple rooms on one story or partial, open spaces. Unconfirmed boundaries do not contribute room area. After capture, view measured models, create photo-textured previews and continue local spatial reconstruction on supported devices. Only photographic alignment corrections that pass consistency checks are used for new reconstruction tasks; original photographs and measurements are retained. Progress is saved per room, and tasks can be paused and resumed. There is no two-minute automatic stop, but capture and reconstruction remain subject to keyframe, memory, storage, thermal and hardware limits. Processing time, completeness and clarity depend on coverage, lighting, motion and hardware. Reflections, glass, small objects, occlusions and unseen areas may remain missing, misaligned or blurred. Survey-grade accuracy is not promised. Scenes retain their captured appearance; plan edits and simulated sunlight do not physically relight photographs. Structural analysis uses plans and measured data, not inferred surfaces as measurements. Existing photographic and depth archives remain readable; depth-only previews need original photographs for photographic training. Models are saved and viewed within the app, and processing stays on-device.

Credits and Premium

In the current iPhone and iPad version, Seasons, core Tools and Study are free; Observe and Immersion require Premium. People, cases, saved-report reading and Data Sync do not require Premium. Official AI is optional and uses credits per request. Credit packs are one-time Apple In-App Purchases, do not renew and do not expire. First-purchase bonuses follow the eligibility shown for the current purchase account, once per pack. Required credits are shown before an AI analysis or follow-up; credits are reserved on submission, charged on success and released on failure. Premium includes the features listed in its benefits table and discounts on credits used for analysis, not unlimited AI or lower credit-pack prices. The 7-day, monthly and annual plans renew automatically. The permanent plan is a one-time purchase with ongoing listed benefits and regular updates. Prices and currencies are shown by Apple. Manage subscriptions and restore purchases on the Premium page, or restore purchases and sync the server balance on the credits page, using the original App Store purchase account. Reinstallation or data sync does not make local files proof of a credit purchase. The Apple Standard EULA is linked from Premium, credits and Settings & About; privacy information is also accessible there.

Optional Credits & Premium

Core tools can be used independently. Credits and Huaguangxian Premium are optional services. Availability, local-currency prices, current benefits and renewal details are shown in the app and Apple purchase sheet. Unavailable products cannot be purchased. AI analysis and follow-ups require a connection and use credits per request; Premium does not include unlimited AI analysis.

Terms of Use & Privacy

The app uses Apple’s Standard Licensed Application End User License Agreement (EULA). Before purchasing, read the product and renewal information displayed in the app and review the Privacy Policy.

Apple Standard EULA · Privacy Policy

← Back to Huaguangxian