# GnssLib

**Repository Path**: gemini_leaf/gnss-lib

## Basic Information

- **Project Name**: GnssLib
- **Description**: JavaScript版本的GNSS工具库

该工具库大部分源码借鉴rtklib，只是将对应函数转换成JavaScript版本
- **Primary Language**: JavaScript
- **License**: GPL-3.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2023-08-28
- **Last Updated**: 2023-10-05

## Categories & Tags

**Categories**: Uncategorized

**Tags**: bdt, Gnss, GPS, glonass, Galileo

## README

# 概述
该库主要为JavaScript环境下提供GNSS相关的时间转换函数、位置转换函数、角度/弧度转化函数以及部分辅助函数，使用请参考doc目录说明

# 函数列表
## 时间转换函数
| 函数名称 | 作用 | 备注|
|--|--|--|
| date2gpst | 将Date对象转换成GPS 周和周内秒的时间  | |
| gpst2date| 将GPS 周和周内秒转换成Date对象  | |
| gpst2utc| 将GPS Date对象转换成UTC Date对象  | |
| gpst2bdt| 将GPS Date对象转换成BDT Date对象  | |
| date2bdt | 将Date对象转换成BD 周和周内秒的时间  | |
| bdt2date| 将BD 周和周内秒转换成Date对象  | |
| bdt2utc| 将BDT Date对象转换成UTC Date对象  | |
| bdt2gpst| 将BDT Date对象转换成GPST Date对象  | |
| date2gst| 将Date对象转换成Galileo 周和周内秒的时间  | |
| gst2date| 将Galileo 周和周内秒转换成Date对象  | |
| gst2utc| 将GST Date对象转换成UTC Date对象  | |
| utc2gpst| 将UTC Date对象时间转换成GPST Date对象  | |
| utc2bdt| 将UTC Date对象时间转换成BDT Date对象  | |
| utc2gst| 将UTC Date对象时间转换成Galileo GST Date对象  | |
| utc2utcsu| 将UTC Date对象时间转换成UTC(SU) Date对象  | |

## Date对象扩展函数
| 函数名称 | 作用 | 备注|
|--|--|--|
| baseUTC| 返回当前Date对象的UTC形式Date对象  | 将时区改为UTC+0 |
| Date.getDayOfYear | 获取当前时间的年积日  | |
| Date.getSecondsOfDay| 获取当前时间的天内秒| |
## 位置转换函数
 | 函数名称 | 作用 | 备注|
|--|--|--|
| pos2ecef | 将经纬度坐标转换成地心地固系坐标  | |
| ecef2pos | 将地心地固系坐标转换成经纬度坐标  | |
| ecef2enu | 将地心地固系坐标转换成ENU坐标  | |
| enu2ecef | 将ENU坐标转换成地心地固系坐标  | |
## 角度/弧度函数
| 函数名称 | 作用 | 备注|
|--|--|--|
| rad2deg| 将数值从弧度制转换成角度值  | |
| deg2rad| 将数值从角度制转换成弧度制  | |
| dms2deg| 将度分秒数值转换成度  | |
| deg2dms| 将度转换成度分秒数据  | |
## 其他函数
| 函数名称 | 作用 | 备注|
|--|--|--|
| getGlonassFrequency | 根据Glonass 卫星号返回该卫星号对应的载频编号（K）/频率索引(-7~6)  | |
| getGPSLeapSecond | 根据JS时间戳获取GPST的跳秒数  | |
| getGSTLeapSecond| 根据JS时间戳获取GST的跳秒数  | |
 
 

# 如何使用
```html
<script type="text/javascript" src="./GnssLib.js"></script>
<script>
/*
* 构建表示BDT时间的Date对象
*/
let bdt = GnssLib.bdt2date(904, 35736)
console.log(bdt);

/*
* 构建表示GPST时间的Date对象
*/
let gpst = GnssLib.bdt2date(2260, 35736)
console.log(gpst);

/*
* 构建表示GST时间的Date对象
*/
let gst = GnssLib.gst2date(1260, 35736)
console.log(gst);

/*
* GPST转BDT
*/
let bdt2 = GnssLib.gpst2bdt(gpst)
console.log(bdt2)

/*
* BDT转GPST
*/
let gpst2 = GnssLib.bdt2gpst(bdt)
console.log(gpst2)

</script>
```