freqDist

Historics Preview freqDist type generates the frequency distribution for the given target. This type of preview provides an easy-to-understand summary of the variances of the chosen target. It is especially useful for finding out what are the top n values of the variable you are interested in and what percentage of the total they represent. For example, if you wanted to find out what languages people use when they are discussing your brand, product, or service, you would use freqDist preview with the language.tag target. The results of this preview could be used to allocate budgets for social media campaigns in the top-10 languages used by the people talking about your brand.

Parameters

  • count - maximum number of values with highest frequency distribution. Allowed range: 1 to 100.

Sample targets

Sample output data

The following example shows output for the top ten results of a freqDist preview on language.tag (language.tag,freqDist,10):

{
    "id": "a4232cb3sd0b3038837f",
    "name": "preview",
    "progress": 100,
    "status": "succeeded",
    "feeds": "twitter",
    "sample": 1,
    "end": 1359936000,
    "created_at": 1363968362,
    "start": 1359849600,
    "user": "12635",
    "parameters": "language.tag,freqDist,10",
    "hash": "f25d512cf287ec44fe66e8362d61961a",
    "data": [
        {
            "target": "language.tag",
            "analysis": "freqDist",
            "output": {
                "fr": 203,
                "pt": 227,
                "nl": 224,
                "id": 271,
                "sq": 195,
                "da": 196,
                "en": 65346,
                "es": 407,
                "ja": 385,
                "ms": 446
            },
            "threshold": 10
        }
    ]
}

The following example shows output for the top ten results of a freqDist preview on language.tag (language.tag,freqDist,10) and the results of a targetVol preview on language.tag computed at hourly intervals:

{
    "id": "aef740534dc63ca6d253",
    "name": "preview",
    "progress": 100,
    "status": "succeeded",
    "feeds": "twitter",
    "sample": 1,
    "end": 1359936000,
    "created_at": 1363969196,
    "start": 1359849600,
    "user": "12635",
    "parameters": "language.tag,freqDist,10;language.tag,targetVol,hour",
    "hash": "e65d53acf2e7ec44fe66e8362a61931a",
    "data": [
        {
            "target": "language.tag",
            "analysis": "freqDist",
            "output": {
                "fr": 203,
                "pt": 227,
                "nl": 224,
                "id": 271,
                "sq": 195,
                "da": 196,
                "en": 65346,
                "es": 407,
                "ja": 385,
                "ms": 446
            },
            "threshold": 10
        },
        {
            "target": "language.tag",
            "analysis": "targetVol",
            "output": {
                "2013\/02\/03 21:00:00": 3697,
                "2013\/02\/03 04:00:00": 3371,
                "2013\/02\/03 01:00:00": 3081,
                "2013\/02\/03 20:00:00": 3749,
                "2013\/02\/03 16:00:00": 3148,
                "2013\/02\/03 00:00:00": 2954,
                "2013\/02\/03 07:00:00": 2042,
                "2013\/02\/03 23:00:00": 4473,
                "2013\/02\/03 14:00:00": 2691,
                "2013\/02\/03 19:00:00": 3566,
                "2013\/02\/03 05:00:00": 3139,
                "2013\/02\/03 13:00:00": 2244,
                "2013\/02\/03 15:00:00": 2817,
                "2013\/02\/03 08:00:00": 1572,
                "2013\/02\/03 11:00:00": 1521,
                "2013\/02\/03 10:00:00": 1444,
                "2013\/02\/03 12:00:00": 1901,
                "2013\/02\/03 02:00:00": 3273,
                "2013\/02\/03 09:00:00": 1654,
                "2013\/02\/03 22:00:00": 3647,
                "2013\/02\/03 03:00:00": 3259,
                "2013\/02\/03 18:00:00": 4071,
                "2013\/02\/03 06:00:00": 2532,
                "2013\/02\/03 17:00:00": 3394
            },
            "interval": "hour"
        }
    ]
}