Giter Club home page Giter Club logo

earthfrequencies's Introduction

Earth Frequencies

This is a collection of machine parasable data files, intended for use in an amateur context, that describe radio frequency allocations and channels.

Currently this is an experiment into how best the data can be represented for use in applications. For example, for SDR applications that can select an appropriate data representation, loading the appropiate module, based on what it 'knows' should be in the frequency it is scanning.

This should NOT be considered a primary source for this information and you should not assume the data here is 100% correct (data quality is always a challenge). You should always check official sources for accurate data about allocation and usage requirements.

Also remember, that any radio transmission requires an appropriate license and in all cases you should be aware of local regulation of the air waves.

If you find errors, please open a bug report in the project's issue tracker, or provide a pull-request with the fix.

Contributions

Contributions are welcome and are appreciated.

License

Creative Commons Licence
This work is licensed under a Creative Commons Attribution-ShareAlike 4.0 International License.

Note, if any sources have different licenses, then those should be treated as taking precedence and should be mentioned in the metadata. This project is simply using Creative Commons to encourage people to contribute back.

References

The main starting point of any radio spectrum allocation is the ITU and then it is broken down into regional regulators.

It should be noted that source data may have inaccuries or be out of date, so this should be verified and taken into account.

Earth Frequencies Viewer

Given this project is focusing purely on the data, the viewer that was once part of this project has been moved out to its own project:

https://github.com/ajmas/EarthFrequenciesViewer

earthfrequencies's People

Contributors

ajmas avatar jrmlhermitte avatar

Watchers

 avatar  avatar  avatar

earthfrequencies's Issues

Add support for GitHub Actions

Maintaining the use of CSV for easy submission, we should add support for GitHub Actions. The workflow would do the following, updating the gh-pages branch, for merges to master:

  • take the CSVs and generate JSON files that can be used the the Earth Frequencies Viewer or any other project
  • include the CSVs in that branch too, such that for a given path a json or CSV could be used
  • generate a file that includes the following information:
    • generation date
    • github hash

I had considered bringing in the generated viewer from the Earth Frequencies Viewer project, but thinking we should simply have it in its own repo and point to the published gh-pages here, on the condition we don't have any CORS issues.

Quickstart guide: https://docs.github.com/en/actions/quickstart

Document data formats in wiki

Description

We should document data formats in the wiki

Discussion came from #9.
You can find the wiki here.

Some things to consider:

  • file format: CSV, tab delimited. Tabs not allowed in text otherwise
  • Required column names and description
  • Optional column names and description
  • File hierarchy (i.e.: do we want to allow subfolders or not?)
  • etc

We could discuss and agree on standards here, then modify the wiki once we do.

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.