arcade-xml-generator


Namearcade-xml-generator JSON
Version 0.0.1 PyPI version JSON
download
home_page
SummaryGUI to load parameters into agent-based modeling with ARCADE
upload_time2023-12-15 04:12:34
maintainer
docs_urlNone
authorolafc
requires_python
license
keywords agent-based modeling xml editor gui
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            
# ARCADE XML Generator



## Pip install instructions

```

pip install 

```

## Running instructions

To run the arcade_xml_generator run ```gui.py``` in your preferred python interpreter. From there, simply select the values you wish to simulate and then hit run-- it's that simple. 

When the module is fully released, interactions with this gui will create a setup .xml file for use with ARCADE.



## Background on ARCADE

ARCADE is an agent-based modelling system, created by the Bagheri lab, that is provides information on emergent properties of groups of cells. ARCADE runs in java but requires .xml files to provide the rules to its agents. The parameter options are stored in separate .xml files and interfacing between the two can be challenging. 

### Versions

Arcade is a flexible software that allows for different setups depending on the module. This allows for simulations of different tissues such as wound healing or tumor growth. Two notable ARCADE modules are Patch and Potts. Currently the xml_generator is only set up for patch but planned development includes a potts module. 

### Structure of Set Up .xml File

The set up .xml file that is produced by the ARCADE XML Generator will have the following primary branches:

* Series and Set -- These parameters general instructions for the simulation such as how long the simulation is, the tick rate, and how many simulations should be run. 

* Populations -- These parameters determine the rules for the agents such as tumor cells or healthy tissue cells.

* Actions -- These parameters determine disturbances to the population such as mutations or injury.

* Layers -- These parameters determine the environment such as oxygen or TGFA.

* Components -- These parameters determine the spatial organization of the layers. 

  An example of this file can be seen in docs/example_output/setup_hex.xml

These files are produced by parsing multiple .xml files and combining them with user input. A patch setup file, for instance, reads in both a parameter.xml file and parameter.patch.xml file.





## Dependencies

The primary dependencies of this software are PyQt, ElementTree, sys, os, dataclasses, typing, and copy.



## To be Developed

### Coming in this Version

* Ability to save GUI inputs

* Compiling functionality

* Patch functionality



### Future Versions

* Linter

* Run Commands in Bash

* Run directly into ARCADE button

* Potts functionality


            

Raw data

            {
    "_id": null,
    "home_page": "",
    "name": "arcade-xml-generator",
    "maintainer": "",
    "docs_url": null,
    "requires_python": "",
    "maintainer_email": "",
    "keywords": "agent-based,modeling,xml,editor,gui",
    "author": "olafc",
    "author_email": "olafc@uw.edu",
    "download_url": "https://files.pythonhosted.org/packages/9b/0c/21bd09cf300b21f4a93ab49e4b417542e6c8f60ac2133858e8277734b70d/arcade_xml_generator-0.0.1.tar.gz",
    "platform": null,
    "description": "\r\n# ARCADE XML Generator\r\n\r\n\r\n\r\n## Pip install instructions\r\n\r\n```\r\n\r\npip install \r\n\r\n```\r\n\r\n## Running instructions\r\n\r\nTo run the arcade_xml_generator run ```gui.py``` in your preferred python interpreter. From there, simply select the values you wish to simulate and then hit run-- it's that simple. \r\n\r\nWhen the module is fully released, interactions with this gui will create a setup .xml file for use with ARCADE.\r\n\r\n\r\n\r\n## Background on ARCADE\r\n\r\nARCADE is an agent-based modelling system, created by the Bagheri lab, that is provides information on emergent properties of groups of cells. ARCADE runs in java but requires .xml files to provide the rules to its agents. The parameter options are stored in separate .xml files and interfacing between the two can be challenging. \r\n\r\n### Versions\r\n\r\nArcade is a flexible software that allows for different setups depending on the module. This allows for simulations of different tissues such as wound healing or tumor growth. Two notable ARCADE modules are Patch and Potts. Currently the xml_generator is only set up for patch but planned development includes a potts module. \r\n\r\n### Structure of Set Up .xml File\r\n\r\nThe set up .xml file that is produced by the ARCADE XML Generator will have the following primary branches:\r\n\r\n* Series and Set -- These parameters general instructions for the simulation such as how long the simulation is, the tick rate, and how many simulations should be run. \r\n\r\n* Populations -- These parameters determine the rules for the agents such as tumor cells or healthy tissue cells.\r\n\r\n* Actions -- These parameters determine disturbances to the population such as mutations or injury.\r\n\r\n* Layers -- These parameters determine the environment such as oxygen or TGFA.\r\n\r\n* Components -- These parameters determine the spatial organization of the layers. \r\n\r\n  An example of this file can be seen in docs/example_output/setup_hex.xml\r\n\r\nThese files are produced by parsing multiple .xml files and combining them with user input. A patch setup file, for instance, reads in both a parameter.xml file and parameter.patch.xml file.\r\n\r\n\r\n\r\n\r\n\r\n## Dependencies\r\n\r\nThe primary dependencies of this software are PyQt, ElementTree, sys, os, dataclasses, typing, and copy.\r\n\r\n\r\n\r\n## To be Developed\r\n\r\n### Coming in this Version\r\n\r\n* Ability to save GUI inputs\r\n\r\n* Compiling functionality\r\n\r\n* Patch functionality\r\n\r\n\r\n\r\n### Future Versions\r\n\r\n* Linter\r\n\r\n* Run Commands in Bash\r\n\r\n* Run directly into ARCADE button\r\n\r\n* Potts functionality\r\n\r\n",
    "bugtrack_url": null,
    "license": "",
    "summary": "GUI to load parameters into agent-based modeling with ARCADE",
    "version": "0.0.1",
    "project_urls": null,
    "split_keywords": [
        "agent-based",
        "modeling",
        "xml",
        "editor",
        "gui"
    ],
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "6180f722065f0f4a71bc036f6a1a7e7a1ab4e9dac6d020618813df0f19b15b61",
                "md5": "87fb5fcc2b183e18a5b464716a502f47",
                "sha256": "1cad91a054be065a4f3dccf0bc0a74b9f29e25832acb2d6e2143969e4dd89bac"
            },
            "downloads": -1,
            "filename": "arcade_xml_generator-0.0.1-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "87fb5fcc2b183e18a5b464716a502f47",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": null,
            "size": 13978,
            "upload_time": "2023-12-15T04:12:32",
            "upload_time_iso_8601": "2023-12-15T04:12:32.461404Z",
            "url": "https://files.pythonhosted.org/packages/61/80/f722065f0f4a71bc036f6a1a7e7a1ab4e9dac6d020618813df0f19b15b61/arcade_xml_generator-0.0.1-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "9b0c21bd09cf300b21f4a93ab49e4b417542e6c8f60ac2133858e8277734b70d",
                "md5": "2a44c362c6db40b68fa0dc753aa3e86c",
                "sha256": "1d1701485dc3eb51830c0c40401877fb484f7dcc87dc8eb4831050ddd7c0621c"
            },
            "downloads": -1,
            "filename": "arcade_xml_generator-0.0.1.tar.gz",
            "has_sig": false,
            "md5_digest": "2a44c362c6db40b68fa0dc753aa3e86c",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": null,
            "size": 11132,
            "upload_time": "2023-12-15T04:12:34",
            "upload_time_iso_8601": "2023-12-15T04:12:34.325271Z",
            "url": "https://files.pythonhosted.org/packages/9b/0c/21bd09cf300b21f4a93ab49e4b417542e6c8f60ac2133858e8277734b70d/arcade_xml_generator-0.0.1.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2023-12-15 04:12:34",
    "github": false,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "lcname": "arcade-xml-generator"
}
        
Elapsed time: 2.73989s