Installing the ready4 framework foundation library
The ready4 framework foundation is the first ready4 library you should install.
The ready4 framework foundation is the first ready4 library you should install.
Instructions for installing the ready4class, ready4fun and ready4pack libraries.
Instructions for installing the ready4use library.
How to find individual ready4 modules and sub-modules.
Depending on how you plan to use ready4, you may need to install some or all of its authoring tools.
ready4 modules can be be used to model the people, places, platforms and programs that shape young people’s mental health.
Our current list of priorities for the development of ready4 shape when and how we need your help.
Instructions for installing the ready4show library.
We created a basic synthetic dataset of to represent a clinical youth mental health sample.
To implement a modelling analysis with ready4 you need to install computational model modules.
Programs are used to generate and report a model analysis.
Unreleased software and other preliminary work is currently being developed into modules for modelling people, places, platforms and programs.
There are a number of ways you can contribute to ready4.
Subroutines perform part of an analysis and reporting algorithm.
Tools from the ready4class, ready4 fun and ready4pack R packages streamline and standardise the authoring of ready4 modules.
How ready4 aims to improve policy and system planning in youth mental health.
See how ready4 has been applied to real world decision problems.
What you need to know to start using ready4.
To be accountable, flexible and up to date, ready4 is being implemented as a modular and open source computational model.
A number of concepts are helpful to understand prior to using ready4.
ready4 represents youth mental health systems in computer code.
ready4 is comprised of self-contained, reusable components called “modules”.
Coders can use ready4 to enhance the impact and re-usability of their algorithms.
Modellers can use ready4 to leverage the work of other modellers and to implement reproducible modelling analyses.
A ready4 modelling project develops a computational model, adds data and runs analyses.
Planners can use ready4 decision aids to generate useful insights.
Some core concepts relating to reproducible research have multiple conflicting definitions - this is how we use them.
How you use and contribute to ready4 will depend on the type of work you do.
ready4 provides funders with opportunities to improve the quality, breadth and accountability of supports provided to youth mental health policymakers and system planners.
Researchers can use ready4 to enhance the reproducibility, replicability and transferability of their work.
In addition to the main types of intended user, a number of other stakeholders can benefit from and contribute to ready4.
Some models have the potential to be used in multiple contexts - but will often need adaptation for this to be appropriate.
Young people can help ensure that ready4 remains accountable for addressing topics of importance to them.
ready4 is a suite of software, with each included item performing a distinctive role.
The ready4 framework comprises a set of standards and the software to implement it.
The ready4 framework identifies a set of standards to which the ready4 model, its datasets and analyses are expected to adhere.
The software to help ensure that the ready4 model adheres to consistent standards is distributed as a collection of framework code libraries.
ready4 software is implemented using a combination of object-oriented and functional programming paradigms.
ready4 uses an object oriented programming (OOP) paradigm to implement computational models.
The ready4class R package supports partially automated and standardised workflows for defining the data structures to be used in computational models.
ready4 uses functional programming to maximise the re-usability of model algorithms.
ready4 supports a modular approach to computational model development.
ready4 modules use a simple and consistent syntax.
The ready4fun R package supports standardised approaches to code authoring that facilitate partial automation of the documenting of model algorithms.
ready4 supports tools to streamline the testing, description and distribution of computational model modules.
The ready4 computational model is the complete collection of all modules developed with the ready4 framework. These modules can be re-used and combined to create other computational models.
Tools from the ready4 and ready4use libraries can be used to search for relevant open access data collections and ingest data from these collections.
Replication programs for designing, analysing and reporting discrete choice experiments.
To the greatest extent feasible, the data supplied to ready4 modules is accessed and shared via open access data repositories.
Replication programs for constructing synthetic populations.
Replication programs for developing, finding and applying utility mapping algorithms.
Programs, sub-routines and user-interfaces combine ready4 modules and datasets to implement reproducible analyses of youth mental health policy and system design topics.
Decision aids provide user interfaces that make it easy to generate practical insight from ready4.
The code used when applying ready4 to a number of real world youth mental health policy and research projects is publicly available.
Sub-routine programs can be used to automatically generate standardised reports of analyses undertaken with ready4.
The ready4use R package provides tools for supplying data to youth mental health computational models.
Online open access data repositories are the preferred storage locations for ready4 model datasets.
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.
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.
Tools from the ready4show R package support authoring of scientific summaries of analyses with ready4.
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.
A tutorial from the Acumen website about using ready4 to search and retrieve data from the Australian Mental Health Systems Models Dataverse.
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.
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.
Tools from the ready4show R package support authoring of programs and subroutines to implement and report analyses with ready4.
Modules for spatio-temporal modelling of the environments that shape young people’s mental health are collectively referred to as the “Springtides” model. No places modules are yet available - just an app built using unreleased work in progress modules.
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.
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.
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. No programs modules are yet available - see details on preliminary work in progress.
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.
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.
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.
We used functions (soon to be formalised into ready4 modules) from the mychoice R package to design to a discrete choice experiment.
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.
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.
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.
We previously developed a user interface for the epidemiology modules of our Springtides model of places.
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.
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.
ready4 needs the guidance of young people, decision-makers and technical experts to shape its development.
Help improve the reliability, functionality and ease of use of ready4 software.
How to contribute to ready4’s development.
Help us secure our future and accelerate our development.
Plan, conduct and disseminate ready4 modelling projects.
Help develop high quality, clear and comprehensive documentation, instruction and responsive help.
What you need in order to be able to use ready4 software on your machine.
ready4 software is freely available from multiple open access repositories.
Whether and how you should use a specific version of ready4 software depends in part on its release status.
Code libraries are used to distribute software for applying our framework and implementing computational model modules.
To foster an inclusive and respectful community, all contributors to ready4 are expected to adhere to the Contributor Covenant.
ready4 libraries include tools for applying a modelling framework and for implementing computational models.
Executables (programs and sub-routines) are used to apply computational models to data and to report the resulting analyses.
User interfaces make it easier for non-technical users to explore and use ready4 models.
Each ready4 code library is supported by a standardised set of documentation resources.
ready4 is distributed without warranties under open source licenses - we just ask you to appropriately cite it.
Search for ready4 library and function dependencies using our interactive app.
ready4 is freely available to all under copy-left licensing arrangements.
If you find ready4 useful, please cite it appropriately - it is easy to do!
ready4 is distributed without any warranties.
Important information to review before installing and using our software
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.
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.
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.
We want to develop a community of ready4 users, contributors and stakeholders to sustain the development, maintenance, application, extension and impact of the project.
We want progressively extend the capability of the ready4 model to explore new decision topics in youth mental health.
We want coders and modellers working in languages such as python to be able to readily use and contribute to ready4.
Current unreleased work to develop modules for modelling the characteristics, relationships, behaviours, risk factors and outcomes of young people and those important to them.
Current unreleased work to develop modules for modelling the demographic, environmental and proximity drivers of access, equity and outcomes in youth mental health.
Current unreleased work to develop modules for modelling the optimal staffing and configuration of support services for young people.
Current very preliminary work to develop modules for modelling the affordability, value for money and appropriate targeting of interventions for young people.
A subroutine for generating catalogues of utility mapping models created with the TTU library.
A template subroutine for generating a scientific manuscript for use with the ready4show library.
A subroutine for generating a scientific manuscript of a longitudinal utility mapping study undertaken with the TTU library.
A subroutine for a summary of the main results from a Discrete Choice Experiment implemented with the mychoice library.
Some work in progress code has yet to be publicly released or fornmally acknowledged as part of the ready4 suite.
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.
Production releases are the versions of software intended for end-users.
Archived releases are permanent, uniquely identified records of key project milestones.
There are two types of framework libraries - a foundational library and libraries of authoring tools.
There are three types of model module libraries - those for describing input data, developing models and making predictions.