[
    "       Welcome to Aflux - The Aflow search API (version 1.0)                   ",
    "            Aflux home:   https://aflow.org/API/aflux/?                        ",
    "                                                                               ",
    "Aflux is in its first stable release cycle (read, we think it works now).      ",
    "                                                                               ",
    "                                                                               ",
    "The purpose of Aflux is to expose our collection of materials data via         ",
    "arbitrary set based restrictions on any of the properties of interest. By      ",
    "default, matched results are returned as JSON serialized data. An Aflux        ",
    "summons is written entirely in the query portion of the Aflux home URL:        ",
    "        http://aflow.org/API/aflux/?<summons>                                  ",
    "                                                                               ",
    "Examples of Aflux summons follow...                                            ",
    "                                                                               ",
    "A summons for this Aflux help document:                                        ",
    "    The empty summons                                                          ",
    "        http://aflow.org/API/aflux/?                                           ",
    "    or                                                                         ",
    "        http://aflow.org/API/aflux/?help                                       ",
    "    hereafter represented as                                                   ",
    "        <summons> = help                                                       ",
    "                                                                               ",
    "The summons of help has several variations:                                    ",
    "    Help on help, special help options beyond this page                        ",
    "        <summons> = help(help)                                                 ",
    "                                                                               ",
    "    Release notes about version 1.0                                            ",
    "        <summons> = help(v1.0)                                                 ",
    "                                                                               ",
    "Available properties and Property information:                                 ",
    "    Information summary on all searchable properties                           ",
    "        <summons> = help(properties)                                           ",
    "    or                                                                         ",
    "        <summons> = schema                                                     ",
    "                                                                               ",
    "    Information summary on a specific property, e.g. the Egap property         ",
    "        <summons> = help(Egap)                                                 ",
    "                                                                               ",
    "Presence of data and matching on a numerical range:                            ",
    "    Return only entries with values (ie. non-null)                             ",
    "        <summons> = Egap(*)                                                    ",
    "                                                                               ",
    "    Numerical restriction on available values                                  ",
    "        <summons> = Egap(1*,*1.01)                                             ",
    "    Will return the first 64 results from all data with an Egap value          ",
    "    greater than or equal to 1eV AND less than or equal to 1.01eV              ",
    "                                                                               ",
    "    Binary operator comma ',' is an AND operator.                              ",
    "    For a number N;                                                            ",
    "        N* is the greater than or equal to N operation                         ",
    "        *N is the less than or equal to N operation                            ",
    "                                                                               ",
    "Multiple ranges may be selected:                                               ",
    "    By use of nested operations                                                ",
    "        <summons> = Egap((1*,*1.01):(2*,*2.01)),paging(2)                      ",
    "    paging(2) shows the 2nd set of 64 results                                  ",
    "                                                                               ",
    "    Binary operator colon ':' is an OR operator.                               ",
    "    The directive paging(J,K) returns the Jth set of K (64 by default) results ",
    "                                                                               ",
    "Use of the suppression '$' operator:                                           ",
    "    If you don't want to see the index                                         ",
    "        <summons> = Egap(1*,*1.01),$paging(0)                                  ",
    "    Summoning the zeroth page returns all possible results.                    ",
    "                                                                               ",
    "    NB: Be careful here, large data responses can crash your browser, we       ",
    "    suggest wget, curl or some other direct method for full retrieval.         ",
    "                                                                               ",
    "Multiple properties are also possible:                                         ",
    "    Requesting Pearson symbol of the relaxed structure                         ",
    "        <summons> = Egap(1*,*1.01),Pearson_symbol_relax,paging(-0)             ",
    "    shown in reverse order of the first property summoned                      ",
    "                                                                               ",
    "String matching works similarly:                                               ",
    "    Show results with a string at the beginning, anywhere or end of the string ",
    "        <summons> = Egap(1*,*1.01),Pearson_symbol_relax('c'*)                  ",
    "        <summons> = Egap(1*,*1.01),Pearson_symbol_relax(*'F'*)                 ",
    "        <summons> = Egap(1*,*1.01),Pearson_symbol_relax(*'28')                  ",
    "    Don't worry if your browser percent encodes some characters,               ",
    "    the API will still understand                                              ",
    "                                                                               ",
    "    Suppressing one of the default property identifiers.                       ",
    "        <summons> = Egap(1*,*1.01),Pearson_symbol_relax(*%27F%27*),$compound   ",
    "                                                                               ",
    "We also have '!', the inversion operator:                                      ",
    "    Show string data that do not have an F anywhere in them                    ",
    "        <summons> = Egap(1*,*1.01),Pearson_symbol_relax(!*'F'*),paging(0)      ",
    "    it also works on numerical restriction                                     ",
    "        <summons> = Egap(!*1)                                                  ",
    "    for results that are (non-inclusive) greater than 1eV                      ",
    "                                                                               ",
    "                                                                               ",
    "                                                                               ",
    "Aflux Reference: https://doi.org/10.1016/j.commatsci.2017.04.036               ",
    "Aflow REST API: https://doi.org/10.1016/j.commatsci.2014.05.014                ",
    "                                                                               ",
    "LICENSE.  The data included within the aflow.org repository is free for        ",
    "scientific, academic and non-commercial purposes.  Any other use is            ",
    "prohibited.                                                                    "
]