Skip to content

KarlYee/Suma

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Suma

Suma comprises a set of tools, including a mobile tablet-based (i.e. Apple iPad) data collection application, that will allow library staff to collect, aggregate, and interactively analyze real-time data about the usage of physical space and services. This tool will support the collection of more fine-grained data about physical space usage patterns by supporting the annotation of users with "activities." The data that this tool provides will allow the libraries to build on existing assessment practices by significantly improving our ability to analyze physical space usage trends against various milestones, as well as generating more dynamic and current data visualizations. As a result, this data can be both collected and utilized more frequently and at a much wider scope than before with relative ease.

This project is currently being used at NC State as a pilot project for a wider deployment. Examples of the current and planned uses for this toolkit include the collection and analysis of data relating to:

  • Building headcounts
  • Reference desk transactions
  • Experimental technology usage
  • Media production activities
  • Experimental furniture usage

Alpha/test disclaimer

This is an alpha code release. That means this is the first public release of the code to begin software testing outside of NCSU Libraries. Alpha code can be unstable, and bugs will undoubtedly be found. We have worked hard to make the code as stable as possible for testers, but are eager to receive feedback on any issues you discover. While we at NCSU Libraries' are using it in a production capacity, you should think of any attempts to implement this as an experimental pilot project and take the appropriate precautions. These include but are not limited to carefully backing up databases, monitoring error logs, maintaining close relationships with users, and reporting any problems back to the project team. Thank you for helping to ensure that this grows into a stable and useful project for the larger community.

As a safeguard, all JSON input from the client is logged. This will lead to large log files, but it allows for data recovery in the case of database problems or improperly rejected data. See the information about "JSON INPUT" entries in LOGS.md for more information.

Documentation

  • LICENSE.md
  • README.md
  • INSTALL.md
  • LOGS.md
  • QUERYSERVER.md

How to contribute?

You want to contribute some code? Maybe some data reports, bug fixes, new clients, or even new core features? Awesome! Just contact us or branch the code on GitHub and create a pull request.

Project URLs

Suma Community

If you would like to be invited to a google group for the Suma users community, please email Joyce Chapman at chapmajc AT email DOT unc DOT edu

Credits and contacts

  • Jason Casden (jmcasden AT ncsu DOT edu) – Project and technical lead, front-end developer.
  • Joyce Chapman (chapmajc AT email DOT unc DOT edu) – Community development and data analysis specialist.
  • Rob Rucker – Project team member and our first stakeholder. Research Information Services department head responsible for NCSU D. H. Hill Libraries head counts and reference desk transactions.
  • Eric McEachern – Backend developer, responsible for much of the development of the server-side components.
  • Rusty Earl – Backend developer and technical consultant.
  • Bret Davidson - Data analysis tool developer.

Releases

No releases published

Packages

No packages published