Measurements

Type-Safe Measurements Calculations

In One Line

Measure with confidence: Type-safe units, zero confusion!

Overview

Metric is a lightweight, type-safe library for handling length, area and weight measurements in different units. It prevents common unit conversion errors and provides a fluent API for calculations.

---

Package Info

display name	AceLand Measurements
package name	com.aceland.measurements
latest version	1.0.1
namespace	AceLand.Measurements AceLand.Measurements.GeoLocation
git repository	https://github.com/parsue/com.aceland.measurements.git
dependencies

---

Quick Start

// Create lengths using extension methods
Length height = 1.8.Meters();
Length width = 42.Inches();
Weight playerWeight = 180.Pounds();
Weight itemWeight = 500.Grams();

// Easy unit conversion - no calculations needed
double heightInFeet = height.Feet;        // 5.905512 ft
double widthInMeters = width.Meters;      // 1.0668 m
double kg = playerWeight.Kilograms;       // ~81.64 kg
double oz = itemWeight.Ounces;            // ~17.63 oz

// Create area from length multiplication
Area room = width * height;
double areaInSquareMeters = room.SquareMeters;    // 1.92024 m²
double areaInSquareFeet = room.SquareFeet;        // 20.67 ft²

// Other Calculations
Length totalSideLenght = (height + width) * 2; 
Weight totalWeight = playerWeight + itemWeight;
Weight diffWeight = playerWeight - itemWeight;

---

Features

• Type-safe measurements

• Automatic unit conversion

• Support for SI units and Imperial/US units

• Clean, fluent API

• Zero-allocation operations

---

Common Usage

Length Units

// Metric units
Length distance = 5.Kilometers();      // 5 km
Length height = 180.Centimeters();     // 180 cm
Length precision = 100.Micrometers();  // 100 μm

// Imperial/US units
Length depth = 6.Feet();              // 6 ft
Length width = 30.Inches();           // 30 in
Length range = 2.5.Miles();           // 2.5 mi

// Nautical/Astronomical
Length nautical = 1.NauticalMiles();  // 1 nmi

Area Units

// Direct area creation
Area plot = 100.SquareMeters();
Area field = 2.5.Hectares();
Area land = 1.Acres();

// Area from length calculation
Length width = 20.Meters();
Length length = 30.Meters();
Area rectangle = width * length;       // 600 m²

// Converting between units
double acres = rectangle.Acres;        // ~0.148 acres
double sqFt = rectangle.SquareFeet;    // ~6458.35 ft²

---

Real-World Examples

Room Dimensions

Length roomWidth = 12.Feet();
Length roomLength = 15.Feet();
Area floorSpace = roomWidth * roomLength;

Console.WriteLine($"Room size: {floorSpace.SquareMeters:F2} m²");
Console.WriteLine($"           {floorSpace.SquareFeet:F2} ft²");

Land Measurements

Area plot = 2.Acres();
Console.WriteLine($"Plot size: {plot.SquareMeters:F2} m²");
Console.WriteLine($"           {plot.Hectares:F2} ha");
Console.WriteLine($"           {plot.SquareFeet:F2} ft²");

---

Best Practices

• Use the most appropriate unit for your input data

• Let the library handle all conversions

• Use type inference with the fluent API

• Take advantage of the built-in ToString() methods for debugging

---

Notes

• All calculations maintain double precision

• Internal storage uses meters and square meters

• Conversions use standard SI definitions

• Zero allocation for basic operations

---