• Stars
    star
    6
  • Rank 2,461,544 (Top 50 %)
  • Language
    Crystal
  • License
    MIT License
  • Created almost 3 years ago
  • Updated over 1 year ago

Reviews

There are no reviews yet. Be the first to send feedback to the community and the maintainers!

Repository Details

Physical quantity and units of measure conversion and math for crystal lang

Creepy Units

CI

A Crystal lang library for unit measurement conversion and math.

Installation

Add this to your application's shard.yml:

dependencies:
  crunits:
    github: spider-gazelle/crunits

Usage

For an over the top example, consider a car (2800 lb) completing the quarter mile in 10 seconds (with uniform acceleration).

require "crunits"

distance = Units::Measurement.new(0.25, "mile", :name)   # => #<Units::Measurement value=0.25 unit=[mi_i] (mile)>
time     = Units::Measurement.new(10,   "second", :name) # => #<Units::Measurement value=10 unit=s (second)>
mass     = Units::Measurement.new(2800, "pound", :name)  # => #<Units::Measurement value=2800 unit=kg (kilogram)>

acceleration =  distance * 2 / (time ** 2)
# => #<Units::Measurement value=0.005 unit=[mi_i]/s2 (mile/second2)>

force = (mass * acceleration).convert_to("lbf", :symbol)
# => #<Units::Measurement value=2297.50383668 unit=[lbf_av] (pound force)>

power = (force * distance / time).convert_to("horsepower", :name)
# => #<Units::Measurement value=551.40092080 unit=[HP] (horsepower)>

Comparison

It has the ability to compare measurements with the same or different units.

Units::Measurement.new(12, "inch", :name) == Units::Measurement.new(1, "foot", :name)
Units::Measurement.new(1, "meter", :name) > Units::Measurement.new(1, "yard", :name)  # => true

Again, you have to compare compatible units. For example, comparing two temperatures will work, comparing a mass to a length would fail.

SI abbreviations

You can use shorthand for SI units.

Units::Measurement.new(1000, "m") == Units::Measurement.new(1, "km")  # => true
Units::Measurement.new(1, "ml") == Units::Measurement.new(0.001, "l") # => true

Complex Units

Units can be combined to make more complex ones. There is nothing special about them -- they can still be converted, compared, or operated on.

speed = Units::Measurement.new(60, "mile/hour", :name)
# => #<Units::Measurement value=60 unit=[mi_i]/h (mile/hour)>

speed.convert_to("m/s")
# => #<Units::Measurement value=26.8224 unit=m/s (meter/second)>

Math

You can add or subtract compatible measurements.

Units::Measurement.new(2.0, "meter", :name) + Units::Measurement.new(3.0, "inch", :name) - Units::Measurement.new(1.0, "yard", :name)
# => #<Units::Measurement value=1.1618 unit=m (meter)>

You can multiply or divide measurements and numbers.

Units::Measurement.new(110, "volt", :name) * 2
# => #<Units::Measurement value=220 unit=V (volt)>

You can multiply or divide measurements with measurements.

Units::Measurement.new(20, "mg") / Units::Measurement.new(1, "l")
# => #<Units::Measurement value=20 unit=mg/l (milligram/liter)>

Exponentiation is also supported.

(Units::Measurement.new(10, "cm") ** 3).convert_to("liter", :name)
# => #<Units::Measurement value=1 unit=l (liter)>

Credits

inspired by Unitwise Ruby gem

More Repositories

1

spider-gazelle

A Rails esque web framework with a focus on speed and extensibility for crystal lang
Crystal
175
star
2

tasker

Scheduled tasks for crystal lang
Crystal
54
star
3

bindata

BinData - Parsing Binary Data in Crystal Lang
Crystal
48
star
4

ssh2.cr

libssh2 binding for Crystal language
Crystal
42
star
5

promise

Type aware promises for crystal lang
Crystal
40
star
6

action-controller

A rails-esque controller framework for crystal lang
Crystal
39
star
7

active-model

A rails-esque model framework for crystal lang
Crystal
28
star
8

rethinkdb-orm

RethinkDB ORM for Crystal lang
Crystal
24
star
9

crystal-mqtt

Crystal lang implementation of the MQTT protocol, a lightweight protocol for publish/subscribe messaging
Crystal
19
star
10

ffmpeg

ffmpeg crystal bindings
Crystal
18
star
11

qr-code

a QR Code implementation written in crystal lang
Crystal
17
star
12

crystal-ldap

a Crystal lang LDAP client
Crystal
16
star
13

crystal-snmp

SNMP implementation for crystal lang
Crystal
16
star
14

priority-queue

Priority Queue and Heap implementation for Crystal Lang
Crystal
13
star
15

bisect

Library for maintaining sorted Arrays
Crystal
12
star
16

json-schema

Describe crystal-lang JSON serializable types with JSON Schema
Crystal
12
star
17

pinger

Microlibrary to perform ping requests with Crystal Lang
Crystal
11
star
18

telnet.cr

Telnet protocol helper for crystal lang
Crystal
11
star
19

pars

Parser combinator library for crystal-lang
Crystal
11
star
20

inactive-support

Utilities for crystal-lang
Crystal
10
star
21

pg-orm

Postgres ORM for Crystal Lang
Crystal
9
star
22

mdns

Crystal Lang mDNS and DNS-SD Support
Crystal
8
star
23

tensorflow_lite

tensorflow lite bindings for crystal lang
Crystal
8
star
24

ed25519

Ed25519 high-performance public-key signature system for crystal lang
Crystal
7
star
25

crystal-gpt

ChatGPT plugin template that allows you to focus on writing actions, automatically generating the required metadata
Crystal
7
star
26

secure-remote-password

Crystal implementation of the Secure Remote Password protocol (SRP-6a)
Crystal
6
star
27

simple_retry

a tool for retrying code blocks
Crystal
6
star
28

connect-proxy

crystal lang connect / HTTP proxy implementation
Crystal
6
star
29

crystal-openai

OpenAI ChatGPT, GPT-3, GPT-4, DALLยทE, Whisper API Client for Crystal
Crystal
6
star
30

secrets-env

Extension to the crystal lang ENV module to support reading secrets
Crystal
6
star
31

v4l2.cr

crystal lang video for linux device helpers / bindings
Crystal
5
star
32

log_helper

Extension for Crystal Log to aid logging key-value data
Crystal
5
star
33

readers-writer

A simple readers writer lock for crystal lang
Crystal
5
star
34

cmac

Crystal implementation of the Cipher-based Message Authentication Code (CMAC)
Crystal
5
star
35

guide

Spider Gazelle Documentation
Python
4
star
36

ntlm

NTLM authentication for crystal lang
Crystal
4
star
37

worker_pool

a basic fiber pool implementation for crystal lang
Crystal
4
star
38

digest-auth

HTTP digest auth for crystal lang
Crystal
4
star
39

matter

A complete Crystal implementation of the Matter protocol specification (https://buildwithmatter.com). Includes full support for controller, device, commissioning, secure communications, device types, and cluster definitions.
Crystal
4
star
40

eventbus

Listen for Postgres database change events and publish them to event listeners
Crystal
3
star
41

knx

KNX protocol support for crystal lang
Crystal
3
star
42

tokenizer

Simplified binary stream tokenization for crystal lang
Crystal
2
star
43

crystal-dtls

DTLS support for crystal lang
Crystal
2
star
44

upload-signer

Provide API for generating pre-signed URLs for file uploads to cloud storage
Crystal
2
star
45

stomp

crystal lang implementation of the STOMP protocol
Crystal
1
star
46

tlv

Matter TLV encoder/decoder
Crystal
1
star
47

gpio.cr

crystal lang bindings for linux gpiod
Crystal
1
star
48

stumpy_resize

resizes stumpy canvas images in pure crystal
Crystal
1
star
49

HKDF

HMAC-based Extract-and-Expand Key Derivation Function (HKDF) for crystal lang
Crystal
1
star
50

SPAKE2_plus

a crystal lang implementation of SPAKE2+, a Password Authenticated Key Exchange (PAKE) protocol
Crystal
1
star
51

panopticon

Distributed tracing for services built in crystal-lang
Crystal
1
star
52

tflite_image

image classification and feature detection with tflite and crystal lang
Crystal
1
star
53

tflite_pipeline

video processing AI pipeline leveraging tflite_image
Crystal
1
star
54

link-header

Crystal Lang HTTP Link Header Parser
Crystal
1
star