Git Product home page Git Product logo

archive-data-visualizer's Introduction

archive-data-visualizer

Vizualize your archive world!

Installation

npm install -g archive-data-visualizer

Usage

archive-data-visualizer <command> <command parameters>

Commands

help        Display this help.
visualize   Performs data download from the k8s container, visualization and uploading the transformed result into the bookkit page.

Parameters

--command [string]

visualize, help commands. All these can be used as default commands without providing --command argument

-c, --config [string]

File path to the configuration object.

Configuration File Convention

All configuration fields are mandatory. Configuration file is a JS file exporting the configuration object.

module.exports = {
    "bookkit": {        
        "accessCode1": "... access code 1 ...",
        "accessCode2": "... access code 2 ...",
        "oidcHost": "... Oidc grantToken URI ...",
        "uri": "... BookKit base URI ..."
    },
    "visualizations": [
        {
            "id": "... visualization id ...",
            "pageCode": "... page code in the bookkit - must exist ...",
            "header": "... Page name ...",
            "description": "... Page description - uu5String supported ...",
            "basePath": "... base path for archive-data-downloader to know where to download data from ...",
            "statsFolder": "... folder within the base path where the statistics are stored ...",
            "tempFolder": "... local file system folder base path to know where the data should be extracted to the local system ...",
            "ranges": [
                {
                    "id": "... range id ...",
                    "sectionCode": "... section code to upload the generated uu5String visualization - must exist ...",
                    "header": "... section header ...",
                    "description": "... section description - uu5string supported ...",
                    "chartType": "... chart type (LineChart|BarChart|AreaChart|ComposedChart) - value is optional, LineChart is default...",
                    "aggregations": ["... array of aggregation types - (MIN|MAX|AVG|SUM|MEDIAN)..."],
                    "valueUnit": "... text value to be displayed on Y-axis ...",
                    "rangeType": "... range type value (week|month|all|custom) ...",
                    "rangeStart": "... YYYY-MM-DD ...", // supported for custom rangeType only
                    "rangeEnd": "... YYYY-MM-DD ...", // supported for custom rangeType only
                    "rangeSize": 1,
                    "monitorTrend": { // Calculate trend in data and visualize it in the chart. The tool will also caluclate the difference between the trends from the whole range interval and the interval defined in the monitoredTrend configuration  
                        "enabled": true,
                        "percentageDifference": 10,
                        "rangeType": "... range type value (week|month|all) ...",
                        "rangeSize": 1
                    }
                }
            ],
            "attributes": [
                // first attribute with type=label, valueKey=label is mandatory
                {
                    "type": "label",
                    "valueKey": "label"
                },
                {
                    "type": "... attribute type (label|value) ...",
                    "valueKey": "... csv column name (Y axis) ...",
                    "name": "... display name ...",
                    "colorSchema": "red-rich",
                    "chartType": "... applicable in case ComposedChart is used for the range as a chart type (area|line|bar) ...",
                    "monitorTrend": { // definition of monitored trend line
                        "enabled": true,
                        "valueKey": "... attribute name ...",
                        "name": "... diplay name ...",
                        "colorSchema": "red",
                        "chartType": "... applicable in case ComposedChart is used for the range as a chart type (area|line|bar) ...",
                    }
                }
            ]
        }
    ]
}

In case the configuration is not provided, the tool searches for the configuration file in a default location %HOME%/.archive-data-visualizer/config.js

--archive-data-downloader-config

File path to the configuration object of the archive-data-downloader tool. It is optional, in that case the archive-data-downloader will scan for the configuration file in its default location. See more in archive-data-downloader documentation.

--visualizationFilter string[]

Define what visualization should be performed from the configuration object. If not defined, the tool will perform all visualizations. Each visualization is identified by its "id" value.

--rangeFilter string[]

Define what range should be performed for each visualization from the configuration object. If not defined, the tool will perform visualization for all defined ranges. Each range is identified by its "id" value.

Logs

logs are automatically stored to the %HOME%/.archive-data-visualizer/logs folder

archive-data-visualizer's People

Contributors

xaverric avatar

Watchers

 avatar

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.