MARS-T

A comprehensive library and command-line interface (CLI) tool designed to aid in the colonisation of Mars, by providing reusable resources and functionalities

mars-t determines the date and time on Mars by utilising Earth's Coordinated Universal Time (UTC), International Atomic Time (TAI), or Terrestrial Time (TT).

It provides two types of time:

1. Mars Sol Date (MSD)

2. Martian Coordinated Time (MTC)/ Airy Mean Time (AMT)

USAGE

It is moreover possible to link against mars-t using its library as a dependency for other astronomical projects (see public functions).

EXAMPLES

INSTALLATION ON LINUX

mars-t is designed to be compatible with Windows and macOS, and can be easily installed using cargo. However, the primary development and testing environment for mars-t is Fedora Linux.

The current version of mars-t (v0.2.1) has been verified to work properly on Fedora Linux 37 and Ubuntu 22.10.

METHOD 1 – USING CARGO

[Recommended for programmers]

1. To install mars-t from crates.io, use the following cargo command:

cargo install mars-t

The executable will be saved in the hidden .cargo/bin/ directory within your home directory.

2a. For easy access, you may want to copy the mars-t file to the /usr/bin/ directory. This can be done by following the instructions in Method 2 (3a, 3b).

2b. As an alternative, you can add the ~/.cargo/bin/ directory to your system's PATH variable, which can be configured using rustup.

METHOD 2 – UNIVERSAL LINUX BINARIES

1. To install mars-t, first download the distro-independent binary from GitHub.

2. Then, make the file executable by running the command:

sudo chmod +x ./mars-t

3a. On most Linux distributions, install mars-t by copying the binary to /usr/bin/:

sudo cp mars-t /usr/bin/

3b. For Fedora Silverblue / Kinoite, use this command:

sudo cp mars-t /var/usrlocal/bin/

METHOD 3 – DISTRO-SPECIFIC PACKAGES

[Recommended for most users]

Distro-specific packages for .rpm and .deb-based Linux distributions are also available for download. To install mars-t on different Linux distributions, follow these instructions:

Fedora Linux / RHEL / openSUSE:

sudo rpm -i mars-t-0.2.1-1.x86_64.rpm

Fedora Silverblue / Kinoite:

rpm-ostree install mars-t-0.2.1-1.x86_64.rpm

Ubuntu:

sudo dpkg -i mars-t_0.2.1_amd64.deb

METHOD 4 – MANUAL COMPILATION

First, download and unpack the mars-t source code from GitHub. Next, to build and install the program, use the command:

cargo build --release && sudo cp target/release/mars-t /usr/bin/