Installing the ready4 framework foundation library
The ready4 framework foundation is the first ready4 library you should install.
Category: Documentation
Installing tools for authoring computational models
Instructions for installing the ready4class, ready4fun and ready4pack libraries.
Categories:
Template module
ready4 provides a template to facilitate modular implementation of health economic models.
Categories:
Code repositories
ready4 software is freely available from multiple open access repositories.
Categories:
Motivation
There are a number of limitations to current health economic modelling practice, with models rarely adequately transparent, reusable and updatable.
Categories:
Installing tools for authoring and managing model datasets
Instructions for installing the ready4use library.
Categories:
Provide end users with a simple and consistent syntax for using model modules
Methods are associated with ready4 modules using a novel syntax.
Categories:
Finding modules and sub-modules
How to find individual ready4 modules and sub-modules.
Categories:
Installing authoring tools
Depending on how you plan to use ready4, you may need to install some or all of its authoring tools.
Categories:
Using ready4 modules
ready4 modules can be be used to model the people, places, platforms and programs that shape young people’s mental health.
Categories:
Our priorities
Our current list of priorities for the development of ready4 shape when and how we need your help.
Categories:
Installing tools for authoring reproducible analyses
Instructions for installing the ready4show library.
Categories:
Installing ready4 computational model modules
To implement a modelling analysis with ready4 you need to install computational model modules.
Categories:
Create a synthetic population of young people attending primary mental health services
We created a basic synthetic dataset of to represent a clinical youth mental health sample.
Categories:
Author and share model modules
Tools from the ready4class, ready4 fun and ready4pack R libraries streamline and standardise the authoring of ready4 modules.
Categories:
Modules pipeline
Unreleased software and other preliminary work is currently being developed into modules for modelling people, places, platforms and programs.
Categories:
Contribution types
There are a number of ways you can contribute to ready4.
Categories:
Partially automate maintenance of a modelling project's website
ready4 includes tools that can help maintain the documentation website for a modelling project.
Categories:
Overview
How ready4 aims to improve the development and application of health economic models.
Categories:
Examples
See how ready4 has been applied to model real world decision problems.
Categories:
Before you get started
What you need to know to start using ready4.
Categories:
Concepts
A number of concepts are helpful to understand prior to reading ready4 documentation.
Categories:
Model
A health economic model is a conceptual, mathematical and computational representation of systems relating to human health that can be used to help solve economic problems.
Categories:
Module
Some computational models are implemented by combining self-contained, reusable components called “modules”.
Categories:
Coders
Coders can use ready4 to enhance the impact and re-usability of their algorithms.
Categories:
Modellers
Modellers can use ready4 to leverage the work of other modellers and to implement reproducible modelling analyses.
Categories:
Modelling project
A ready4 modelling project develops a computational model, adds data and runs analyses.
Categories:
Planners
Planners can use ready4 decision aids to generate useful insights.
Categories:
Repeatable research
Some core concepts relating to repeatable research have multiple conflicting definitions - this is how we use them.
Categories:
Users
How you use and contribute to ready4 will depend on the type of work you do.
Categories:
Community members
Community members can help ensure that ready4 remains accountable for addressing topics of importance to them.
Categories:
Funders
ready4 provides funders with opportunities to improve the quality, breadth and accountability of supports provided to health policymakers and system planners.
Categories:
Researchers
Researchers can use ready4 to enhance the reproducibility, replicability and transferability of their work.
Categories:
Stakeholders
In addition to the main types of intended user, a number of other stakeholders can benefit from and contribute to ready4.
Categories:
Transferability
Some models have the potential to be used in multiple contexts - but will often need adaptation for this to be appropriate.
Categories:
Downloads
ready4 is a suite of software libraries, freely available for download and installation.
Categories:
Purpose
The ready4 prototype software framework supports model implementations that meet explicit transparency, reusability and updatability criteria.
Categories:
Develop, adapt and maintain computational health economic models
ready4 software framework libraries provide tools for authoring, documenting and maintaining living and transferable health economic models analyses.
Categories:
Use modules of health economic models to implement repeatable research
ready4 software framework libraries provide tools for finding reusable modules of health economic models, supplying them with compatible data and authoring reproducible analysis scripts.
Categories:
Implementation
The ready4 prototype software framework is distributed as a collection of framework code libraries that support object-oriented and functional approaches to implementing modular and open source computational models.
Categories:
Paradigms
ready4 software is implemented using a combination of object-oriented and functional programming paradigms.
Categories:
Tutorials
ready4 software framework libraries provide tools for authoring and sharing model modules, datasets and analyses.
Categories:
Why ready4 is object oriented
ready4 uses an object oriented programming (OOP) paradigm to implement computational models.
Categories:
Authoring model data structures
The ready4class R package supports partially automated and standardised workflows for defining the data structures to be used in computational models.
Categories:
The role of functional programming in ready4 development
ready4 uses functional programming to maximise the re-usability of model algorithms.
Categories:
Authoring model algorithms
The ready4fun R package supports standardised approaches to code authoring that facilitate partial automation of the documenting of model algorithms.
Categories:
Dissemating citable, documented and quality assured model module libraries
ready4 supports tools to streamline the testing, description and distribution of computational model modules.
Categories:
Model
The ready4 software framework is currently being used to develop a modular economic model of youth mental health.
Categories:
Model modules
A ready4 computational model is implemented as a set of modules, all of which are authored with the ready4 software framework. These modules can be re-used and combined to create other computational models.
Categories:
Finding and using open access data
Tools from the ready4 and ready4use libraries can be used to search for relevant open access data collections and ingest data from these collections.
Categories:
Model youth choices
Replication programs for designing, analysing and reporting discrete choice experiments.
Categories:
Data
To the greatest extent feasible, the data supplied to ready4 modules is accessed and shared via open access data repositories.
Categories:
Create synthetic populations
Replication programs for constructing synthetic populations.
Categories:
Model health utility
Replication programs for developing, finding and applying utility mapping algorithms.
Categories:
Analyses
Programs, sub-routines and user-interfaces combine ready4 modules and datasets to implement reproducible analyses of youth mental health policy and system design topics.
Categories:
Decision aids
Decision aids provide user interfaces that make it easy to generate practical insight from ready4.
Categories:
Code to reproduce and/or replicate scientific studies
The code used when applying ready4 to a number of real world youth mental health policy and research projects is publicly available.
Categories:
Subroutine templates for authoring analysis reports
Sub-routine programs can be used to automatically generate standardised reports of analyses undertaken with ready4.
Categories:
Find themed collections of ready4 modules
Tools from the ready4 R library can help find details about module libraries from a modelling project.
Categories:
Commands for using model modules
Apply model modules using a simple and consistent syntax.
Categories:
Ingest data from an open access repository
A tutorial from the Acumen website about using ready4 to search and retrieve data from the Australian Mental Health Systems Models Dataverse.
Categories:
Search open access data collections
Online open access data repositories are the preferred storage locations for ready4 model datasets.
Categories:
Standardise Variable Values With Fuzzy Logic And Correspondence Tables
Costing health economic datasets is an activity that can involve repeated use of lookup tables. This tutorial describes how a module from the costly R package can help you to use a combination of fuzzy logic and correspondence tables to standardise variable values and thus facilitate partial automation of costing algorithms.
Categories:
Finding modules of health economic models
The ready4 library provides tools to help retrieve details of model module collections and documentation on individual model modules.
Categories:
Modules for modelling people
Modules to model the characteristics, relationships, behaviours, risk factors and outcomes of young people and individuals who interact with young people are collectively referred to as the “Spring To Life” model. The currently available modules listed here will be supplemented by additional unreleased work in progress.
Categories:
Find examples of how model modules are used
Tools from the ready4 R library can help find details about the use of individual model modules.
Categories:
Authoring scientific manuscripts
Tools from the ready4show R package support authoring of scientific summaries of analyses with ready4.
Categories:
Add a data dictionary to a dataset
Pairing a dataset with its dictionary makes it easier to interpret. This tutorial describes how a module from the ready4use R package can help you to pair a dataset and its dictionary.
Categories:
Standardise Variable Values With Lookup Codes
This tutorial describes how a module from the costly R package can help you to use lookup codes to standardise variable values and thus facilitate partial automation of costing algorithms.
Categories:
Add metadata to datasets of individual human records
Appending appropriate metadata to datasets of individual unit records can facilitate partial automation of some modelling tasks. This tutorial describes how a module from the youthvars R package can help you to add metadata to a youth mental health dataset so that it can be more readily used by other ready4 modules.
Categories:
Validate variable total scores
Vector based classes can be used to help validate variable values. This tutorial describes how to do that with sub-module classes exported as part of the youthvars R package.
Categories:
Ingest, label and share model data
The ready4use R package provides tools for supplying data to model modules.
Categories:
Modules for modelling places
Modules for spatio-temporal modelling of the environments that shape young people’s mental health are collectively referred to as the “Springtides” model. Two module libraries are currently available - vicinity and aus, though both are highly preliminary and without any vignette articles to demonstrate their use. An app built using a combination of these libraries and unreleased work in progress module libraries is available for illustration purposes.
Categories:
Using model modules for repeatable analyses
The ready4 framework provides tools to support the authoring of programs and subroutines to run and report analyses with ready4.
Categories:
Share data via online repositories
The retrieval and dissemination of data from online data repositories is an essential enabler of open source modelling. This tutorial describes how a module from the ready4use R package can help you to manage this process.
Categories:
Score health utility
Using modules from the scorz R package, individual responses to a multi-attribute utility instrument survey can be converted into health utility total scores. This tutorial describes how to do for adolescent AQoL-6D health utility.
Categories:
Modules for modelling platforms
Modules that model the processes, eligibility requirements, staffing and configurations of youth service platforms are collectively referred to as the “First Bounce” model. No platforms modules are yet available - see details on unreleased work in progress.
Categories:
Modules for modelling programs
Modules for modelling the efficacy, cost-effectiveness and budget impact of youth mental health programs (e.g. interventions for prevention, treatment and wellbeing) are collectively referred to as the “On Target” model. Some initial modules from the costly library are available. There is also even more preliminary work in progress.
Categories:
Explore candidate utility mapping models
Using modules from the specific R package, it is possible to undertake an exploratory utility mapping analysis. This tutorial illustrates a hypotehtical example of exploring how to map to EQ-5D health utility.
Categories:
Implement a utility mapping study
Using modules from the TTU R package, it is possible to implement a fully reproducible utility mapping study. This tutorial illustrates the main steps using a hypothetical AQoL-6D utility mapping study.
Categories:
Find and deploy utility mapping models
Using tools (soon to be formalised into ready4 modules) from the youthu R package, it is possible to find and deploy relevant utility mapping algorithms. This tutorial illustrates the main steps for predicting AQoL-6D utility from psychological and functional measures collected on clinical samples of young people.
Categories:
Design a Discrete Choice Experiment
We used functions (soon to be formalised into ready4 modules) from the mychoice R package to design to a discrete choice experiment.
Categories:
Use utility mapping algorithms to help implement cost-utility analyses
Using tools (soon to be formalised into ready4 framework modules) from the youthu R package, it is possible to use utility mapping algorithms to help implement cost-utility analyses. This tutorial illustrates the main steps for doing so using psychological and functional measures collected on clinical samples of young people.
Categories:
Develop choice models
Using tools (soon to be formalised into ready4 framework modules) from the mychoice R package, it is possible to develop choice models from responses to a discrete choice experiment survey.
Categories:
Analyse the results of a Discrete Choice Experiment
Using functions (soon to be formalised into ready4 framework modules) from the mychoice R package, it is possible to develop choice models from responses to a discrete choice experiment survey.
Categories:
Predicting the spatial epidemiology of emerging mental disorders
We previously developed a user interface for the epidemiology modules of our Springtides model of places.
Categories:
Develop health utility mapping algorithms
Using modules from the TTU, youthvars, scorz and specific libraries, we developed utility mapping algorithms from a sample of young people attending primary mental health care services.
Categories:
Predict health utility
Using functions (soon to be formalised into ready4 framework modules) from the youthu R package, we predicted health utility for a synthetic population of young people attending primary mental health care services.
Categories:
Provide advice
ready4 needs the guidance of community members, decision-makers and technical experts to shape its development.
Categories:
Contribute code
Help improve the reliability, functionality and ease of use of ready4 software.
Categories:
Contributions
How to contribute to ready4’s development.
Categories:
Fund projects
Help us secure our future and accelerate our development.
Categories:
Undertake projects
Plan, conduct and disseminate ready4 modelling projects.
Categories:
Support the ready4 community
Help develop high quality, clear and comprehensive documentation, instruction and responsive help.
Categories:
System requirements
What you need in order to be able to use ready4 software on your machine.
Categories:
Framework library descriptions
There are two types of framework libraries - a foundational library and libraries of authoring tools.
Categories:
Release statuses
Whether and how you should use a specific version of ready4 software depends in part on its release status.
Categories:
Code libraries
The ready4 framework is distributed as six R libraries.
Categories:
Contributor covenant (code of conduct)
To foster an inclusive and respectful community, all contributors to ready4 are expected to adhere to the Contributor Covenant.
Categories:
Library documentation
Each ready4 code library is supported by a standardised set of documentation resources.
Categories:
Terms of use
ready4 is distributed without warranties under open source licenses - we just ask you to appropriately cite it.
Categories:
Dependencies
Search for ready4 library and function dependencies using our interactive app.
Categories:
Open source licensing
ready4 is freely available to all under copy-left licensing arrangements.
Categories:
Citing ready4
If you find ready4 useful, please cite it appropriately - it is easy to do!
Categories:
Disclaimer
ready4 is distributed without any warranties.
Categories:
Installation and set-up
Important information to review before installing and using our software
Categories:
Priority 1: Launch ready4 Minimum Viable Product (MVP)
We want to give potential users confidence that they can appropriately apply ready4 to their decision problems by bringing all our existing development release and unreleased software to production release status.
Categories:
Priority 2: Maintain ready4
We want the ready4 framework, model, datasets and decision aids to continually improve and update in response to the needs of potential users and stakeholders.
Categories:
Priority 3: Apply ready4 to undertake replications and transfers
We want maintained production releases of ready4 module libraries to be used to implement replications and transfers of the original studies for which that software was developed.
Categories:
Priority 4: Grow a ready4 community
We want to develop a community of ready4 users, contributors and stakeholders to sustain the development, maintenance, application, extension and impact of the project.
Categories:
Priority 5: Extend the scope of the ready4 model
We want progressively extend the capability of the ready4 model to explore new decision topics in youth mental health.
Categories:
Priority 6: Integrate ready4 with other open source tools
We want coders and modellers working in languages such as python to be able to readily use and contribute to ready4.
Categories:
Pipeline of people modules
Current unreleased work to develop modules for modelling the characteristics, relationships, behaviours, risk factors and outcomes of young people and those important to them.
Categories:
Pipeline of places modules
Current unreleased work to develop modules for modelling the demographic, environmental and proximity drivers of access, equity and outcomes in youth mental health.
Categories:
Pipeline of platforms modules
Current unreleased work to develop modules for modelling the optimal staffing and configuration of support services for young people.
Categories:
Pipeline of programs modules
Current very preliminary work to develop modules for modelling the affordability, value for money and appropriate targeting of interventions for young people.
Categories:
Make a catalogue of utility mapping models
A subroutine for generating catalogues of utility mapping models created with the TTU library.
Categories:
Author a template scientific manuscript
A template subroutine for generating a scientific manuscript for use with the ready4show library.
Categories:
Author a draft scientific manuscript for a utility mapping study
A subroutine for generating a scientific manuscript of a longitudinal utility mapping study undertaken with the TTU library.
Categories:
Make results summary for a Discrete Choice Experiment
A subroutine for a summary of the main results from a Discrete Choice Experiment implemented with the mychoice library.
Categories:
Unreleased code
Some work in progress code has yet to be publicly released or fornmally acknowledged as part of the ready4 suite.
Categories:
Development releases
Development releases provide the most comprehensive and up to date public record of a ready4 project’s source code but may be poorly documented and tested.
Categories:
Production releases
Production releases are the versions of software intended for end-users.
Categories:
Archived releases
Archived releases are permanent, uniquely identified records of key project milestones.